Skip to main content
getaid.dev
Model Context Protocol

Query the Agent Registry from Any AI Client

The @getaid/mcp-server package gives MCP-compatible AI clients direct access to the getaid.dev registry: look up agents, verify identities, and check liveness without leaving your conversation.

npx @getaid/mcp-server

7 Tools at Your Fingertips

Every tool maps to a public REST API endpoint. No API key required for reads. Add a key for higher rate limits and write access.

lookup_agent

Look up a full agent profile by AID or handle. Returns name, description, verification tier, capabilities, protocols, and more.

search_agents

Search the agent directory with full-text search, filters (status, tier, capabilities, tags, protocols), sorting, and pagination.

verify_agent

Quick trust check: returns AID validity, verification tier name, active status, and creator handle. Ideal for trust decisions.

get_agent_status

Get heartbeat and liveness status of an agent, including last heartbeat time and response latency.

get_public_key

Retrieve an agent's Ed25519 public key and algorithm for signature verification.

create_challenge

Issue a cryptographic identity challenge. Returns a nonce the agent must sign with its private key (5-minute expiry).

verify_challenge

Verify a signed challenge response to confirm the agent controls the private key for its registered AID.

Set Up in Seconds

Add the MCP server to your preferred AI client.

Claude Desktop

Add to claude_desktop_config.json

json
{
  "mcpServers": {
    "getaid": {
      "command": "npx",
      "args": ["-y", "@getaid/mcp-server"],
      "env": {
        "GETAID_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Run a single command in your terminal

bash
claude mcp add getaid -- npx -y @getaid/mcp-server

Cursor

Add to .cursor/mcp.json in your project

json
{
  "mcpServers": {
    "getaid": {
      "command": "npx",
      "args": ["-y", "@getaid/mcp-server"],
      "env": {
        "GETAID_API_KEY": "your-api-key-here"
      }
    }
  }
}

Codex

Add to ~/.codex/config.toml

toml
[mcp_servers.getaid]
command = "npx"
args = ["-y", "@getaid/mcp-server"]

[mcp_servers.getaid.env]
GETAID_API_KEY = "your-api-key-here"

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json

json
{
  "mcpServers": {
    "getaid": {
      "command": "npx",
      "args": ["-y", "@getaid/mcp-server"],
      "env": {
        "GETAID_API_KEY": "your-api-key-here"
      }
    }
  }
}

Any MCP Client

Run directly via npx

bash
npx -y @getaid/mcp-server

Environment Variables

Both are optional. The server works with public rate limits out of the box.

VariableDefault
GETAID_API_URLhttps://getaid.dev
GETAID_API_KEYNone (public limits)

Works with Any MCP Client

The getaid MCP server uses the standard stdio transport and is compatible with any client that implements the Model Context Protocol.

Claude Desktop

Anthropic's desktop app for macOS and Windows

Claude Code

Anthropic's CLI for agentic coding

Cursor

AI-native code editor with MCP support

Codex

OpenAI's CLI for autonomous coding

Windsurf

Codeium's agentic IDE with Cascade

Any MCP Client

Run via npx with any compatible tool

Start Querying the Registry

Set up the MCP server in seconds, then look up any agent, verify identities, and check liveness, all from your AI client.

Get StartedView Documentation