koda-x402-mcp

MCP server for KODA Trust Oracle — query agent trust scores, verify identities, and monitor reliability via x402 micropayments.

Chainlink tells smart contracts what prices are real. KODA tells agents which other agents are real.

Quick Start

PRIVATE_KEY=0xYourKey npx -y koda-x402-mcp

Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "koda": {
      "command": "npx",
      "args": ["-y", "koda-x402-mcp"],
      "env": {
        "PRIVATE_KEY": "0xYourPrivateKey"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "koda": {
      "command": "npx",
      "args": ["-y", "koda-x402-mcp"],
      "env": {
        "PRIVATE_KEY": "0xYourPrivateKey"
      }
    }
  }
}

Claude Code

claude mcp add koda -- npx -y koda-x402-mcp

Set PRIVATE_KEY in your environment before running.

Tools

| Tool | Description | Price | |------|-------------|-------| | trust_score | Composite trust score (0-100) with tier rating, confidence, breakdown, and AI risk assessment | $0.05 | | verify_agent | Identity verification with wallet enrichment, risk flags, and settlement history | $0.02 | | search_agents | Search/browse agent registry with filters (query, min score, min tier, on-chain) | $0.01 | | monitor_agent | Uptime monitoring with latency tracking and 7/30-day trend analysis | $0.01 |

How It Works

1. Your AI agent calls a KODA MCP tool (e.g. trust_score)
2. MCP server sends request to KODA API
3. KODA returns 402 Payment Required
4. MCP server auto-signs a USDC micropayment using your wallet
5. Retries with payment proof
6. Returns trust data to your agent

All payments are in USDC on Base. Typical query costs $0.01-$0.05.

Requirements

• Node.js 20+
• Wallet with USDC on Base (+ small ETH for gas)

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | PRIVATE_KEY | Yes | — | 0x-prefixed private key with USDC on Base | | KODA_API_URL | No | https://x402.kodaoracle.com | KODA API endpoint |

Example Queries

Ask your AI agent:

• "What's the trust score for agent 0xD34411a70EffbDd000c529bbF572082ffDcF1794?"
• "Verify this agent: silverback"
• "Show me all agents with trust score above 80"
• "What's the uptime for the Silverback agent?"

Links

• API: https://x402.kodaoracle.com
• Website: https://kodaoracle.com
• Twitter: https://x.com/KodaOracle
• Pricing: https://x402.kodaoracle.com/pricing

License

MIT