Cursor IDE integration

Plug idcd MCP into Cursor and the AI assistant gains live network probes from around the world.

Prerequisites

Install the MCP server

go install github.com/kite365/idcd/apps/mcp/cmd/mcp@latest

Locate the binary:

which mcp

Configure Cursor

Open Cursor settings (Cmd+,), go to Features → MCP Servers, and paste:

{
  "mcpServers": {
    "idcd": {
      "command": "/Users/yourname/go/bin/mcp",
      "env": {
        "IDCD_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Replace the path with the output of which mcp.

Or via project config

Create .cursor/mcp.json at the project root (project-scoped only):

{
  "mcpServers": {
    "idcd": {
      "command": "/path/to/mcp",
      "env": {
        "IDCD_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Example usage

Once configured, ask Composer or Chat in plain English:

You: Is my API server api.example.com reachable from Southeast Asia?
AI: [calls http with Singapore + Tokyo nodes]
Result:
Singapore — 200 OK (156ms)
Tokyo     — 200 OK (89ms)
Bangkok   — connection timeout ❌
Verdict: Thailand egress failing, check CDN configuration.

Available tools

See the tool reference: ping, http, dns, traceroute, ssl, ip, whois, diagnose.

Troubleshooting

Cursor cannot find the MCP server

Use an absolute path to the mcp binary (no ~/ or relative paths).

Tool calls return errors

Test connectivity from the terminal:

IDCD_API_KEY=sk_live_xxx mcp ping --target google.com