Skip to content
MCP server

IPinfo

Official IPinfo server for looking up location, network and VPN status of IP addresses

Install
Pricing
Freemium
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.3.2
Listing updated
3 days ago

About IPinfo

IPinfo is a freemium MCP server for security. It can run locally on your machine or as a hosted remote server.

Questions like "where is this IP, who owns the network, and is it a VPN?" are answered from IPinfo's own data. The server runs hosted at mcp.ipinfo.io with OAuth sign-in to your IPinfo account, or locally over stdio from the PyPI package ipinfo-mcp-server with an API token. There are also a Claude Desktop extension and a Gemini CLI extension.

Seven tools split by plan. ipinfo_lookup, ipinfo_geolocate and ipinfo_asn work on any plan, with a detailed option needing Core or Plus. ipinfo_check_privacy flags VPN, proxy, relay, Tor, hosting, anycast, mobile and satellite and needs a paid plan, ipinfo_check_residential_proxy needs residential proxy access, and ipinfo_quota reports usage. A Lite lookup is offered only to agents without an account. Tools your plan lacks return ACCESS_DENIED.

Usage is metered through your token. The free Lite plan has unlimited requests but country-level geolocation, while Core costs $26 a month for 150k requests.

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.ipinfo.io/

Add to Settings → Connectors → Add custom connector

https://mcp.ipinfo.io/
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.ipinfo.io/"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.ipinfo.io/"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • IPINFO_TOKENYour IPinfo API token. Get a free one at https://ipinfo.io/signupRequired

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

ipinfo_lookup
Full IP data: geolocation, network and metadata
ipinfo_geolocate
Geographic location
ipinfo_asn
Autonomous system ownership
ipinfo_check_privacy
VPN, proxy, relay, Tor, hosting, anycast, mobile and satellite flags
ipinfo_check_residential_proxy
Residential proxy detection
ipinfo_quota
API usage and remaining quota
ipinfo_lite_lookup
Lite IP data for agents without an account

What it does

IP lookup
ipinfo_lookup returns geolocation, network and metadata for a list of IPs.
Geolocation
ipinfo_geolocate gives location, with city-level detail on Core or Plus.
ASN ownership
ipinfo_asn identifies the autonomous system behind an address.
Privacy checks
ipinfo_check_privacy flags VPN, proxy, relay, Tor and hosting use on paid plans.
Residential proxy detection
ipinfo_check_residential_proxy needs residential proxy access.
Quota check
ipinfo_quota shows API usage and remaining quota.

Good for

  • Check whether a login came from a VPN or Tor exit node
  • Find which company or ISP owns an address
  • Enrich a list of IPs from a log file
  • Check how much IPinfo quota remains

Pricing

Freemium, from $26 a month

Lite free; Core $26/mo, Max $163/mo, Enterprise custom

Prices change. Check ipinfo.io before you buy.

IPinfo FAQ

Do I need an account?

Yes, a free IPinfo account for the hosted server or an API token for the local one; only the Lite lookup is offered to agents without an account.

What does the free plan include?

IPinfo Lite is free with unlimited requests but country-level geolocation and basic ASN data.

Which tools need a paid plan?

ipinfo_check_privacy needs a paid plan; detailed results need Core or Plus.

How do I run it locally?

Use uvx ipinfo-mcp-server with IPINFO_TOKEN set.

Is IPinfo free?

IPinfo has a free plan, with paid plans for more usage or features. Paid plans start at $26 a month.

How do I add IPinfo to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.ipinfo.io/

What are the best alternatives to IPinfo?

The closest alternatives to IPinfo are REA, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP and Agent Roast.

Alternatives to IPinfo

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  6. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases