返回顶部
t

thegraph-token-mcp-skillThe Graph Token API

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.

作者: admin | 来源: ClawHub
源自
ClawHub
版本
V 1.0.1
安全检测
已通过
309
下载量
免费
免费
0
收藏
概述
安装方式
版本历史

thegraph-token-mcp-skill

The Graph Token MCP 技能

使用此技能通过 uxc 运行 The Graph Token API MCP 操作。

复用 uxc 技能进行通用协议发现、信封解析和错误处理规则。

前提条件

  • - uxc 已安装并可在 PATH 中使用。
  • 可访问 https://token-api.mcp.thegraph.com/ 的网络。
  • 从 https://thegraph.market/dashboard 获取的 The Graph Token API API TOKEN (JWT) 可用于认证调用。

重要的认证区别:

  • - 不要直接复用 thegraph-mcp-skill 的 API 密钥。
  • thegraph-token-mcp-skill 使用来自 The Graph Market Token API 仪表盘的独立凭证。
  • 与 Authorization: Bearer ... 一起使用的值必须是生成的 API TOKEN (JWT),而不是原始的仪表盘 API 密钥。

核心工作流程

  1. 1. 通过优先使用帮助探测来验证端点和协议:
- uxc https://token-api.mcp.thegraph.com/ -h - 确认协议为 MCP(信封中 protocol == mcp)。
  1. 2. 配置专用的 Token API JWT 凭证和绑定:
- 在 https://thegraph.market/dashboard 中生成 API TOKEN (JWT) - 将其与子图凭证分开存储,例如: - uxc auth credential set thegraph-token --secret-env THEGRAPHTOKENAPI_JWT - 将 Token API 端点绑定到该专用凭证: - uxc auth binding add --id thegraph-token-mcp --host token-api.mcp.thegraph.com --scheme https --credential thegraph-token --priority 100
  1. 3. 默认使用固定链接命令:
- command -v thegraph-token-mcp-cli - 如果缺失,则创建: - uxc link thegraph-token-mcp-cli https://token-api.mcp.thegraph.com/ - thegraph-token-mcp-cli -h
  1. 4. 在执行前检查操作模式:
- thegraph-token-mcp-cli getV1Networks -h - thegraph-token-mcp-cli getV1EvmTokens -h - thegraph-token-mcp-cli getV1EvmBalances -h
  1. 5. 优先使用读取操作,然后是更窄范围的钱包/代币/池查询。

能力映射

  • - 服务发现:
- getV1Health - getV1Version - getV1Networks
  • - 代币数据:
- getV1EvmTokens - getV1EvmTokensNative
  • - 钱包和转账数据:
- getV1EvmBalances - 端点暴露的转账/历史操作
  • - 市场和 DEX 数据:
- 端点暴露的池/OHLC/DEX 操作
  • - 非 EVM 覆盖:
- 端点暴露的 TVM 和其他链族

在依赖操作名称或参数结构之前,始终检查当前端点版本的主机帮助和操作帮助。

推荐使用模式

  1. 1. 从网络发现开始:
- thegraph-token-mcp-cli getV1Networks
  1. 2. 使用 -h 确认操作和所需参数。
  2. 首先查询最窄的表面:
- 单个合约的代币元数据 - 单个地址的余额 - 单个池/单个代币/单个日期范围
  1. 4. 仅在需要时扩展到更广泛的扫描。

防护措施

  • - 保持自动化使用 JSON 输出信封;不要依赖 --text。
  • 首先解析稳定字段:ok、kind、protocol、data、error。
  • 使用 thegraph-token-mcp-cli 作为默认命令路径。
  • 当配置了相同的认证绑定时,thegraph-token-mcp-cli ... 等同于 uxc https://token-api.mcp.thegraph.com/ ...。
  • 仅在链接设置不可用时,临时使用直接的 uxc ... 作为回退。
  • 简单参数优先使用 key=value,嵌套对象使用位置 JSON。
  • 如果认证失败:
- 确认 uxc auth credential info thegraph-token 成功 - 确认 uxc auth binding match https://token-api.mcp.thegraph.com/ 解析为 thegraph-token - 确认存储的密钥是生成的 API TOKEN (JWT),而不是来自 The Graph Market 仪表盘的原始 API 密钥 - 重新运行 thegraph-token-mcp-cli -h

测试过的真实场景

该端点通过 uxc 主机发现进行了验证,并返回了包含以下内容的实时 MCP 工具列表:

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

这确认了技能目标是真实的 MCP 表面,而不是直接的 OpenAPI 主机。

Token API 需要其自己的 bearer token 工作流程:

  • - 在 https://thegraph.market/dashboard 中管理 token
  • 从仪表盘管理的 Token API 密钥生成 API TOKEN (JWT)
  • 将该 JWT 与子图 MCP 凭证分开存储

不要将此技能记录或实现为复用与 thegraph-mcp-skill 相同的原始 API 密钥。

参考

  • - 调用模式:
- references/usage-patterns.md

标签

skill ai

通过对话安装

该技能支持在以下平台通过对话安装:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 thegraph-token-mcp-skill-1776193938 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 thegraph-token-mcp-skill-1776193938 技能

通过命令行安装

skillhub install thegraph-token-mcp-skill-1776193938

下载

⬇ 下载 thegraph-token-mcp-skill v1.0.1(免费)

文件大小: 5.27 KB | 发布时间: 2026-4-15 12:11

v1.0.1 最新 2026-4-15 12:11
**Auth handling and documentation improvements for The Graph Token MCP Skill**

- Clarified the required use of a specific Token API JWT (not a subgraph API key) for authentication.
- Updated setup instructions to reflect proper credential separation and explicit JWT bearer token workflow.
- Added warnings against reusing credentials from other The Graph skills.
- Expanded guardrails and troubleshooting steps for correct auth binding and token usage.
- Improved language in capability and prerequisite descriptions for accuracy.

Archiver·手机版·闲社网·闲社论坛·羊毛社区· 多链控股集团有限公司 · 苏ICP备2025199260号-1

Powered by Discuz! X5.0   © 2024-2025 闲社网·线报更新论坛·羊毛分享社区·http://xianshe.com

p2p_official_large
返回顶部