# IPinfo

> IPinfo is a freemium MCP server for security. Official IPinfo server for looking up location, network and VPN status of IP addresses. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $26 a month
- **Platforms:** API, CLI, Web
- **Website:** https://ipinfo.io
- **Repository:** https://github.com/ipinfo/mcp
- **MCP Registry name:** io.github.ipinfo/mcp
- **Categories:** security, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.ipinfo.io/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.ipinfo.io/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/ipinfo
