ipaddress.ai MCP Server

An MCP (Model Context Protocol) server that gives AI assistants access to IP address lookup via ipaddress.ai.

No API key required.

Tools

| Tool | Description | |---|---| | get_my_ip | Get your public IP address | | lookup_ip | Get geolocation, ASN, and organization for your IP | | check_port | Check if a port is reachable on your IP |

Setup

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "ipaddress": {
      "command": "npx",
      "args": ["-y", "ipaddress-ai-mcp"]
    }
  }
}

Cursor

Add to Cursor's MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "ipaddress": {
      "command": "npx",
      "args": ["-y", "ipaddress-ai-mcp"]
    }
  }
}

Windsurf / Other MCP Clients

Use the same pattern — the command is npx -y ipaddress-ai-mcp.

Example Usage

Once connected, you can ask your AI assistant things like:

• "What's my IP address?"
• "Where am I located based on my IP?"
• "Is port 443 open on my machine?"
• "What's my ASN and ISP?"

Development

git clone https://github.com/ipaddress-ai/ipaddress-mcp.git
cd ipaddress-mcp
npm install
npm run build
node dist/index.js

How It Works

The server calls the ipaddress.ai public API over HTTPS. No API key or account needed — it's completely free.

License

BSD 3-Clause