Skip to content

PaulieB14/graph-advocate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

310 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Graph Advocate

Graph Advocate

Onchain Data Routing Agent for The Graph Protocol

Ask a question about blockchain data. Get back the right subgraph, a ready-to-execute query, and an MCP install hint.

CDP Bazaar x402scan ERC-8004

📚 Docs · Live Dashboard · Chat · Agent Card · llms.txt · capabilities.json

Discoverable on: Agentic Market · CDP Bazaar · Ampersend · Agentverse · x402scan · ClawHub · 8004scan

For LLM tools (Cursor, Claude Code, etc.): point at https://graphadvocate.com/llms.txt for auto-discovery of routing services and capabilities.


What it does

Routes plain-English data requests to the right Graph Protocol service — Token API, Subgraph Registry, Substreams, or one of 8+ protocol-specific MCP packages (Aave, Polymarket, Uniswap, etc.). Every response includes a working query you can execute immediately.

Searches 15,500+ indexed subgraphs in real-time. Powered by Claude.

x402 Payments

Accepts autonomous agent payments on Base mainnet via x402. Verified and settled by the Coinbase CDP facilitator.

Free tier 3 queries/day per agent (POST /)
Paid $0.01 USDC per query (POST /route with x402 payment)
Network Base (eip155:8453)
Facilitator Coinbase CDP
# Try it
npx agentcash try https://graphadvocate.com

Protocols

Protocol Identity
A2A POST / — JSON-RPC 2.0
x402 POST /route — pay-per-query on Base
MCP /mcp/sse — SSE transport
ERC-8004 Agent #734 (Arbitrum)
ENS graphadvocate.eth

Services

Routes to: Token API (balances, swaps, NFTs), Subgraph Registry (15,500+ protocols), Substreams (raw blocks), graph-aave-mcp (40 tools), graph-polymarket-mcp (31 tools), graph-lending-mcp, graph-limitless-mcp, predictfun-mcp, 8004scan (agent discovery).

Quick start

curl -X POST https://graphadvocate.com \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{"role":"user","messageId":"1","parts":[{"kind":"text","text":"Top Aave V3 markets by TVL"}]}}}'

Development

git clone git@github.com:PaulieB14/graph-advocate.git && cd graph-advocate
pip install -r requirements.txt
cp .env.example .env  # add ANTHROPIC_API_KEY
python3 a2a_server.py

Deployment

Railway (auto-deploy on push). Requires: ANTHROPIC_API_KEY, CDP_API_KEY_ID, CDP_API_KEY_SECRET, GRAPH_API_KEY.

Live: https://graphadvocate.com

License

MIT

About

Graph Protocol routing agent — routes multi-agent data requests to Token API, Subgraph Registry, or Substreams

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages