An MCP server that tells you your own public IP address. Runs serverlessly on val.town.

Example response

Your IP address is: 203.0.113.42

Point any MCP-compatible client at this val's URL.

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ip": {
      "type": "http",
      "url": "https://my-ip-mcp.val.run/"
    }
  }
}

Restart Claude Desktop, then ask: "What's my IP address?"

{
  "mcp": {
    "servers": {
      "ip": {
        "type": "http",
        "url": "https://my-ip-mcp.val.run/"
      }
    }
  }
}

# 1 — Handshake
curl -s -X POST https://my-ip-mcp.val.run/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# 2 — Call the tool
curl -s -X POST https://my-ip-mcp.val.run/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_ip","arguments":{}}}'

• Transport: MCP Streamable HTTP — a single HTTP endpoint that handles JSON-RPC 2.0 messages via POST
• IP detection: reads the X-Forwarded-For header set by val.town's CDN (first value = real client IP), falling back to X-Real-IP
• Stateless: no sessions, no storage, no authentication
• No logging: IP addresses are never stored or logged