Agent skill

Thegraph Token MCP Skill

by holon-run in holon-run/uxc

Use The Graph Token API MCP through UXC for token metadata, wallet balances, transfers, holders, pools, and market data with help-first inspection and Token API specific JWT bearer auth binding.

MITAuto-check passedBackend & APIs

Install Thegraph Token MCP Skill

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

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

GitHub CLI
$ gh skill install holon-run/uxc thegraph-token-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-token-mcp-skill .claude/skills/thegraph-token-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/

Facts

Skill name
thegraph-token-mcp-skill
GitHub stars
116
Token cost
~1.2k tokens
SKILL.md length
542 words
Files
4 (incl. scripts, references)
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Use The Graph Token API MCP through UXC for token metadata, wallet balances, transfers, holders, pools, and market data with help-first inspection and Token API specific JWT bearer auth binding.

  • Works in 5 steps: Verify endpoint and protocol with… → Configure a dedicated Token API JWT… → Use fixed link command by default → …
  • Tasks that involve Authentication
  • SKILL.md covers Prerequisites, Core Workflow, Capability Map and Recommended Usage Pattern, plus 3 more sections
  • Runs Shell scripts from its folder; reaches token-api.mcp.thegraph.com and thegraph.market

What it does

Thegraph Token MCP Skill is an agent skill from holon-run/uxc. Use The Graph Token API MCP through UXC for token metadata, wallet balances, transfers, holders, pools, and market data with help-first inspection and Token API specific JWT bearer auth binding.

Its SKILL.md is about 1.2k 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 Authentication, MCP servers and Stock and market analysis. It works with Model Context Protocol. 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 Authentication
  • Tasks that involve MCP servers
  • Tasks that involve Stock and market analysis

Example prompts

  • “/thegraph-token-mcp-skill”

Requirements

  • A Bash shell

Workflow steps

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

  1. Verify endpoint and protocol with help-first probing
  2. Configure a dedicated Token API JWT credential and binding
  3. Use fixed link command by default
  4. Inspect operation schema before execution
  5. Prefer read operations first, then narrower wallet/token/pool queries.

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:

    • token-api.mcp.thegraph.com
    • thegraph.market

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Thegraph Token MCP Skill loads about 1.2k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 55 tokens; SKILL.md has 542 words of instructions outside code blocks.

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

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). 542 words, ~1,185 tokens.

Download SKILL.mdSave it as .claude/skills/thegraph-token-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-token-mcp-skill
description
Use The Graph Token API MCP through UXC for token metadata, wallet balances, transfers, holders, pools, and market data with help-first inspection and Token API specific JWT bearer auth binding.

The Graph Token MCP Skill

Use this skill to run The Graph Token API MCP operations through uxc.

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://token-api.mcp.thegraph.com/.
  • A The Graph Token API API TOKEN (JWT) from https://thegraph.market/dashboard is available for authenticated calls.

Important auth distinction:

  • Do not reuse the thegraph-mcp-skill API key directly.
  • thegraph-token-mcp-skill uses a separate credential sourced from The Graph Market Token API dashboard.
  • The value used with Authorization: Bearer ... must be the generated API TOKEN (JWT), not the raw dashboard API key.

Core Workflow

  1. Verify endpoint and protocol with help-first probing:
    • uxc https://token-api.mcp.thegraph.com/ -h
    • Confirm protocol is MCP (protocol == "mcp" in envelope).
  2. Configure a dedicated Token API JWT credential and binding:
    • Generate the API TOKEN (JWT) in https://thegraph.market/dashboard
    • Store it separately from the subgraph credential, for example:
      • uxc auth credential set thegraph-token --secret-env THEGRAPH_TOKEN_API_JWT
    • Bind the Token API endpoint to that dedicated credential:
      • uxc auth binding add --id thegraph-token-mcp --host token-api.mcp.thegraph.com --scheme https --credential thegraph-token --priority 100
  3. Use fixed link command by default:
    • command -v thegraph-token-mcp-cli
    • If missing, create it:
      • uxc link thegraph-token-mcp-cli https://token-api.mcp.thegraph.com/
    • thegraph-token-mcp-cli -h
  4. Inspect operation schema before execution:
    • thegraph-token-mcp-cli getV1Networks -h
    • thegraph-token-mcp-cli getV1EvmTokens -h
    • thegraph-token-mcp-cli getV1EvmBalances -h
  5. Prefer read operations first, then narrower wallet/token/pool queries.

Capability Map

  • Service discovery:
    • getV1Health
    • getV1Version
    • getV1Networks
  • Token data:
    • getV1EvmTokens
    • getV1EvmTokensNative
  • Wallet and transfer data:
    • getV1EvmBalances
    • transfer/history operations exposed by the endpoint
  • Market and DEX data:
    • pool / OHLC / dex operations exposed by the endpoint
  • Non-EVM coverage:
    • TVM and other chain families exposed by the endpoint

Always inspect host help and operation help in the current endpoint version before relying on an operation name or argument shape.

  1. Start with network discovery:
    • thegraph-token-mcp-cli getV1Networks
  2. Confirm the operation and required arguments with -h.
  3. Query the narrowest surface first:
    • token metadata for one contract
    • balances for one address
    • one pool / one token / one date range
  4. Expand to broader scans only when needed.
Show full SKILL.md (204 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-token-mcp-cli as default command path.
  • thegraph-token-mcp-cli <operation> ... is equivalent to uxc https://token-api.mcp.thegraph.com/ <operation> ... when the same auth binding is configured.
  • Use direct uxc "<endpoint>" ... only as temporary fallback when link setup is unavailable.
  • Prefer key=value for simple arguments and positional JSON for nested objects.
  • If auth fails:
    • confirm uxc auth credential info thegraph-token succeeds
    • confirm uxc auth binding match https://token-api.mcp.thegraph.com/ resolves to thegraph-token
    • confirm the stored secret is the generated API TOKEN (JWT), not the raw API key from The Graph Market dashboard
    • rerun thegraph-token-mcp-cli -h

Tested Real Scenario

The endpoint was verified through uxc host discovery and returned a live MCP tool list including:

  • getV1Health
  • getV1Version
  • getV1Networks
  • getV1EvmTokens
  • getV1EvmTokensNative
  • getV1EvmBalances

This confirms the skill target is a real MCP surface rather than a direct OpenAPI host.

The Token API requires its own bearer token workflow:

  • manage the token in https://thegraph.market/dashboard
  • generate API TOKEN (JWT) from the dashboard-managed Token API key
  • store that JWT separately from the subgraph MCP credential

Do not document or implement this skill as if it reused the same raw API key as thegraph-mcp-skill.

References

  • Invocation patterns:
    • references/usage-patterns.md

© holon-run, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts, references) in skills/thegraph-token-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 Token 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 Token MCP Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Thegraph Token MCP Skill this skillholon-run/uxc116—~1.2kAutomated safety check: PassMIT
MCP API Key AuthenticationYourdaylight/stock_datasource189—~1.2kAutomated safety check: PassMIT
Atlassiansanjay3290/ai-skills431—~1.6kAutomated safety check: PassApache-2.0
Spring Security ConfigurationAmplicode/spring-skills126—~4.3kAutomated safety check: PassNone
API Authcyanheads/pubmed-mcp-server156—~2.7kAutomated safety check: PassApache-2.0
Building Chat Interfacesaiskillstore/marketplace430—~2.4kAutomated safety check: PassNone

Similar skills

  • MCP API Key Authentication

    Yourdaylight/stock_datasource

    Sets up and troubleshoots MCP API key authentication for a stock data service, covering key creation, client configuration and per-tool usage statistics.

    189 GitHub stars~1.2k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Atlassian

    sanjay3290/ai-skills

    Manage Jira issues and Confluence wiki pages in Atlassian Cloud.

    431 GitHub stars~1.6k tokensUpdated 29 days ago
    Backend & APIsAuto-check passed
  • Spring Security Configuration

    Amplicode/spring-skills

    Creates a Spring Security configuration class with authentication, authorization, and HTTP protection setup.

    126 GitHub stars~4.3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • API Auth

    cyanheads/pubmed-mcp-server

    Authentication, authorization, and multi-tenancy patterns for @cyanheads/mcp-ts-core.

    156 GitHub stars~2.7k tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Building Chat Interfaces

    aiskillstore/marketplace

    Build AI chat interfaces with custom backends, authentication, and context injection.

    430 GitHub stars~2.4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Notion MCP

    LeoYeAI/openclaw-master-skills

    Notion MCP integration with managed authentication. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.7k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed

More from holon-run/uxc

All 62 skills in this repo
  • Context7 MCP Skill

    holon-run/uxc

    Query up-to-date library documentation and code examples using Context7 MCP.

    116 GitHub stars~564 tokensUpdated 24 days ago
    Auto-check passed
  • Deepwiki MCP Skill

    holon-run/uxc

    Ask questions and read documentation about any GitHub repository using DeepWiki MCP.

    116 GitHub stars~700 tokensUpdated 24 days ago
    Auto-check passed
  • Operate Linear workspace issues, projects, and teams through Linear GraphQL API using UXC.

    116 GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed
  • Operate Notion Public API through UXC with a curated OpenAPI schema for search, block traversal, page reads, content writes, and data source/database inspection.

    116 GitHub stars~2.3k tokensUpdated 24 days ago
    Auto-check passed
  • Operate Alchemy Prices API reads through UXC with a curated OpenAPI schema, path-templated API-key auth, and read-first guardrails.

    116 GitHub starsUsed in 1 repo~1k tokens
    Auto-check passed
  • Uxc

    holon-run/uxc

    Discover and call remote schema-exposed interfaces with UXC.

    116 GitHub stars~1.8k tokensUpdated 24 days ago
    Auto-check passed

Categories

Questions about Thegraph Token MCP Skill

What does Thegraph Token MCP Skill do?

Use The Graph Token API MCP through UXC for token metadata, wallet balances, transfers, holders, pools, and market data with help-first inspection and Token API specific JWT bearer auth binding. Thegraph Token MCP Skill is an agent skill from holon-run/uxc. Use The Graph Token API MCP through UXC for token metadata, wallet balances, transfers, holders, pools, and market data with help-first inspection and Token API specific JWT bearer auth binding.

When should I use Thegraph Token MCP Skill?

Thegraph Token MCP Skill fits situations like: tasks that involve Authentication; tasks that involve MCP servers; tasks that involve Stock and market analysis.

How do I install Thegraph Token MCP Skill in Claude Code?

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

How do I install Thegraph Token MCP Skill in Codex?

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

Can I use Thegraph Token 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-token-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-token-mcp-skill, .gemini/skills/thegraph-token-mcp-skill, .github/skills/thegraph-token-mcp-skill and .opencode/skills/thegraph-token-mcp-skill in your project.

What does Thegraph Token MCP Skill need to run?

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

Does Thegraph Token MCP Skill access the network?

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

Is Thegraph Token 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 Token MCP Skill use?

Thegraph Token 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 Token MCP Skill use?

About 1.2k tokens (SKILL.md is roughly 4.7k 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 584 tokens, read only when the agent opens those files.

What are the alternatives to Thegraph Token MCP Skill?

Skills that share tags, products or a category with Thegraph Token MCP Skill: MCP API Key Authentication (Yourdaylight/stock_datasource, 189 stars), Atlassian (sanjay3290/ai-skills, 431 stars), Spring Security Configuration (Amplicode/spring-skills, 126 stars) and API Auth (cyanheads/pubmed-mcp-server, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Thegraph Token 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.