/install graph-advocate
Graph Advocate
Ask any blockchain data question in plain English. Get back live data — not just a recommendation.
Routing
Match the user's intent to the right service. Load only the reference you need.
| Intent | Service | Reference | Use for |
|---|---|---|---|
| Token balances, holders, swaps, NFTs | token-api | token-api.md | Wallet data across EVM, Solana, TON |
| Find a subgraph for a protocol | subgraph-registry | subgraph-registry.md | Search 14,733+ subgraphs by protocol/chain |
| Aave lending data | graph-aave-mcp | aave.md | 40 tools — V2/V3/V4, liquidations, rates |
| Polymarket prediction markets | graph-polymarket-mcp | polymarket.md | 31 tools — prices, P&L, open interest |
| x402 payment analytics | x402-analytics | x402.md | Payment volume, facilitators, daily stats on Base |
| Raw block data, streaming | substreams | — | Traces, logs, custom transformations |
| Agent discovery (ERC-8004) | 8004scan | — | Find AI agents by capability |
| MCP server auth | mcp8004 | — | ERC-8004 identity verification |
| Cross-protocol lending | graph-lending-mcp | — | Compare Aave/Compound/Morpho rates |
| Limitless prediction markets | graph-limitless-mcp | — | Markets on Base |
If the request spans two services, use both and combine results.
Quick Examples
"Top 10 USDC holders on Ethereum" → token-api
"Best subgraph for Uniswap V3 on Arbitrum?" → subgraph-registry
"Aave V3 liquidations above $50K" → graph-aave-mcp
"x402 payment volume on Base today" → x402-analytics
"Find agents that do trading" → 8004scan
How It Works
- Agent sends plain-English question
- Graph Advocate identifies the best service
- Searches the subgraph registry (14,733 subgraphs with query hints)
- Executes the query and returns live data in the response
- Includes
get_startedlink for agents to get their own free API key
Response Format
{
"recommendation": "subgraph-registry",
"reason": "why this service fits",
"confidence": "high",
"query_ready": { "tool": "...", "args": {...} },
"execution_result": { "source": "subgraph-gateway", "data": {...} },
"get_started": "Free API key: https://thegraph.com/studio/",
"cache_for_seconds": 86400
}
Endpoints
| Method | URL | Purpose |
|---|---|---|
| POST | https://graph-advocate-production.up.railway.app/ |
A2A JSON-RPC 2.0 |
| POST | https://graph-advocate-production.up.railway.app/chat |
Simple HTTP chat |
| GET | https://graph-advocate-production.up.railway.app/.well-known/agent-card.json |
Agent card |
| GET | https://graph-advocate-production.up.railway.app/dashboard |
Live monitoring |
| POST | https://graph-advocate-production.up.railway.app/feedback |
Agent feedback |
x402 Payments
10 free queries/day per sender. After that, $0.01 USDC on Base per query. Payments go to Ampersend smart account. Agents with x402 wallets pay automatically.
External Endpoints
| Endpoint | Data sent | Purpose |
|---|---|---|
graph-advocate-production.up.railway.app |
Your plain-English query | Routes to the right Graph service |
gateway.thegraph.com/api/ |
GraphQL queries | Executes subgraph queries for live data |
token-api.thegraph.com/ |
REST requests | Fetches token/NFT/swap data |
api.studio.thegraph.com |
GraphQL queries | x402 payment analytics |
Security & Privacy
- Instruction-only skill — no code is downloaded or executed on your machine
- No credentials required — Graph Advocate does not need API keys from you
- No local file access — reads nothing from your filesystem
- Stateless — no session data persists between requests
Identity
- ERC-8004: Agent #734 (Arbitrum), #41,034 (Base)
- ENS: graphadvocate.eth
- Ampersend: app.ampersend.ai/discover/agent/8453:41034
Trust Statement
By using this skill, your plain-English data queries are sent to graph-advocate-production.up.railway.app (hosted on Railway, operated by @paulieb14). The service returns structured JSON with live data. Only install if you trust this endpoint with your query text.
Links
- GitHub: https://github.com/PaulieB14/graph-advocate
- The Graph: https://thegraph.com
- Subgraph Studio: https://thegraph.com/studio
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install graph-advocate - 安装完成后,直接呼叫该 Skill 的名称或使用
/graph-advocate触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Graph Advocate 是什么?
Route any blockchain data question to the right Graph Protocol service. Returns live data from 14,733+ subgraphs, Token API (EVM/Solana/TON), x402 payment an... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 327 次。
如何安装 Graph Advocate?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install graph-advocate」即可一键安装,无需额外配置。
Graph Advocate 是免费的吗?
是的,Graph Advocate 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Graph Advocate 支持哪些平台?
Graph Advocate 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Graph Advocate?
由 PaulieB14(@paulieb14)开发并维护,当前版本 v2.0.0。