English Français العربية

Spirit Cards

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http spirit-cards 'https://spiritcards.fun/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "spirit-cards": {
            "type": "http",
            "url": "https://spiritcards.fun/api/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. spirit-cards-mcp
  2. Quick start
  3. Use in Claude Desktop
  4. Use in Cursor
  5. Configuration
  6. Tools
  7. Prompts
  8. Hosted HTTP MCP
  9. License

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)
npx spirit-cards-mcp
Run from source
npm install
node 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):

{
  "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):

{
  "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.

الأسئلة الشائعة

ما هو Spirit Cards؟

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

كيف أثبّت Spirit Cards؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http spirit-cards 'https://spiritcards.fun/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Spirit Cards إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Spirit Cards مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Spirit Cards؟

ينشره spiritcards. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.