← Back to Skills Marketplace
paulieb14

Graph Advocate

by PaulieB14 · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ⚠ suspicious
327
Downloads
1
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install graph-advocate
Description
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...
README (SKILL.md)

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

  1. Agent sends plain-English question
  2. Graph Advocate identifies the best service
  3. Searches the subgraph registry (14,733 subgraphs with query hints)
  4. Executes the query and returns live data in the response
  5. Includes get_started link 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

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

Usage Guidance
This skill is an instruction-only router that sends your query text to a third-party endpoint (graph-advocate-production.up.railway.app) which then queries The Graph, token API, and x402 subgraphs. Before installing: (1) Understand privacy risk — any sensitive data in queries will be transmitted to that external server; ask the maintainer or inspect the GitHub repo to confirm logging/retention and whether queries are stored. (2) Expect potential costs — x402 mentions a paid tier after free queries; confirm how billing is charged and whether any wallet approvals are required. (3) Clarify credential expectations — the SKILL.md claims no credentials required but several references show GRAPH_API_KEY / token-api auth; verify whether the hosted service uses its own keys or will ask you to provide keys. (4) Note minor inconsistencies (version/subgraph counts) — not inherently malicious but a sign the package may be stale or poorly maintained. (5) If you need stronger assurance, review the service source code on the linked GitHub, confirm the Railway deployment owner, or run only non-sensitive queries until policies and code are verified.
Capability Analysis
Type: OpenClaw Skill Name: graph-advocate Version: 2.0.0 The graph-advocate skill serves as a routing agent for blockchain data queries, directing requests to various Graph Protocol services and MCP tools. It operates by sending user queries to a remote endpoint (graph-advocate-production.up.railway.app) and provides clear documentation for integrating specialized tools like Aave and Polymarket. The skill discloses its use of the x402 protocol for automated query payments on the Base network and does not attempt to access local files, environment variables, or execute unauthorized code. The instructions in SKILL.md are focused on intent-based routing and do not contain malicious prompt injections.
Capability Tags
cryptorequires-walletcan-make-purchases
Capability Assessment
⚠ Purpose & Capability
The skill's stated purpose (routing blockchain queries to The Graph / token API / x402) aligns with the endpoints listed, but there are internal inconsistencies: SKILL.md and skill.json report different versions and different subgraph counts (14,733 vs 15,500+). Several referenced tools and example installs (Aave/Polymarket/Subgraph registry) explicitly mention needing GRAPH_API_KEY or other auth, yet the top-level SKILL.md claims "No credentials required." That mismatch is unexplained and could confuse users about what credentials they must supply or what the hosted endpoint does with its own credentials.
⚠ Instruction Scope
The runtime instructions direct the agent to send the user's plain-English query to an external HTTP endpoint (graph-advocate-production.up.railway.app) which will forward/execute queries against multiple services. That behavior is consistent with the purpose, but it means arbitrary user queries (which may contain sensitive data) will be transmitted off-platform to a third-party server. The SKILL.md asserts "no local file access" and "stateless," but those are provider claims — there is no local code to verify storage, logging, or retention policies. The references also describe endpoints that sometimes require API keys (token-api, gateway.thegraph), so the skill may be using provider-owned credentials to execute queries or could prompt for keys later; this is not clearly documented.
✓ Install Mechanism
Instruction-only skill with no install spec and no code files to run locally. That lowers risk from arbitrary downloads or disk writes. The included reference files contain example npx commands for optional MCP tooling, but those are separate and would be executed only if the agent/user chooses to install them.
⚠ Credentials
Declared requirements list no env vars or credentials, but multiple reference files and install examples explicitly mention GRAPH_API_KEY and token-api auth (JWT / X-Api-Key). The skill's header claims "No credentials required," which contradicts the references. This raises two concerns: (1) the hosted endpoint may be using its own keys to fulfill requests (fine but should be documented), or (2) parts of the toolset require users to provide keys if run locally. The mismatch should be clarified before trusting the skill with production or sensitive queries.
✓ Persistence & Privilege
The skill is not always-enabled and does not request persistent privileges. It is user-invocable and can be called autonomously (the platform default). There is no install-time modification of other skills or system settings in the available files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install graph-advocate
  3. After installation, invoke the skill by name or use /graph-advocate
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
Route-first design with reference files, live data execution, x402 analytics, Ampersend integration, 14733 subgraphs with query hints
v1.3.0
**Graph Advocate 1.3.0 – Expanded coverage, new privacy details** - Expanded description: Instantly answer any blockchain question in plain English, covering token/NFT/DeFi/prediction market data over 15,500+ subgraphs and 20+ blockchains. - New "External Endpoints" and "Security & Privacy" sections clarify what data is sent, endpoint usage, and how privacy is maintained. - Clearer response example and updated use-case examples. - Consolidated and expanded package/service tables, highlighting supported MCP packages and capabilities. - Explicit trust statement and invocation notes added for transparency and user assurance.
v1.2.0
Remove npx commands and external endpoint instructions to resolve security scanner flags
v1.1.0
Remove shell commands, description-only format
v1.0.0
Initial release
Metadata
Slug graph-advocate
Version 2.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 5
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 327 downloads so far.

How do I install Graph Advocate?

Run "/install graph-advocate" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Graph Advocate free?

Yes, Graph Advocate is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Graph Advocate support?

Graph Advocate is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Graph Advocate?

It is built and maintained by PaulieB14 (@paulieb14); the current version is v2.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments