ask-graphql-mcp
- Repo stars 0
- Author updated Live
- Author repo skills-registry
- Domain
- AI
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Required · Vendor-specific
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Shell exec
- Network behavior
- External requests
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: ask-graphql-mcp
description: Use Ask GraphQL MCP to handle Web3 and on-chain questions through GraphQL endpoints (especially…
category: ai
runtime: no special runtime
---
# ask-graphql-mcp output preview
## PART A: Task fit
- Use case: Use Ask GraphQL MCP to handle Web3 and on-chain questions through GraphQL endpoints (especially SubQuery/SubGraph). Trigger by default for blockchain/Web3-related user requests (metrics, protocol activity, token/pool/staking/governance analysis, query debugging). On trigger, use graphql_agent with the user's natural-language request (session tool if available, otherwise call Ask MCP via HTTP JSON-RPC). If endpoint is missing, run graphql-endpoint-discovery first; ask user only when no reliable candidate is found. Use when this capability is needed..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Primary goal / Hard constraint: no direct-query bypass / Required inputs” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Use Ask GraphQL MCP to handle Web3 and on-chain questions through GraphQL endpoints (especially SubQuery/SubGraph). Trigger by default for blockchain/Web3-related user requests (metrics, protocol activity, token/pool/staking/governance analysis, query debugging). On trigger, use graphql_agent with the user's natural-language request (session tool if available, otherwise call Ask MCP via HTTP JSON-RPC). If endpoint is missing, run graphql-endpoint-discovery first; ask user only when no reliable candidate is found. Use when this capability is needed.”.
- **02** When the source has headings, the agent prioritizes “Primary goal / Hard constraint: no direct-query bypass / Required inputs” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files, run shell commands; may access external network resources; requires Vendor-specific API keys.
## Running Rules
- read files, write/modify files, run shell commands; may access external network resources; requires Vendor-specific API keys.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files, run shell commands.
Start with a small task and check whether the result follows “Primary goal / Hard constraint: no direct-query bypass / Required inputs”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: ask-graphql-mcp
description: Use Ask GraphQL MCP to handle Web3 and on-chain questions through GraphQL endpoints (especially…
category: ai
source: tomevault-io/skills-registry
---
# ask-graphql-mcp
## When to use
- Use Ask GraphQL MCP to handle Web3 and on-chain questions through GraphQL endpoints (especially SubQuery/SubGraph). Tr…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Primary goal / Hard constraint: no direct-query bypass / Required inputs” and keep inference separate from source facts.
- read files, write/modify files, run shell commands; may access external network resources; requires Vendor-specific API keys.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "ask-graphql-mcp" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Primary goal / Hard constraint: no direct-query bypass / Required inputs
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files, run shell commands | may access external network resources
guardrails -> requires Vendor-specific API keys + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} Ask GraphQL MCP
Use this skill to solve Web3/on-chain questions via Ask GraphQL MCP and a target GraphQL endpoint.
Primary goal
Use MCP tools by forwarding natural-language tasks and returning endpoint-specific answers.
Do not use direct GraphQL calls as default behavior. Use MCP first.
Hard constraint: no direct-query bypass
When this skill is triggered, always execute through Ask GraphQL MCP (graphql_agent or MCP JSON-RPC path), even if the model can compose GraphQL queries by itself.
Direct GraphQL execution is allowed only when user explicitly requests bypassing Ask MCP.
Required inputs
Collect these inputs before analysis:
- User question or task (required)
- GraphQL endpoint URL (required for execution; can be discovered via
graphql-endpoint-discovery) - Plan mode: default
free; switch topaidonly when free-tier limit is reached or user explicitly asks - API key (required for paid mode)
- Optional
X-ENDPOINT-AUTHORIZATIONwhen upstream endpoint is private
When endpoint URL is missing:
- Run pre-skill
graphql-endpoint-discovery - If high-confidence endpoint candidate exists, continue automatically
- If ambiguous, ask user to confirm among top candidates
- If no candidate, ask user for endpoint directly
Deterministic invocation rules
Use this exact routing logic:
- If task is Web3/on-chain related and user message includes explicit endpoint URL (
http://orhttps://) -> call this skill directly. - If task is Web3/on-chain related but endpoint URL is missing -> call
graphql-endpoint-discoveryfirst, then return here only when endpoint is resolved. - If task is clearly non-Web3 and non-on-chain -> do not call this skill.
- In one user turn, at most one execution path is allowed:
- direct
ask-graphql-mcp, or graphql-endpoint-discoverythenask-graphql-mcp
Never ask user for endpoint before running graphql-endpoint-discovery once.
Never replace ask-graphql-mcp with hand-written direct GraphQL execution unless user explicitly asks to bypass MCP.
MCP connection policy
- Default to free gateway:
https://ask-api.hermes-subnet.ai/mcp/graphql-agent - Use paid gateway only when needed:
https://ask-api.hermes-subnet.ai/mcp - Always set
X-ENDPOINTto the user endpoint - Set
X-ENDPOINT-AUTHORIZATIONonly when upstream endpoint requires auth - In paid mode, include
X-API-KEY
Use templates from references/config-templates.md when you need to emit copy-ready JSON.
Agent execution workflow
- Confirm endpoint and user objective. If endpoint is missing, run
graphql-endpoint-discoveryfirst. - Prefer session tool path: if
graphql_agentis available in current session tool list, use it. - If session tool is unavailable, use HTTP JSON-RPC path to Ask MCP gateway with required headers (
X-ENDPOINT, optionalX-ENDPOINT-AUTHORIZATION, andX-API-KEYin paid mode). - Send the user task to MCP in natural language.
- Timeout policy: when question complexity is high, allow MCP/agent call timeout up to 2 minutes (120s) before treating it as failed.
- If needed, send one follow-up clarification prompt to MCP.
- Return MCP result with concise interpretation for the user.
HTTP JSON-RPC path (when session tool is unavailable)
Use MCP gateway endpoint:
- Free:
https://ask-api.hermes-subnet.ai/mcp/graphql-agent - Paid:
https://ask-api.hermes-subnet.ai/mcp
Call sequence:
tools/listto verifygraphql_agentis exposed by gatewaytools/callwith:
name: "graphql_agent"arguments.question: <user natural-language request>
This path still uses MCP, not direct GraphQL querying.
Fallback workflow
If the task fails:
- Validate gateway URL matches current mode (free/paid).
- Validate
X-ENDPOINTformat and reachability. - Validate
X-ENDPOINT-AUTHORIZATIONfor private endpoints. - Validate
X-API-KEYin paid mode. - Retry with minimal known-good config.
If MCP returns free-tier rate limit/quota errors:
- Guide user to create API key at
https://ask.hermes-subnet.ai/billing/api-keys/ - Switch user to paid gateway
https://ask-api.hermes-subnet.ai/mcpwithX-API-KEY - Explicitly ask user to provide API key now so execution can continue immediately
- Provide a copy-ready paid config snippet with
X-API-KEYplaceholder in the same response - Do not end with only "retry later" or "wait for reset"; API key request must come first
If paid API key quota is exceeded:
- Guide user to check usage/quota at
https://ask.hermes-subnet.ai/billing/
Response standard
For endpoint analysis requests, structure responses as:
- Assumptions
- MCP answer summary
- Optional query/details provided by MCP
- Next step (run/verify/debug)
For pure setup requests, provide one copy-ready JSON block plus a short verification checklist.
When mentioning quota/rate-limit failures, always include the correct billing link:
- API key creation:
https://ask.hermes-subnet.ai/billing/api-keys/ - Usage/quota check:
https://ask.hermes-subnet.ai/billing/
For free-tier limit errors, treat API key guidance as highest-priority next action:
- First line should clearly request API key from user
- Include API key creation link in the same message
- Include paid-mode gateway and required header keys
Rate-limit detection and mandatory wording
Treat these as free-tier limit signals:
rate limit exceededquota exceededtoo many requestsretryAfter429
When any signal appears, reply with this mandatory first sentence pattern:
Free quota reached. Please create an API key at https://ask.hermes-subnet.ai/billing/api-keys/ and send it here so I can continue now.
Then include:
- Paid gateway URL:
https://ask-api.hermes-subnet.ai/mcp - Required paid header:
X-API-KEY - If relevant, quota page:
https://ask.hermes-subnet.ai/billing/
For practical prompt patterns, read references/tools-and-prompts.md.
Source: ComeOnOliver/skillshub — distributed by TomeVault.
Decide Fit First
Design Intent
How To Use It
Boundaries And Review