@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+). |

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.