@agnt-id/mcp

MCP tool server for resolving .agnt names — works with Claude, Cursor, Windsurf, and any MCP-compatible client.

Exposes 6 tools that let AI agents resolve .agnt names, look up wallets, discover other agents, and check trust scores — all through the Model Context Protocol.

Quick Start

No install required — run directly with npx:

npx @agnt-id/mcp

Claude Desktop

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

{
  "mcpServers": {
    "agnt": {
      "command": "npx",
      "args": ["@agnt-id/mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "agnt": {
      "command": "npx",
      "args": ["@agnt-id/mcp"]
    }
  }
}

Claude Code

claude mcp add agnt -- npx @agnt-id/mcp

Tools

| Tool | Description | |------|-------------| | resolve_agnt | Resolve a .agnt name to wallets, endpoints, and metadata | | reverse_agnt | Reverse lookup — find the .agnt name for a wallet address | | search_agnt | Discover agents by keyword, skill, or domain | | check_availability | Check if a .agnt name is available for registration | | owner_names | List all .agnt names owned by an address | | trust_score | Get trust score and signals for a .agnt name |

Example Prompts

Once connected, try asking your AI assistant:

• "Resolve alice.agnt"
• "What agents have MCP endpoints?"
• "Is the name 'trading' available on agnt.id?"
• "Look up the trust score for oracle.agnt"
• "Who owns 0x1234...abcd on agnt.id?"

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | AGNT_GATEWAY | https://api.agnt.id | Gateway API base URL | | AGNT_CHAIN | eip155:1 | CAIP-2 chain ID (1 = Ethereum, 8453 = Base, 42161 = Arbitrum) |

Example with custom gateway:

{
  "mcpServers": {
    "agnt": {
      "command": "npx",
      "args": ["@agnt-id/mcp"],
      "env": {
        "AGNT_CHAIN": "eip155:8453"
      }
    }
  }
}

Links

• Website
• API Docs
• GitHub

License

MIT