English Français العربية

Spirit Cards

Official registry Other

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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.

Frequently asked questions

What is Spirit Cards?

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

How do I install Spirit Cards?

It runs as a remote server. In Claude Code: claude mcp add --transport http spirit-cards 'https://spiritcards.fun/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Spirit Cards need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Spirit Cards open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Spirit Cards?

It is published by spiritcards. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.