Valo.IA (ValoTCG)

Valo.IA — 集换式卡牌价格 MCP 服务

询问 AI Agent 任意集换式卡牌的价值，即可获得附有来源和日期的答案。 Valo.IA 是 ValoTCG 背后的托管式 MCP 服务：涵盖 14 款游戏的 540,000 多条卡牌参考数据，包括真实的欧洲价格（Cardmarket，以 EUR 计价）、美国市场价格、卡牌在 eBay 上的实际成交价、评级卡成交价和 PSA 人口数据、密封产品以及 365 天的历史记录。只需一行配置和一个 API 密钥，你的 Agent 就能像市场分析师一样为收藏、商店库存或单张抽出的卡牌估价。

涵盖的游戏： Pokémon · One Piece Card Game · Disney Lorcana · Yu-Gi-Oh! · Magic: The Gathering · Dragon Ball Super Card Game (Masters) · Dragon Ball Super Card Game Fusion World · Union Arena · Riftbound: League of Legends TCG · Cyberpunk Trading Card Game · Naruto Mythos TCG · Flesh and Blood · Gundam Card Game · Star Wars: Unlimited。游戏发行过的英文、法文、日文和中文卡牌均有收录；各数据源的实时覆盖情况见 https://valotcg.com/developers/coverage。

Agent 青睐它的原因

• 每个价格都标明来源、币种和日期。没有混合估值，不会静默换算；如果某个来源没有数据，则返回 status: "missing"，而不是猜测。

• 单次调用同时提供评级卡和未评级卡数据：eBay 上 PSA 9 和 PSA 10 评级卡过去 30 天及 90 天的中位价与未评级卡价格并列显示，还提供按评级划分的 PSA 和 CCC 人口数据，帮助判断卡牌是否值得送评。

• 现成的答案：price_summary 返回带有可靠性和近期变化信息的推荐价格；top_movers 和 top_priced 对整套卡牌进行排名；compare_prices 并排比较十张卡牌。

• 专为工具调用打造：提供 16 个只读、幂等工具，响应中包含额度计量；错误不会计费；可免费使用 Sandbox 密钥进行试用。

• 端点： https://api.valotcg.com/mcp（Streamable HTTP、无状态、JSON 响应）

• 注册表名称： com.valotcg/valo-ia

• 身份验证： Authorization: Bearer <Valo.Data API key> — initialize 和 tools/list 无需密钥即可使用；调用工具需要密钥

• 文档： https://valotcg.com/developers/docs · 产品页面： https://valotcg.com/developers/ia

本仓库包含该服务的公开元数据（server.json）、设置说明和示例。服务本身运行在 ValoTCG 的基础设施上；无需从此处安装或构建任何内容。

快速开始

1. 在 https://valotcg.com/developers/account 创建免费的 Sandbox 密钥（无需信用卡）。密钥格式为 vd_test_…（Sandbox）或 vd_live_…（付费套餐）。
2. 将该服务添加到你的客户端。

Claude Code

claude mcp add --transport http valotcg https://api.valotcg.com/mcp \
  --header "Authorization: Bearer $VALO_DATA_API_KEY"

Cursor、VS Code、Windsurf 及其他使用 JSON 配置的客户端

{
  "mcpServers": {
    "valotcg": {
      "type": "streamable-http",
      "url": "https://api.valotcg.com/mcp",
      "headers": {
        "Authorization": "Bearer vd_live_…"
      }
    }
  }
}

3. 向 Agent 提出类似 “151 中 Charizard ex 199/165 的当前 Cardmarket 价格是多少？法文版。” 的问题——它会先调用 identify_card，然后调用 get_card_prices 或 price_summary。

工具

全部 16 个工具均为只读且幂等。每次调用都会扣除 Valo.Data 积分（每个工具的积分费用见 tools/list）；出错不会扣费。

工具	功能
list_games	列出上述 14 款游戏、其卡牌语言和各数据源的覆盖情况。免费。
list_editions	列出游戏的系列和扩展，可按名称或系列代码搜索。
search_cards	按名称（FR/EN）、编号、系列、语言或稀有度搜索卡牌。
get_card	获取一张卡牌的信息：名称、编号、稀有度、图片、Cardmarket 和美国市场 ID。
get_card_prices	获取一张卡牌各数据源的当前价格及日期；可选获取评级卡中位价以及 PSA/CCC 数量。
get_cards_batch	一次调用可获取最多 100 张卡牌或密封产品的价格。
get_price_history	获取一张卡牌某个数据源最多 365 天的每日历史记录，每个有观测数据的日期对应一个数据点。
search_sealed	搜索密封产品（补充包、展示盒、ETB、盒装产品）。
get_sealed_prices	获取一个密封产品各数据源的当前价格。
identify_card	根据“dracaufeu 199 151 fr”等自由文本查找卡牌。
price_summary	获取一张卡牌或一个密封产品的建议价格、可靠性和近期变化。
compare_prices	并排比较最多 10 张卡牌和密封产品的价格摘要。
top_movers	查看一款游戏或一个系列在 7、30 或 90 天内涨跌幅最大的商品。
top_priced	查看一款游戏、一个系列或一种语言中价值最高的卡牌或密封产品。
edition_overview	查看一个系列的热门追逐卡、密封产品和价格覆盖情况。
scan_card	从照片中识别卡牌并返回其 Valo.Data ID（仅限具有 Vision 权限范围的密钥）。

不存在的报价会返回 status: "missing" 和空金额，绝不会捏造价格。每个价格都带有数据源、货币和观测日期；不会在不同货币之间进行换算。

行为与限制

• initialize 和 tools/list 无需密钥即可响应，因此目录和客户端可以检查该服务。没有有效密钥的 tools/call 会返回工具错误（invalid_api_key，不扣费），并指向密钥页面。
• 对 /mcp 使用 GET 和 DELETE 会返回 405：该服务是无状态的，没有 SSE 流或会话。
• 不同游戏的覆盖情况各不相同；实时矩阵见 https://valotcg.com/developers/coverage。
• Sandbox 密钥用于原型开发和非商业用途；付费方案包含商业许可。价格为未税价，不适用增值税（法国税法第 293 B 条）。方案：https://valotcg.com/developers/pricing。

链接

• 官方 MCP Registry：https://registry.modelcontextprotocol.io/v0.1/servers?search=com.valotcg/valo-ia
• Glama：https://glama.ai/mcp/connectors/com.valotcg/valo-ia
• mcptry：https://mcptry.com/servers/com.valotcg/valo-ia
• REST API（密钥和数据相同）：https://valotcg.com/developers/api/pokemon
• 联系方式：[email protected]

许可

本仓库中的文件依据 MIT 许可发布（见 LICENSE）。Valo.IA 服务本身的使用受 API 条款约束。