Agent skill

Thegraph MCP Skill

Use The Graph Subgraph MCP through UXC via native SSE with a fixed linked command for subgraph discovery, schema retrieval, deployment selection, and GraphQL query execution with help-first…

MITAuto-check passedBackend & APIs

Install Thegraph MCP Skill

skills CLI

$ npx skills add holon-run/uxc --skill thegraph-mcp-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install holon-run/uxc thegraph-mcp-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/holon-run/uxc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/thegraph-mcp-skill .claude/skills/thegraph-mcp-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "thegraph-mcp-skill" agent skill from https://github.com/holon-run/uxc/tree/main/skills/thegraph-mcp-skill into .claude/skills/thegraph-mcp-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thegraph-mcp-skill", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/holon-run/uxc/tree/main/skills/thegraph-mcp-skill

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add holon-run/uxc --skill thegraph-mcp-skill -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install holon-run/uxc thegraph-mcp-skill --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/holon-run/uxc.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/thegraph-mcp-skill .agents/skills/thegraph-mcp-skill && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "thegraph-mcp-skill" agent skill from https://github.com/holon-run/uxc/tree/main/skills/thegraph-mcp-skill into .agents/skills/thegraph-mcp-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thegraph-mcp-skill", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add holon-run/uxc --skill thegraph-mcp-skill -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install holon-run/uxc thegraph-mcp-skill --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/holon-run/uxc.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/thegraph-mcp-skill .cursor/skills/thegraph-mcp-skill && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "thegraph-mcp-skill" agent skill from https://github.com/holon-run/uxc/tree/main/skills/thegraph-mcp-skill into .cursor/skills/thegraph-mcp-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thegraph-mcp-skill", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/holon-run/uxc.git --path skills/thegraph-mcp-skill

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add holon-run/uxc --skill thegraph-mcp-skill -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install holon-run/uxc thegraph-mcp-skill --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/holon-run/uxc.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/thegraph-mcp-skill .gemini/skills/thegraph-mcp-skill && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "thegraph-mcp-skill" agent skill from https://github.com/holon-run/uxc/tree/main/skills/thegraph-mcp-skill into .gemini/skills/thegraph-mcp-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thegraph-mcp-skill", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install holon-run/uxc thegraph-mcp-skill

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add holon-run/uxc --skill thegraph-mcp-skill -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/holon-run/uxc.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/thegraph-mcp-skill .github/skills/thegraph-mcp-skill && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "thegraph-mcp-skill" agent skill from https://github.com/holon-run/uxc/tree/main/skills/thegraph-mcp-skill into .github/skills/thegraph-mcp-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thegraph-mcp-skill", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add holon-run/uxc --skill thegraph-mcp-skill -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install holon-run/uxc thegraph-mcp-skill --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/holon-run/uxc.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/thegraph-mcp-skill .opencode/skills/thegraph-mcp-skill && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "thegraph-mcp-skill" agent skill from https://github.com/holon-run/uxc/tree/main/skills/thegraph-mcp-skill into .opencode/skills/thegraph-mcp-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "thegraph-mcp-skill", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: thegraph-mcp-skill
GitHub stars: 116
Token cost: ~1.1k tokens
SKILL.md length: 456 words
Files: 4 (incl. scripts, references)
Skills in repo: 62
Repo updated: Sep 15, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Use The Graph Subgraph MCP through UXC via native SSE with a fixed linked command for subgraph discovery, schema retrieval, deployment selection, and GraphQL query execution with help-first…

Works in 5 steps: Verify protocol/path from official… → Detect auth requirement explicitly → Register credential and use fixed link… → …
Tasks that involve GraphQL
SKILL.md covers Prerequisites, Core Workflow (The…, Capability Map and Guardrails, plus 2 more sections
Runs Shell scripts from its folder; reaches subgraphs.mcp.thegraph.com and thegraph.com; needs THEGRAPH_API_KEY

What it does

Thegraph MCP Skill is an agent skill from holon-run/uxc. Use The Graph Subgraph MCP through UXC via native SSE with a fixed linked command for subgraph discovery, schema retrieval, deployment selection, and GraphQL query execution with help-first inspection and explicit auth handling.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml`, `references/usage-patterns.md` and `scripts/validate.sh`).

It sits in Backend & APIs, covering GraphQL, MCP servers and Deployment. It works with Model Context Protocol and GraphQL. The repository describes itself as: A unified CLI for discovering and invoking tools across OpenAPI, MCP, GraphQL, gRPC, and JSON-RPC. The licence is MIT.

When your agent uses it

Tasks that involve GraphQL
Tasks that involve MCP servers
Tasks that involve Deployment

Example prompts

“/thegraph-mcp-skill”

Requirements

A Bash shell
A credential in THEGRAPH_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

Verify protocol/path from official source and probe
Detect auth requirement explicitly
Register credential and use fixed link command by default
Inspect operation schema before execution
Prefer discovery/schema operations first

What it can do on your machine

Read from SKILL.md and the folder at commit 562d47c. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (Shell), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- subgraphs.mcp.thegraph.com
- thegraph.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- THEGRAPH_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Thegraph MCP Skill loads about 1.1k tokens when it runs, and up to ~1.7k if it reads all its reference files. Until then it costs about 62 tokens; SKILL.md has 456 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~62
When it runs · the whole SKILL.md, loaded when a task matches: ~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from holon-run/uxc at commit 562d47c, republished under its MIT licence (© holon-run). 456 words, ~1,069 tokens.

Download SKILL.mdSave it as .claude/skills/thegraph-mcp-skill/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.

name: thegraph-mcp-skill
description: Use The Graph Subgraph MCP through UXC via native SSE with a fixed linked command for subgraph discovery, schema retrieval, deployment selection, and GraphQL query execution with help-first inspection and explicit auth handling.

The Graph MCP Skill

Use this skill to run The Graph Subgraph MCP operations through uxc using the native SSE MCP endpoint.

Reuse the uxc skill for generic protocol discovery, envelope parsing, and error handling rules.

Prerequisites

uxc is installed and available in PATH.
Network access to https://subgraphs.mcp.thegraph.com/sse.
The Graph Gateway API key is available for authenticated calls.

Core Workflow (The Graph-Specific)

Endpoint candidate inputs before finalizing:

Official remote MCP endpoint:
- https://subgraphs.mcp.thegraph.com/sse

Verify protocol/path from official source and probe:
- Official source: https://thegraph.com/docs/en/ai-suite/subgraph-mcp/introduction/
- probe candidate endpoint with:
  - uxc https://subgraphs.mcp.thegraph.com/sse -h
- Confirm protocol is MCP (protocol == "mcp" in envelope).
Detect auth requirement explicitly:
- Run host help or a minimal read call and inspect envelope.
- This endpoint requires a The Graph Gateway API key sent as Authorization: Bearer <key>.
Register credential and use fixed link command by default:
- uxc auth credential set thegraph --secret-env THEGRAPH_API_KEY
- uxc auth binding add --id thegraph-sse --host subgraphs.mcp.thegraph.com --path-prefix /sse --scheme https --credential thegraph --priority 100
- command -v thegraph-mcp-cli
- If missing, create it:
  - uxc link thegraph-mcp-cli https://subgraphs.mcp.thegraph.com/sse
- thegraph-mcp-cli -h
- If command conflict is detected and cannot be safely reused, stop and ask skill maintainers to pick another fixed command name.
Inspect operation schema before execution:
- thegraph-mcp-cli -h
- thegraph-mcp-cli <operation> -h
Prefer discovery/schema operations first:
- find candidate subgraphs or deployments
- inspect schema
- execute query only after identifier and schema are understood

Capability Map

Discovery:
- search subgraphs by keyword
- find top deployments for a contract
- inspect deployment popularity / 30-day query volume
Schema:
- get schema by deployment ID
- get schema by subgraph ID
- get schema by IPFS hash
Query execution:
- execute GraphQL query by deployment ID
- execute GraphQL query by subgraph ID
- execute GraphQL query by IPFS hash

Show full SKILL.md (174 more words)Show less

Guardrails

Keep automation on JSON output envelope; do not rely on --text.
Parse stable fields first: ok, kind, protocol, data, error.
Use thegraph-mcp-cli as default command path.
thegraph-mcp-cli <operation> ... is equivalent to uxc https://subgraphs.mcp.thegraph.com/sse <operation> ... when the same auth binding is configured.
Use direct uxc "<endpoint>" ... only as temporary fallback when link setup is unavailable.
Prefer discovery and schema inspection before query execution.
For production/stable workflows, prefer deployment-oriented selection over loosely changing latest-version references.
Keep GraphQL query scope small on first pass:
- add filters
- add limits
- fetch only required fields
If auth fails:
- confirm uxc auth credential info thegraph succeeds
- confirm uxc auth binding match https://subgraphs.mcp.thegraph.com/sse resolves to thegraph
- rerun thegraph-mcp-cli -h

Tested Real Scenario

The following flow was exercised successfully through uxc against the live endpoint:

search uniswap subgraphs
compare candidates with get_deployment_30day_query_counts
select the highest-volume candidate
fetch schema for the chosen subgraph
execute a minimal _meta GraphQL query

The selected candidate in that run was:

subgraph ID: 5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV
deployment IPFS hash: QmTZ8ejXJxRo7vDBS4uwqBeGoxLSWbhaA7oXa1RvxunLy7

The minimal verified query shape was:

graphql

{
  _meta {
    deployment
    hasIndexingErrors
  }
}

References

Invocation patterns:
- references/usage-patterns.md

Files

SKILL.md and 3 other files (scripts, references) in skills/thegraph-mcp-skill of holon-run/uxc.

SKILL.md
agents/openai.yaml
references/usage-patterns.md
scripts/validate.sh

Open the folder on GitHubat commit 562d47c

Compare with similar skills

Thegraph MCP Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Thegraph MCP Skill compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Thegraph MCP Skill this skillholon-run/uxc	116	—	~1.1k	Automated safety check: Pass	MIT	25 days ago
SpikardGoldziher/spikard	123	—	~799	Automated safety check: Pass	MIT	6 days ago
QA Find Bugs MCPbex-co/beancount-io	296	—	~3k	Automated safety check: Pass	MIT	today
Shopifyasgeirtj/system_prompts_leaks	69k	—	~2k	Automated safety check: Pass	CC0-1.0	2 days ago
MondayLeoYeAI/openclaw-master-skills	2.2k	—	~4.3k	Automated safety check: Pass	MIT	2 mo ago
Shopify AI Toolkit Wrapperjeremylongshore/tons-of-skills-marketplace	2.8k	—	~1.5k	Automated safety check: Pass	MIT	yesterday

Similar skills

Spikard
Goldziher/spikard
Scaffold Spikard projects and generate code from OpenAPI, AsyncAPI, OpenRPC, GraphQL, and Protobuf schemas using the Spikard CLI or its MCP server.
123 GitHub stars~799 tokensUpdated 6 days ago
Backend & APIsAuto-check passed
QA Find Bugs MCP
bex-co/beancount-io
Hunt bugs in the Beancount.io remote MCP server by driving the real POST /api-gateway/mcp endpoint with JSON-RPC and real MCP clients, checking transport, discovery, credential boundaries, tool and…
296 GitHub stars~3k tokensUpdated today
Backend & APIsAuto-check passed
Shopify
asgeirtj/system_prompts_leaks
Set up and operate a Shopify store with Shopify's official MCP server (the installed shopify command, NOT the npm Shopify CLI).
69k GitHub stars~2k tokensUpdated 2 days ago
Backend & APIsAuto-check passed
Monday
LeoYeAI/openclaw-master-skills
Manage monday.com boards, items, columns, groups, updates, and workflows via MCP server (preferred) and GraphQL API (fallback).
2.2k GitHub stars~4.3k tokensUpdated 2 mo ago
Backend & APIsAuto-check passed
Shopify AI Toolkit Wrapper
jeremylongshore/tons-of-skills-marketplace
Integrate Shopify's AI Toolkit MCP server with Claude Code for GraphQL validation, Liquid linting, and documentation search.
2.8k GitHub stars~1.5k tokensUpdated yesterday
Backend & APIsAuto-check passed
Build Error Adapter
ArcadeAI/arcade-mcp
Build new Arcade error adapters from scratch using public Arcade TDK patterns.
1k GitHub stars~2k tokensUpdated yesterday
Agent WorkflowsAuto-check passed

Questions about Thegraph MCP Skill

What does Thegraph MCP Skill do?

Use The Graph Subgraph MCP through UXC via native SSE with a fixed linked command for subgraph discovery, schema retrieval, deployment selection, and GraphQL query execution with help-first…. Thegraph MCP Skill is an agent skill from holon-run/uxc. Use The Graph Subgraph MCP through UXC via native SSE with a fixed linked command for subgraph discovery, schema retrieval, deployment selection, and GraphQL query execution with help-first inspection and explicit auth handling.

When should I use Thegraph MCP Skill?

Thegraph MCP Skill fits situations like: tasks that involve GraphQL; tasks that involve MCP servers; tasks that involve Deployment.

How do I install Thegraph MCP Skill in Claude Code?

Run `npx skills add holon-run/uxc --skill thegraph-mcp-skill -a claude-code`. Or copy the skill folder (skills/thegraph-mcp-skill in holon-run/uxc) into .claude/skills/thegraph-mcp-skill in your project. Claude Code loads it when a task matches its description.

How do I install Thegraph MCP Skill in Codex?

Run `npx skills add holon-run/uxc --skill thegraph-mcp-skill -a codex`. Or copy the skill folder (skills/thegraph-mcp-skill in holon-run/uxc) into .agents/skills/thegraph-mcp-skill in your project. Codex loads it when a task matches its description.

Can I use Thegraph MCP Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add holon-run/uxc --skill thegraph-mcp-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/thegraph-mcp-skill, .gemini/skills/thegraph-mcp-skill, .github/skills/thegraph-mcp-skill and .opencode/skills/thegraph-mcp-skill in your project.

What does Thegraph MCP Skill need to run?

Going by SKILL.md and its folder, Thegraph MCP Skill needs a shell for the scripts in its folder and credentials named THEGRAPH_API_KEY. Our summary lists: A Bash shell; A credential in THEGRAPH_API_KEY.

Does Thegraph MCP Skill access the network?

SKILL.md names 2 domains. In commands or code: subgraphs.mcp.thegraph.com and thegraph.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Thegraph MCP Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Thegraph MCP Skill use?

Thegraph MCP Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Thegraph MCP Skill use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 674 tokens, read only when the agent opens those files.

What are the alternatives to Thegraph MCP Skill?

Skills that share tags, products or a category with Thegraph MCP Skill: Spikard (Goldziher/spikard, 123 stars), QA Find Bugs MCP (bex-co/beancount-io, 296 stars), Shopify (asgeirtj/system_prompts_leaks, 69k stars) and Monday (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Thegraph MCP Skill?

holon-run (a GitHub organization) maintains it in holon-run/uxc, which has 116 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on September 15, 2026.

Source: holon-run/uxc on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Thegraph MCP Skill

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

The Graph MCP Skill

Prerequisites

Core Workflow (The Graph-Specific)

Capability Map

Guardrails

Tested Real Scenario

References

Files

Compare with similar skills

Similar skills

More from holon-run/uxc

Related

Questions about Thegraph MCP Skill