protogrid

Search / io.github.ipinfo/mcp

IPinfo

R1· needs a key

Official IPinfo MCP Server - IP intelligence tools for AI assistants

v0.1.14 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds ipinfo_token.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality90strong
Trust97of 100
Uptime, 30 days100%
Latency p50275 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "ipinfo": {
      "type": "http",
      "url": "https://mcp.ipinfo.io/",
      "headers": {
        "Authorization": "Bearer ${ipinfo_token}"
      }
    }
  }
}
claude mcp add --transport http ipinfo https://mcp.ipinfo.io/ --header "Authorization: Bearer ${ipinfo_token}"
[mcp_servers.ipinfo]
url = "https://mcp.ipinfo.io/"
bearer_token_env_var = "ipinfo_token"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ipinfo": {
      "type": "remote",
      "url": "https://mcp.ipinfo.io/",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:ipinfo_token}"
      }
    }
  }
}
{
  "mcpServers": {
    "ipinfo": {
      "type": "http",
      "url": "https://mcp.ipinfo.io/",
      "headers": {
        "Authorization": "Bearer ${ipinfo_token}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=ipinfo&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmlwaW5mby5pby8iLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtpcGluZm9fdG9rZW59In19"
}
{
  "servers": {
    "ipinfo": {
      "type": "http",
      "url": "https://mcp.ipinfo.io/",
      "headers": {
        "Authorization": "Bearer ${ipinfo_token}"
      }
    }
  }
}
{
  "mcpServers": {
    "ipinfo": {
      "httpUrl": "https://mcp.ipinfo.io/",
      "headers": {
        "Authorization": "Bearer ${ipinfo_token}"
      }
    }
  }
}
extensions:
  "ipinfo":
    enabled: true
    name: "ipinfo"
    type: streamable_http
    uri: "https://mcp.ipinfo.io/"
    headers:
      "Authorization": "Bearer ${ipinfo_token}"
    timeout: 300

Placeholders to fill from your own secret store: ${ipinfo_token}. The registry never accepts secret values.

Quality 90 / 100strong

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations6 of 6 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 2,474 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability75 · weight 15
  • warn
    stability.changes6 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know [email protected]

6 tools, about 2,474 tokens to load them all · tool set 2f72a4409517 · tools last changed 2026-09-24 · checked 2026-10-19 16:53 UTC

Tool changes

  • ipinfo_quotachangedtitle, output schema
  • ipinfo_asnchangedtitle, output schema
  • ipinfo_geolocatechangedtitle, output schema
  • ipinfo_check_residential_proxychangedtitle, output schema
  • ipinfo_check_privacychangedtitle, output schema
  • ipinfo_lookupchangedtitle, output schema

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 97 / 100

provenance90
liveness100
freshness100
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-100% +updated-18d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPIthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp.ipinfo.io/ streamable-httpapi_key ${ipinfo_token}yes100%275 ms2026-07-282026-10-19
packageregistryversionruntimesecrets
ipinfo-mcp-serverpypi0.1.14uvxIPINFO_TOKEN

Tools (6)

ipinfo_asnread-onlyGet autonomous system (network ownership) information for IP addresses. By default queries the IPinfo Lite endpoint, which returns ASN, name, and domain. Set detailed=True to query the full lookup endpoint, which also includes the network type (e.g. isp, hosting, business, education). Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_check_privacyread-onlyCheck whether IP addresses are using privacy or anonymity services. Returns privacy flags for each IP: whether it is anonymous, using a VPN, proxy, relay, or Tor, and whether it is an anycast, hosting, mobile, or satellite address. Requires a paid API token. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "no privacy services detected": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_check_residential_proxyread-onlyCheck whether IP addresses are known residential proxies. Returns whether each IP is a residential proxy and, if so, the proxy service name, the date it was last seen, and the percentage of days the IP was observed as a proxy. Requires a paid API token with residential proxy access. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Do not treat a missing result as "not a residential proxy": check errors. Results are cached in memory for the session, so repeat checks of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_geolocateread-onlyGet geographic location data for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country and continent. Set detailed=True to query the full lookup endpoint, which adds city, region, coordinates, timezone, and postal code. Results are paginated. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_lookupread-onlyLook up geolocation, network, and metadata for one or more IP addresses. By default queries the IPinfo Lite endpoint, which returns country, continent, and ASN info. Set detailed=True to query the full lookup endpoint, which adds city-level geolocation, privacy flags (VPN, proxy, Tor, hosting, anycast), and richer AS data. Results are paginated. Use page and page_size to control which slice is returned. If the API reports an error for specific IPs, those IPs are listed in errors with the reason and left out of results. Results are cached in memory for the session, so repeat lookups of the same IP are served from cache without consuming API quota. You do not need to maintain your own cache or deduplicate IPs before calling this tool. The _meta field reports api_calls_made and from_cache counts.
ipinfo_quotaread-onlyCheck your IPinfo API usage and remaining quota. Returns daily and monthly request counts, the plan limit, and how many requests remain.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.ipinfo/mcp",
  "icons": [
    {
      "src": "https://raw.githubusercontent.com/ipinfo/mcp/main/assets/logo-light.png",
      "theme": "light",
      "mimeType": "image/png"
    },
    {
      "src": "https://raw.githubusercontent.com/ipinfo/mcp/main/assets/logo-dark.png",
      "theme": "dark",
      "mimeType": "image/png"
    }
  ],
  "title": "IPinfo",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.ipinfo.io/",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "value": "Bearer {ipinfo_token}",
          "isSecret": true,
          "variables": {
            "ipinfo_token": {
              "format": "string",
              "isSecret": true,
              "isRequired": true,
              "description": "Your IPinfo API token"
            }
          },
          "isRequired": true,
          "description": "Your IPinfo API token as a bearer credential. Get a free one at https://ipinfo.io/signup"
        }
      ]
    }
  ],
  "version": "0.1.14",
  "packages": [
    {
      "version": "0.1.14",
      "transport": {
        "type": "stdio"
      },
      "identifier": "ipinfo-mcp-server",
      "runtimeHint": "uvx",
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "environmentVariables": [
        {
          "name": "IPINFO_TOKEN",
          "format": "string",
          "isSecret": true,
          "isRequired": true,
          "description": "Your IPinfo API token. Get a free one at https://ipinfo.io/signup"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/ipinfo/mcp",
    "source": "github"
  },
  "websiteUrl": "https://ipinfo.io",
  "description": "Official IPinfo MCP Server - IP intelligence tools for AI assistants"
}