IPinfo

io.github.ipinfoPublished by GitHub account ipinfov0.2.3Updated Oct 29, 2026

Official IPinfo MCP Server - IP intelligence tools for AI assistants

VerifiedStreamable HTTPWeb executableLocation & LifestyleSecurity & Monitoring

Overview

AI-generated overview

Official IPinfo server that lets an assistant look up IP addresses for geolocation, network ownership, and VPN, proxy, Tor, or residential proxy detection.

What you can do
  • Look up full IP data, geolocation, and network ownership (ASN) for lists of public IPv4/IPv6 addresses, with a detailed mode for richer fields
  • Check privacy signals per IP: VPN, proxy, relay, Tor, hosting, anycast, mobile, and satellite flags
  • Detect residential proxies, including the proxy service name and how recently it was seen
  • Check API usage and remaining quota for the token
  • Page through large IP lists and see per-IP errors and validation errors for invalid addresses
When to use it
Useful when an assistant needs to interpret IP addresses in logs, sign-ups, or support tickets: where a visitor is, which network or company they come from, or whether traffic looks like a VPN, Tor, or residential proxy. It fits fraud, abuse, and access-analysis questions rather than general web search.
Requirements
An IPinfo account and API token (IPINFO_TOKEN) for the local PyPI package, which runs over stdio via uvx; the hosted endpoint at mcp.ipinfo.io uses OAuth sign-in instead. Some tools need a paid plan or Residential Proxy access. Python 3.14+ and uv only if running from source.
Before you install
The token is a billable credential: lookups consume API quota, and detailed or privacy tools require paid plans. IP addresses queried are sent to IPinfo's API, so avoid submitting addresses you must not share with a third party. Results are cached in memory, and the server can also run over HTTP, where each request carries its own bearer token.

Installation

In SourceWeft

  1. Open IPinfo in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.ipinfo%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "ipinfo": {
      "type": "http",
      "url": "https://mcp.ipinfo.io/"
    }
  }
}

README

IPinfo MCP Server

The official IPinfo MCP Server lets AI assistants such as Claude answer questions about IP addresses. Ask where an IP is located, which company or network it belongs to, or whether it's a VPN, proxy, Tor exit node, or residential proxy, and the assistant looks it up with IPinfo data.

It implements the Model Context Protocol (MCP), the open standard AI assistants use to connect to external tools, so it works with any MCP-compatible client. It supports the IPinfo Lite, Core, Plus, and Residential Proxy plans.

For the full guide, see the official documentation.

[OpenSSF Scorecard] [OpenSSF Best Practices]

Installation

You need an IPinfo account. Sign up for free at ipinfo.io/signup.

Hosted server

Point your MCP client at https://mcp.ipinfo.io/ (Streamable HTTP). The first time it connects, it asks you to sign in with your IPinfo account through OAuth.

Local server (PyPI)

The server is published on PyPI as ipinfo-mcp-server and runs over stdio, authenticating with your API token. With uv installed, add it to your MCP client configuration:

json
{  "mcpServers": {    "ipinfo": {      "command": "uvx",      "args": ["ipinfo-mcp-server"],      "env": {        "IPINFO_TOKEN": "<your-ipinfo-token>"      }    }  }}

Claude Desktop extension

Download mcp.mcpb from the latest GitHub release and open it with Claude Desktop. You'll be asked for your API token during installation.

MCP Registry

The server is listed in the MCP Registry as io.github.ipinfo/mcp.

The server is also listed on LightNow.

Tools

ToolDescriptionPlan requirement
ipinfo_lookupFull IP data: geolocation, network, and metadataAny; detailed: true needs Core/Plus
ipinfo_geolocateGeographic locationAny; detailed: true needs Core/Plus
ipinfo_asnAutonomous system (network ownership)Any; detailed: true needs Core/Plus
ipinfo_check_privacyVPN, proxy, relay, Tor, hosting, anycast, mobile, satellite flagsPaid plan
ipinfo_check_residential_proxyResidential proxy detectionResidential Proxy access
ipinfo_quotaAPI usage and remaining quotaAny

Tools that lack access for the token's plan return an ACCESS_DENIED error.

Common parameters

All tools except ipinfo_quota take a list of IPs and are paginated:

ParameterTypeDefaultDescription
ipsstring[]requiredPublic IPv4 or IPv6 addresses. Private, loopback, reserved, multicast, and bogon addresses are rejected and reported in validation_errors.
pageinteger11-based page of the result set. Values below 1 are clamped to 1.
page_sizeinteger25IPs resolved per page, up to 1000. Only IPs on the requested page are fetched, so smaller pages consume less quota per call.

ipinfo_lookup, ipinfo_geolocate, and ipinfo_asn also take:

ParameterTypeDefaultDescription
detailedbooleanfalsefalse queries the Lite endpoint. true queries the full lookup endpoint, which returns more fields.

Common output

IP-based tools return:

FieldDescription
resultsObject keyed by IP with the tool-specific data below.
errorsObject keyed by IP for IPs the API returned an error for. These IPs are left out of results.
validation_errorsObject keyed by input for values that aren't valid public IPs. Only present when there are any.
_paginationtotal_results, page, page_size, total_pages, has_next, has_previous.
_metaapi_calls_made and from_cache. Results are cached in memory, so repeat lookups don't consume API quota.

If the whole request fails (for example a missing or invalid token), the tool returns an error object instead, with code (ACCESS_DENIED, RATE_LIMITED, INVALID_TOKEN, NO_TOKEN, API_ERROR, or UNKNOWN), message, and suggestion.

ipinfo_lookup

Returns the raw IPinfo API response for each IP.

  • detailed: false (Lite): ip, asn, as_name, as_domain, country, country_code, continent, continent_code.
  • detailed: true (full lookup): ip, hostname, geo (city, region, country, continent, coordinates, timezone, postal code), as (ASN, name, domain, type), anonymous (proxy, relay, Tor, VPN), mobile, and the is_anonymous, is_anycast, is_hosting, is_mobile, is_satellite flags. Some fields are only available on Plus.

ipinfo_geolocate

Returns, per IP: ip, country, country_code, continent, continent_code. With detailed: true, also city, region, region_code, latitude, longitude, timezone, postal_code.

ipinfo_asn

Returns, per IP: ip, asn, name, domain. With detailed: true, also type (isp, hosting, business, education) and last_changed.

ipinfo_check_privacy

Returns, per IP: ip, is_anonymous, anonymous (is_proxy, is_relay, is_tor, is_vpn), is_anycast, is_hosting, is_mobile, is_satellite.

ipinfo_check_residential_proxy

Returns, per IP: ip and is_residential_proxy. For residential proxies, also service (proxy service name), last_seen (date), and percent_days_seen.

ipinfo_quota

Takes no parameters. Returns token (omitted when connected with OAuth), requests (day, month, limit, remaining), and per-feature quotas under features.

Configuration

The server is configured through environment variables:

VariableDefaultDescription
IPINFO_TOKENAPI token (stdio transport; over HTTP the token comes from the request)
IPINFO_API_BASE_URLhttps://api.ipinfo.ioBase URL for api.ipinfo.io endpoints
IPINFO_LEGACY_BASE_URLhttps://ipinfo.ioBase URL for legacy ipinfo.io endpoints (e.g. /me)
IPINFO_CACHE_TTL3600Seconds a cached IP result stays fresh
IPINFO_TRANSPORTstdioTransport type (stdio or http)
HOST0.0.0.0HTTP host (only for http transport)
PORT8000HTTP port (only for http transport)
IPINFO_OAUTH_ISSUEROAuth issuer whose access tokens are accepted; OAuth is off when unset
IPINFO_MCP_RESOURCE_URLPublic URL of this server, required with IPINFO_OAUTH_ISSUER
IPINFO_OAUTH_JWKS_URI<issuer>/.well-known/jwks.jsonWhere the issuer publishes its signing keys
IPINFO_OPENAI_APPS_CHALLENGEToken served at /.well-known/openai-apps-challenge for OpenAI's domain verification

With the http transport, each request authenticates with its own Authorization: Bearer <token> header.

Setting IPINFO_OAUTH_ISSUER turns on OAuth for the http transport. The server then advertises the issuer at /.well-known/oauth-protected-resource, answers requests without a valid credential with 401 Unauthorized, and verifies access tokens against the issuer's signing keys. A verified access token is sent to the IPinfo API in place of an API token. API tokens keep working as before.

Feedback

Contributing

Contributions are welcome. See CONTRIBUTING.md for the workflow and the requirements a change has to meet.

Development

Prerequisites

  • Python 3.14+
  • uv

Setup

bash
uv sync --devcp .env.example .env# Add your IPinfo token to .env

Running the server

The server supports two transports: stdio (default) and HTTP.

bash
# stdio (default, used by MCP clients)uv run ipinfo-mcp-server
# HTTPIPINFO_TRANSPORT=http HOST=0.0.0.0 PORT=8000 uv run ipinfo-mcp-server

Tests

bash
# All testsuv run pytest
# Integration tests (requires IPINFO_TOKEN)uv run pytest tests/integration/

Integration tests hit the real IPinfo API and validate response structure only (no exact value assertions). They require IPINFO_TOKEN to be set and are skipped otherwise.

Type checking

bash
uv run pyright

Linting

bash
uv run ruff check .uv run ruff format .

Source: README.md at commit f4b89e3

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

6
  1. v0.2.3LatestOct 29, 2026
  2. v0.2.1Oct 22, 2026
  3. v0.2.0Oct 21, 2026
  4. v0.1.14Oct 1, 2026
  5. v0.1.13Sep 24, 2026
  6. v0.1.12Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts