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
CODEBLOCK0
How It Works
- 1. 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_started link for agents to get their own free API key
Response Format
CODEBLOCK1
Endpoints
| Method | URL | Purpose |
|---|
| POST | INLINECODE1 | 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 |
|---|
| INLINECODE6 | Your plain-English query | Routes to the right Graph service |
| INLINECODE7 |
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
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
Graph Advocate
用通俗英语提出任何区块链数据问题。获取实时数据——而不仅仅是推荐。
路由
将用户意图匹配到正确的服务。仅加载所需的参考。
| 意图 | 服务 | 参考 | 用途 |
|---|
| 代币余额、持有者、交换、NFT | token-api | token-api.md | 跨EVM、Solana、TON的钱包数据 |
| 查找协议的子图 |
subgraph-registry |
subgraph-registry.md | 按协议/链搜索14,733+个子图 |
|
Aave借贷数据 | graph-aave-mcp |
aave.md | 40个工具——V2/V3/V4、清算、利率 |
|
Polymarket预测市场 | graph-polymarket-mcp |
polymarket.md | 31个工具——价格、盈亏、未平仓合约 |
|
x402支付分析 | x402-analytics |
x402.md | Base上的支付量、促进者、每日统计 |
|
原始区块数据、流式处理 | substreams | — | 追踪、日志、自定义转换 |
|
代理发现（ERC-8004） | 8004scan | — | 按能力查找AI代理 |
|
MCP服务器认证 | mcp8004 | — | ERC-8004身份验证 |
|
跨协议借贷 | graph-lending-mcp | — | 比较Aave/Compound/Morpho利率 |
|
无限预测市场 | graph-limitless-mcp | — | Base上的市场 |
如果请求跨越两个服务，则同时使用并合并结果。
快速示例
以太坊上前10名USDC持有者 → token-api
Arbitrum上Uniswap V3的最佳子图？ → subgraph-registry
超过5万美元的Aave V3清算 → graph-aave-mcp
今天Base上的x402支付量 → x402-analytics
查找从事交易的代理 → 8004scan
工作原理
- 1. 代理发送通俗英语问题
- Graph Advocate识别最佳服务
- 搜索子图注册表（14,733个子图，带查询提示）
- 执行查询并在响应中返回实时数据
- 包含get_started链接，供代理获取自己的免费API密钥
响应格式
json
{
recommendation: subgraph-registry,
reason: 为什么此服务适合,
confidence: high,
query_ready: { tool: ..., args: {...} },
execution_result: { source: subgraph-gateway, data: {...} },
get_started: 免费API密钥：https://thegraph.com/studio/,
cacheforseconds: 86400
}
端点
| 方法 | URL | 用途 |
|---|
| POST | https://graph-advocate-production.up.railway.app/ | A2A JSON-RPC 2.0 |
| POST |
https://graph-advocate-production.up.railway.app/chat | 简单HTTP聊天 |
| GET | https://graph-advocate-production.up.railway.app/.well-known/agent-card.json | 代理卡片 |
| GET | https://graph-advocate-production.up.railway.app/dashboard | 实时监控 |
| POST | https://graph-advocate-production.up.railway.app/feedback | 代理反馈 |
x402支付
每个发送方每天10次免费查询。之后，Base上每次查询0.01 USDC。
支付发送到Ampersend智能账户。拥有x402钱包的代理自动支付。
外部端点
| 端点 | 发送的数据 | 用途 |
|---|
| graph-advocate-production.up.railway.app | 您的通俗英语查询 | 路由到正确的Graph服务 |
| gateway.thegraph.com/api/ |
GraphQL查询 | 执行子图查询以获取实时数据 |
| token-api.thegraph.com/ | REST请求 | 获取代币/NFT/交换数据 |
| api.studio.thegraph.com | GraphQL查询 | x402支付分析 |
安全与隐私
- - 仅指令技能——不会在您的机器上下载或执行任何代码
- 无需凭证——Graph Advocate不需要您的API密钥
- 无本地文件访问——不读取您的文件系统中的任何内容
- 无状态——请求之间不持久化任何会话数据
身份
信任声明
使用此技能，您的通俗英语数据查询将发送到graph-advocate-production.up.railway.app（托管在Railway上，由@paulieb14运营）。该服务返回包含实时数据的结构化JSON。仅当您信任此端点处理您的查询文本时才安装。
链接
- - GitHub：https://github.com/PaulieB14/graph-advocate
- The Graph：https://thegraph.com
- 子图工作室：https://thegraph.com/studio
