MCP Server

freeiplookupapi ships a hosted Model Context Protocol (opens new window) (MCP) server, so AI agents and assistants can call the API as native tools — no SDK or glue code required.

https://api.freeiplookupapi.com/mcp

The endpoint speaks the streamable HTTP transport. Listing the available tools works without authentication; executing a tool requires your API key, sent as the apikey header. You can get a free API key here (opens new window).

Connect

Using Claude Code:

claude mcp add --transport http freeiplookupapi https://api.freeiplookupapi.com/mcp --header "apikey: YOUR_API_KEY"

Or add the server to any MCP-capable client (Claude Desktop, Cursor, VS Code, ...):

{
  "mcpServers": {
    "freeiplookupapi": {
      "url": "https://api.freeiplookupapi.com/mcp",
      "headers": { "apikey": "YOUR_API_KEY" }
    }
  }
}

Available tools

The tools are generated from the same OpenAPI specification (opens new window) that describes the REST API, so they always match the documented endpoints, parameters and responses.

Tool	Endpoint	Description
getInfo	GET /v1/info	Look up an IP address
getStatus	GET /v1/status	Account quota status

Quotas and errors

Tool calls are metered exactly like REST requests: they consume your plan quota and return the same status codes and error responses (401, 422, 429, ...). If a call fails, the tool result contains the API's error message including hints on how to proceed.