# MaxMindDB (oci · ghcr.io/oschwald/maxminddb-mcp)

Query IP locations and network ownership in GeoIP2, GeoLite2, and custom MMDB databases.

- Trust score: 6/100 (low)
- Change this week: 0
- Registry status: deprecated
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

> **Deprecated**: this server is marked deprecated in the MCP registry. The registry records this reason: "Renamed to io.github.oschwald/maxminddb. Install version 0.3.0 or later from the new registry entry. The executable and config paths remain maxminddb-mcp."

## Components

- oci · `ghcr.io/oschwald/maxminddb-mcp`: 6/100 (this document), [markdown](https://verifymcp.io/servers/oschwald-maxminddb-mcp/ghcr-io-oschwald-maxminddb-mcp.md), [page](https://verifymcp.io/servers/oschwald-maxminddb-mcp/ghcr-io-oschwald-maxminddb-mcp)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/oschwald/maxminddb-mcp`
- Version: `0.2.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 0/100
  - No malware scan is available for this kind of package: the supply-chain vendors we use do not cover it. This is a permanent gap in our coverage, not a finding about the package.
  - Known CVEs could not be checked: this image's dependency list comes from an SBOM its publisher attached, which nothing verifies, so we will not report it as a clean result.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this image's dependency list comes from an SBOM its publisher attached. It names packages and versions but not whether each is deprecated, still maintained or linked to its source, so there is nothing we can fairly grade.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 18 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 0/100
  - Schema quality not yet verified: our sandbox could not run this package, so we have no schema to assess.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: our sandbox could not run this package, so we have no schema to compare.
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: our sandbox could not run this package, so we have no tool definitions to assess.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: our sandbox could not run this package, so we have no tool text to scan.
- **Capabilities**: 0/100
  - Protocol version not yet verified: our sandbox could not run this package, so we never saw its MCP handshake.

**Unverified: 6 categories.** Categories scored 0 because we could not verify them: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the MaxMindDB MCP server?

MaxMindDB runs locally as a container image, launched with docker run --rm -i -e MAXMINDDB_MCP_DOWNLOAD_ENABLED -e MAXMINDDB_MCP_DATABASE_DIR -e MAXMINDDB_MCP_ACCOUNT_ID -e MAXMINDDB_MCP_LICENSE_KEY -e MAXMINDDB_MCP_EDITIONS ghcr.io/oschwald/maxminddb-mcp:0.2.0. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add oschwald-maxminddb-mcp -- docker run --rm -i -e MAXMINDDB_MCP_DOWNLOAD_ENABLED -e MAXMINDDB_MCP_DATABASE_DIR -e MAXMINDDB_MCP_ACCOUNT_ID -e MAXMINDDB_MCP_LICENSE_KEY -e MAXMINDDB_MCP_EDITIONS ghcr.io/oschwald/maxminddb-mcp:0.2.0
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

### Cursor

```json
{
  "mcpServers": {
    "oschwald-maxminddb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED",
        "-e",
        "MAXMINDDB_MCP_DATABASE_DIR",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "-e",
        "MAXMINDDB_MCP_EDITIONS",
        "ghcr.io/oschwald/maxminddb-mcp:0.2.0"
      ]
    }
  }
}
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

### VS Code

```json
{
  "servers": {
    "oschwald-maxminddb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED",
        "-e",
        "MAXMINDDB_MCP_DATABASE_DIR",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "-e",
        "MAXMINDDB_MCP_EDITIONS",
        "ghcr.io/oschwald/maxminddb-mcp:0.2.0"
      ]
    }
  }
}
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

### Codex

```bash
codex mcp add oschwald-maxminddb-mcp -- docker run --rm -i -e MAXMINDDB_MCP_DOWNLOAD_ENABLED -e MAXMINDDB_MCP_DATABASE_DIR -e MAXMINDDB_MCP_ACCOUNT_ID -e MAXMINDDB_MCP_LICENSE_KEY -e MAXMINDDB_MCP_EDITIONS ghcr.io/oschwald/maxminddb-mcp:0.2.0
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "oschwald-maxminddb-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "-e",
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED",
        "-e",
        "MAXMINDDB_MCP_DATABASE_DIR",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "-e",
        "MAXMINDDB_MCP_EDITIONS",
        "ghcr.io/oschwald/maxminddb-mcp:0.2.0"
      ],
      "enabled": true
    }
  }
}
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

### Hermes

```yaml
mcp_servers:
  oschwald-maxminddb-mcp:
    command: "docker"
    args: ["run", "--rm", "-i", "-e", "MAXMINDDB_MCP_DOWNLOAD_ENABLED", "-e", "MAXMINDDB_MCP_DATABASE_DIR", "-e", "MAXMINDDB_MCP_ACCOUNT_ID", "-e", "MAXMINDDB_MCP_LICENSE_KEY", "-e", "MAXMINDDB_MCP_EDITIONS", "ghcr.io/oschwald/maxminddb-mcp:0.2.0"]
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

### Netclaw

```json
{
  "McpServers": {
    "oschwald-maxminddb-mcp": {
      "Transport": "stdio",
      "Command": "docker",
      "Arguments": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED",
        "-e",
        "MAXMINDDB_MCP_DATABASE_DIR",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "-e",
        "MAXMINDDB_MCP_EDITIONS",
        "ghcr.io/oschwald/maxminddb-mcp:0.2.0"
      ]
    }
  }
}
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

### Other

```json
{
  "mcpServers": {
    "oschwald-maxminddb-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED",
        "-e",
        "MAXMINDDB_MCP_DATABASE_DIR",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "-e",
        "MAXMINDDB_MCP_EDITIONS",
        "ghcr.io/oschwald/maxminddb-mcp:0.2.0"
      ]
    }
  }
}
```

This image reads MAXMINDDB_MCP_DOWNLOAD_ENABLED, MAXMINDDB_MCP_DATABASE_DIR, MAXMINDDB_MCP_ACCOUNT_ID, MAXMINDDB_MCP_LICENSE_KEY and MAXMINDDB_MCP_EDITIONS. Set them in your client's env block for this server; docker run -e passes each one through to the container.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-27 (score 6, 0)

- [security regression] Provenance: unverified → fail

### 2026-10-26 (score 6, 0)

- [security regression] Provenance: fail → unverified

### 2026-10-17 (score 6)

First indexed and scored.

## MCP tools (0)

Tools for package channels are captured by running the package in an isolated sandbox. Our sandbox could not run this package, so no tool list has been captured. That is a gap on our side, not a finding about the package.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/oschwald-maxminddb-mcp/ghcr-io-oschwald-maxminddb-mcp#diagnostics

## Score history

- 2026-11-05: 6
- 2026-11-04: 6
- 2026-11-03: 6
- 2026-11-02: 6
- 2026-11-01: 6
- 2026-10-31: 6
- 2026-10-30: 6
- 2026-10-29: 6
- 2026-10-28: 6
- 2026-10-27: 6
- 2026-10-26: 6
- 2026-10-25: 6
- 2026-10-24: 6
- 2026-10-23: 6
- 2026-10-22: 6
- 2026-10-21: 6
- 2026-10-20: 6
- 2026-10-19: 6
- 2026-10-18: 6
- 2026-10-17: 6

## Common questions

### What is the MaxMindDB MCP server?

MaxMindDB is an MCP server listed in the public MCP registry as io.github.oschwald/maxminddb-mcp. Query IP locations and network ownership in GeoIP2, GeoLite2, and custom MMDB databases. This page covers its container image (ghcr.io/oschwald/maxminddb-mcp).

### Is the MaxMindDB MCP server safe to use?

MaxMindDB scores 6 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### Is the MaxMindDB MCP server still maintained?

MaxMindDB is marked deprecated in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- GitHub Container Registry: https://ghcr.io/oschwald/maxminddb-mcp
- Repository: https://github.com/oschwald/maxminddb-mcp
- Changelog RSS feed: https://verifymcp.io/servers/oschwald-maxminddb-mcp/ghcr-io-oschwald-maxminddb-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/oschwald-maxminddb-mcp/ghcr-io-oschwald-maxminddb-mcp.json
- HTML version of this page: https://verifymcp.io/servers/oschwald-maxminddb-mcp/ghcr-io-oschwald-maxminddb-mcp