Spirit Cards

fun.spiritcardsv0.1.0更新于 Oct 6, 2026

Read-only Spirit Cards MCP: PoW-mined NFT cards on Robinhood Chain — stats, cards, leaderboard.

已验证Streamable HTTP可网页运行FinanceData & Analytics

概览

AI 生成的概览

只读访问 Robinhood Chain 上工作量证明铸造的集换式卡牌游戏 Spirit Cards：统计、卡牌、排行榜、奖池，以及本地 nonce 校验。

功能
提供 Spirit Cards 游戏的只读工具：项目信息、实时收藏统计（供应量、价格、所需难度、冷却时间）、按 token ID 查询卡牌元数据、积分排行榜、质押奖池快照和近期链上活动。还可在本地校验挖矿 nonce，并可搜索有效 nonce，另有介绍游戏和讲解铸造流程的提示。
适用场景
适合需要查看或解释 Spirit Cards 收藏、查询某张卡牌、查看实时统计或排行榜，或在不使用钱包、不发交易的情况下校验和搜索工作量证明 nonce 的场景。
运行要求
需要本地 Node.js 运行时以通过 npx 运行该 npm 包，或使用托管的 HTTP 端点。可选环境变量 SPIRIT_CARDS_API 设置 API 基础地址，默认指向项目站点。只读 GET 端点需要网络访问。
安装前请注意
该服务器自称只读：无密钥、无秘密、不签名、不发交易，所有网络请求均为普通 GET。nonce 搜索计算量大，受尝试次数和时间上限限制。数据来自第三方托管 API，查询会发送到该服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spirit Cards，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "spirit-cards-mcp": {
      "type": "http",
      "url": "https://spiritcards.fun/api/mcp"
    }
  }
}

README

spirit-cards-mcp

A read-only Model Context Protocol (MCP) server for Spirit Cards (Proof of Card) — a proof-of-work minted collectible card game on Robinhood Chain — mainnet chainId 4663, live since 2026-10-05.

It runs over stdio, so Claude Desktop and Cursor can launch it with npx. It fetches live game data from the hosted web API and computes the proof-of-work locally with viem — so an agent can inspect the collection, verify a nonce, or even grind a valid nonce, without a wallet, a private key, or a single transaction.

Read-only. No keys, no secrets, no signing, no sending. Every network call is a plain GET.

Quick start

Run with npx (after publishing)

bash
npx spirit-cards-mcp

Run from source

bash
npm installnode src/index.mjs      # starts the stdio server (logs to stderr)

The server speaks MCP over stdin/stdout and logs only to stderr — it is normally launched by an MCP client, not by hand.

Use in Claude Desktop

Add this to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

json
{  "mcpServers": {    "spirit-cards": {      "command": "npx",      "args": ["-y", "spirit-cards-mcp"],      "env": { "SPIRIT_CARDS_API": "https://spiritcards.fun" }    }  }}

Use in Cursor

Add this to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

json
{  "mcpServers": {    "spirit-cards": {      "command": "npx",      "args": ["-y", "spirit-cards-mcp"],      "env": { "SPIRIT_CARDS_API": "https://spiritcards.fun" }    }  }}

Configuration

Env varDefaultMeaning
SPIRIT_CARDS_APIhttps://spiritcards.funBase URL of the hosted site/API

All data endpoints are read-only GETs:

  • /.well-known/ai.json — project descriptor (chain id, core contract, mechanics, links)
  • /stats/current.json — live supply, price, required difficulty (baseBits), cooldown
  • /api/meta/{tokenId} — card metadata
  • /api/points — points leaderboard
  • /api/pool — staking pool / emissions snapshot (accrued pool, split shares, vault weight)
  • /api/recent — recent on-chain activity

Tools

ToolArgsDescription
get_project_info—/.well-known/ai.json + a composed human summary
get_collection_stats—Live stats: supply, price, baseBits, cooldown, paused flag
get_cardtokenIdCard metadata (/api/meta/{tokenId})
get_leaderboardlimit? (default 25)Points leaderboard, trimmed to limit
get_pool—Staking pool: accrued pool, split shares, vault weight (undistributed)
get_recent_activitylimit? (default 10)Recent events, trimmed to limit
verify_nonceminer, nonceVerify a nonce's work locally (no tx): {work, leadingZeroBits, valid}
find_nonceminer, maxAttempts? (≤5M)Grind nonce 0.. until valid (~20 s wall cap)
get_mining_guide—Step-by-step mint guide with live price/difficulty/cooldown

Proof-of-work

A nonce is valid when:

work = keccak256(abi.encodePacked(uint256 chainId, address core, address miner, uint256 nonce))leadingZeroBits(work) >= baseBits

Both verify_nonce and find_nonce compute this locally with viem's keccak256 over concatHex([chainId, core, miner, nonce]) — byte-for-byte identical to Solidity's abi.encodePacked.

Prompts

PromptArgsDescription
project_overview—Introduce the game to a newcomer (calls the info + stats tools)
start_miningwallet?Walk through finding a nonce and the exact mint transaction

Hosted HTTP MCP

Prefer HTTP over stdio? The same server is also hosted at:

https://spiritcards.fun/api/mcp

License

MIT © 2026 Spirit Cards (Proof of Card). See LICENSE.

来源：README.md，提交 0b2fe7b

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.1.0最新Oct 6, 2026