# Analyze Web3 GraphQL Endpoints

Blockchain teams need fast answers from SubQuery and SubGraph endpoints. This skill routes natural-language questions through Ask GraphQL MCP for endpoint-aware analysis.

## Install

```bash
npx skillstore add sn-hermes/ask-graphql-mcp
```

## Metadata

- Status: approved
- Slug: sn-hermes-ask-graphql-mcp
- Skillstore revision: r1
- Version status: missing
- Tree hash: e2cd442c867d76541dccb0c3ddda13e81ce0ee299f773581fa6735d6ae33d48b
- Author: SN-Hermes
- GitHub username: SN-Hermes
- License: MIT
- Repository: https://github.com/SN-Hermes/hermes-skills/tree/main/skills/ask-graphql-mcp/
- Ref: f93e9bb0daca99badb6a7e574b97737155d57cb3
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, env\_access, external\_commands
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/sn-hermes-ask-graphql-mcp
- Manifest: https://skillstore.pages.dev/api/skills/sn-hermes-ask-graphql-mcp/manifest

## Capabilities

- Routes Web3 and on-chain questions to graphql\_agent through a session tool or HTTP JSON-RPC.
- Uses the free Ask MCP gateway by default and paid mode after quota limits or user request.
- Supports user-provided GraphQL endpoints with optional upstream authorization headers.
- Provides setup templates for free and paid MCP configurations.
- Offers prompt patterns for endpoint inspection, analytics, and query debugging.
- Handles rate-limit responses with API key setup guidance.

## Use Cases

- Analyze protocol activity: Ask for on-chain metrics, active accounts, volume trends, or staking activity from a supported GraphQL endpoint.
- Debug endpoint queries: Diagnose GraphQL errors, missing fields, schema mismatches, and pagination issues with MCP-assisted reasoning.
- Configure MCP access: Create free or paid Ask MCP connection guidance for a user-provided SubQuery or SubGraph endpoint.

## Prompt Templates

### Connect to an endpoint

```
Use Ask GraphQL MCP with this endpoint: <endpoint>. Confirm connectivity and summarize what data it indexes.
```

### Inspect available data

```
Inspect this endpoint with Ask GraphQL MCP and describe the main entities, useful metrics, and any schema assumptions.
```

### Debug a failing query

```
Use Ask GraphQL MCP to explain this query error and suggest a compatible query shape for the endpoint schema.
```

### Design dashboard metrics

```
Use Ask GraphQL MCP to propose three dashboard metrics for this protocol and explain the endpoint fields needed for each metric.
```

## Limitations

- Requires a reachable GraphQL endpoint before execution.
- Sends endpoint details and user tasks to the external Ask MCP gateway.
- Paid mode requires a user-provided Ask MCP API key and available provider quota.
- Does not run direct GraphQL queries unless the user requests an MCP bypass.

## Best Practices

- Use public endpoints or narrowly scoped endpoint tokens whenever possible.
- Start in free mode and switch to paid mode only after quota limits or explicit user request.
- Remove or redact secrets before sharing logs, errors, or configuration snippets.

## Anti Patterns

- Do not use broad production credentials for endpoint authorization.
- Do not use this skill for non-Web3 questions or general database work.
- Do not bypass Ask MCP with direct GraphQL execution unless the user requests it.

## Security Audit

- Audited at: 2026-07-07T06:06:03.134\+00:00
- Summary: Most static command-execution and system-reconnaissance alerts are Markdown false positives. The skill still routes data to an external MCP gateway and includes instructions that can expose API keys or private endpoint authorization headers. No prompt injection attempt was found in the reviewed files.

## Stats

- Views: 84
- Downloads: 9
- Favorites: 0
- Popularity score: 0