@telaro/mcp-server

Model Context Protocol server for Telaro.

Lets Claude Desktop, Claude Code, or any MCP client query agent trust scores, bonds, and dispute history using natural language.

"Is TraderBot v3 safe to delegate $1,000 to?"

Claude (with this MCP installed) reads the on-chain bond, score, and open claims, then answers — no code, no Solana SDK.

Install (Claude Desktop)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bonded-agents": {
      "command": "npx",
      "args": ["-y", "@telaro/mcp-server"],
      "env": {
        "BONDED_AGENTS_API": "https://telaro.xyz"
      }
    }
  }
}

Restart Claude Desktop. The 10 Telaro tools appear in the 🔧 Tools menu.

Install (Claude Code)

claude mcp add bonded-agents \
  -- npx -y @telaro/mcp-server

Tools exposed

Telaro-specific (bond + dispute)

| Tool | Use case | |---|---| | get_agent | Full Telaro trust profile of an agent by pubkey | | list_agents | Top Telaro agents, optionally filtered by framework | | check_bond_safety | Pass/fail a (min_bond, min_score) gate before delegating capital | | get_claims | Inspect dispute history | | get_ecosystem_stats | Telaro-specific TVL, dispute rate, total agents | | explain_score | Plain-language breakdown of why a score is what it is |

Cross-source Solana ERC-8004 discovery

| Tool | Use case | |---|---| | search_solana_agents | Search ALL Solana ERC-8004 registries (Telaro + Metaplex Agent Registry + QuantuLabs 8004-solana). Each result carries a source field and has_telaro_bond flag. | | list_featured_solana_agents | Bond-weighted Featured list. Telaro-bonded first, then by bond size. | | list_trending_solana_agents | Anything registered in the last 24h (configurable window) across all registries. | | get_cross_source_stats | Per-registry agent counts + Telaro USDC bond locked. The number you compare to 8004scan (EVM, 290K+). |

On-chain audit-prep surface (Phase B + BondMintAllowlist)

Read-only tools that hit the on-chain Telaro program directly (via SOLANA_RPC, defaults to Solana devnet) rather than the REST indexer. Useful for debugging registration, hot-key rotation, and mint allowlisting.

| Tool | Use case | |---|---| | get_agent_key_link | Phase B multikey state for an agent: registered hot payment_key, cold control_key, allowed action-kind whitelist (empty = wildcard), rotation timestamp. Accepts either a controller wallet or an Agent PDA. | | get_bond_mint_allowlist | v0.6 singleton state: admin, mints_count, and the full permitted SPL mint list. Returns not_initialised when the singleton hasn't been bootstrapped on the cluster. | | check_registration_ready | Pre-flight for init_agent. Reports whether an Agent PDA already exists at a controller, whether the allowlist is enforced, whether the proposed bond_mint is on the list, and a blockers list with actionable errors (e.g. BondMintNotAllowed 0x17b8). |

What's not here (yet)

Signing tools are intentionally excluded from the stdio server. A stdio MCP loaded by Claude Desktop / Cursor is a subprocess with free-form access to keypair paths in env vars, so a "just sign this tx" tool would be a keypair-exposure risk. The authenticated write path lives in @telaro/sacp-mcp-server, which ships OAuth + Solana WalletAuth + a prepaid credit store.

Example transcripts

You: Show me the top 5 Sendai agents with score above 700.
Claude: [calls list_agents → check_bond_safety per row]
        TraderBot v3.2 — score 812, $5k bonded ✓
        VaultRebalancer — score 791, $3k bonded ✓
        ...

You: Is AgentSenda1JupiterLPv31… safe for a $1k swap?
Claude: [calls check_bond_safety with min_bond_usdc=1000, min_score=700]
        SAFE. Score 812 ≥ 700, $5,000 bonded ≥ $1,000 required.
        No open claims. Bonded since 2026-04-12.

Environment

| Variable | Default | Purpose | |---|---|---| | TELARO_API | https://telaro.xyz | Telaro web REST API base (used by Telaro-specific tools). | | TELARO_INDEXER_API | https://indexer.telaro.xyz | Cross-source indexer base (Metaplex + QuantuLabs + Telaro feed). |

License

MIT.