Graph Advocate

Route any onchain data request to the right Graph Protocol service. Given plain-English, returns a ready-to-execute tool call for Token API, Subgraph Registr...

Security Scan

The skill is an instruction-only router that recommends The Graph services and ready-to-run query arguments; its declared requirements and instructions are coherent with that purpose.

Purpose & Capability

The name/description (routing onchain requests to The Graph's Token API, Subgraph Registry, Substreams, or MCP packages) matches the SKILL.md content. It does not request unrelated credentials, binaries, or config paths.

Instruction Scope

SKILL.md only prescribes returning structured JSON recommendations and example formats. It does not instruct the agent to read files, access environment variables, call external endpoints beyond citing public docs, or execute shell commands.

Install Mechanism

No install spec or code files are present (instruction-only). Nothing will be downloaded or written to disk by the skill itself.

Credentials

The skill declares no required environment variables or credentials (proportionate). Note: its recommendations may include third-party MCP package names or ready-to-run tool calls; actually running or installing those packages may later require credentials or additional permissions not covered by this skill.

Persistence & Privilege

always is false and it doesn't request persistent system presence or modify other skills. Autonomous invocation is permitted by platform defaults but the skill itself does not perform actions beyond returning recommendations.

Assessment

This skill is instruction-only and appears to only generate JSON recommendations for The Graph services — low intrinsic risk. Before you act on its output: review any generated tool calls and package install instructions manually, verify MCP package sources (e.g., official GitHub repos or The Graph ecosystem), and avoid automatically executing suggested commands or installing packages without checking for required credentials and trusted origins. If you plan to let an agent autonomously run the recommended queries or installs, ensure the agent has only the minimal permissions and credentials needed and that you trust the external packages it will fetch.

Graph Advocate is a routing agent for The Graph Protocol. Given a plain-English onchain data request, it returns structured JSON identifying the right service, the reason, and the exact tool call to run.

What it covers

• 📊 Token API — wallet balances, swaps, NFT sales, holder rankings across EVM (Ethereum, Base, Polygon, Arbitrum), Solana, and TON
• 🔍 Subgraph Registry — 15,500+ indexed protocol subgraphs (Uniswap, Aave, ENS, Compound, Curve, Balancer and more)
• ⚡ Substreams — raw block data, event logs, real-time streaming
• 🧩 Protocol MCP packages — Aave, Polymarket, lending protocols, Predict.fun

Response format

Graph Advocate returns structured JSON with a recommendation, confidence score, and ready-to-run query arguments:

{
  "recommendation": "token-api",
  "reason": "getV1EvmHolders returns ranked holder lists by token contract.",
  "confidence": "high",
  "query_ready": {
    "tool": "getV1EvmHolders",
    "args": {
      "network_id": "mainnet",
      "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "limit": 20
    }
  },
  "alternatives": []
}

Example requests

• "Top 20 USDC holders on Ethereum"
• "Uniswap V3 pool TVL and fee tiers"
• "Aave liquidation events last 7 days"
• "Solana NFT sales this week"
• "Raw event logs blocks 19000000 to 20000000"
• "Which package should I use for Polymarket data?"

Protocol MCP packages

When Graph Advocate recommends a protocol package, it returns the package name and install instructions:

Package	Protocol
graph-aave-mcp	Aave V2/V3 — 7 chains, 11 subgraphs
graph-polymarket-mcp	Polymarket prediction markets
graph-lending-mcp	Cross-protocol lending (Messari standard)
predictfun-mcp	Predict.fun on BNB Chain
subgraph-registry-mcp	15,500+ classified subgraphs
substreams-search-mcp	Substreams package browser

Links

• GitHub: https://github.com/PaulieB14/graph-advocate
• The Graph Protocol: https://thegraph.com
• The Graph Docs: https://thegraph.com/docs
• Token API: https://thegraph.com/docs/en/token-api
• Subgraph Studio: https://thegraph.com/studio