Connect your AI tools to IP Geolocation Data

The IPstack MCP Server gives your coding assistant instant access to real-time IP geolocation, ASN, timezone, currency, and threat intelligence. For any IP, anywhere on the planet.

{
    "mcpServers": {
        "apilayer": {
              "command": "npx",
              "args": ["@apilayer/mcp-server"],
              "env": {
                      "APILAYER_ACCESS_KEY": "your_api_key_here"
               }
          }
      }
}

Or run locally

npx @apilayer/mcp-server

Why IPstack MCP

Everything your AI assistant needs to reason about the network around it.

City-Level Accuracy

Geolocate any IPv4 or IPv6 address down to the city, including latitude, longitude, and timezone.

Real-Time Lookups

Low-latency responses from IPstack’s global edge. No batching delays, no cold starts.

Multi-tool Support

Works with VS Code Copilot, Cursor, Windsurf, Claude Desktop, Cline, and more out of the box.

Threat Intelligence

Detect proxies, VPNs, Tor exit nodes, and known threat actors directly from your AI workflow.

ASN and Connection Data

Get ISP, ASN, connection type, and carrier metadata for richer network-aware reasoning.

Bulk and Batch Lookups

Resolve up to 50 IPs in a single call. Perfect for log analysis and security audits via your AI.

Set up in Seconds

Choose your coding tool and follow the steps. That's it.

Open Cursor Settings (Cmd/Ctrl + ,)

Navigate to the MCP section

Click "Add MCP Server" and paste the config below

Restart Cursor to activate the MCP server

{
    "mcpServers": {
      "apilayer": {
        "command": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.apilayer.com/mcp",
          "--header",
          "Authorization: Bearer \${APILAYER_MCP_TOKEN}"
        ],
        "env": {
          "APILAYER_MCP_TOKEN": "paste-your-token-here"
        }
      }
  }
}

{
    "inputs": [
      {
        "type": "promptString",
        "id": "apilayer-token",
        "description": "APILayer MCP Bearer token",
        "password": true
      }
    ],

    "servers": {
      "apilayer": {
        "type": "http",
        "url": "https://mcp.apilayer.com/mcp",
        "headers": {
          "Authorization": "Bearer \${input:apilayer-token}"
        }
      }
    }
}

[mcp_servers.apilayer]
  startup_timeout_sec = 120
  command = "mcp-remote"

  args = [
    "https://mcp.apilayer.com/mcp",
    "--header",
    "Authorization:Bearer \${APILAYER_TOKEN}",
  ]

[mcp_servers.apilayer.env]
  APILAYER_TOKEN = "Place Your Ipstack MCP token here"

Every IPstack endpoint

Your AI assistant can call any IPstack endpoint directly, without an SDK or manual API calls.

Standard Lookup

Geolocate any single IPv4 or IPv6 address in real time.

Bulk Lookup

Resolve up to 50 IPs in a single batched request.

Step 1

Install

Get your auth token
Sign up to IPstack API and get your auth token.

Step 2

Configure

Add a small JSON block to your AI tool's MCP config with your IPstack API auth key.

Step 3

Use

Ask your AI to geolocate an IP, check for VPN usage, or audit logs.

How it Works

Three steps. Under a minute. No backend required.

Watch IPstack MCP in action

Need Clarity? Here Are the Answers You Might Be Seeking

Didn’t find what you were searching for?

What is IPstack MCP?

IPstack MCP exposes the IPstack API to AI tools via Model Context Protocol (MCP), allowing you to access IP data as structured tools instead of raw HTTP calls.

What can I do with IPstack MCP?

You can fetch geolocation data (country, city, ISP, timezone, etc.) directly inside your AI workflows to power personalization, analytics, fraud detection, and automation.

Does IPstack MCP support all API endpoints?

Yes, IPstack MCP supports all IPstack endpoints, including standard lookup, bulk requests, and request-based checks, all exposed as structured tools for use inside your AI workflows.

Do I need to pay extra to use IPstack MCP?

No, there is no additional cost for using IPstack MCP. You only pay for your IPstack usage based on your plan. MCP itself is just the access layer, so once you have an auth token, you can use IPstack through MCP without any extra charges.

Do I need to modify my backend to use IPstack MCP?

No, you don’t need to modify or build any backend. Just configure MCP in your AI tool, add your IPstack auth token, and start calling endpoints directly. MCP handles the integration layer, so you can skip wrappers, servers, and custom infrastructure.

Does IPstack support IPv6?

Yes. IPstack MCP supports both IPv4 and IPv6 addresses.