Spirit Cards

Official9 tools

by spiritcards · JavaScript

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

fun.spiritcards/spirit-cards-mcp — Model Context Protocol (MCP) Server

This is a read-only MCP server for “Spirit Cards” that exposes data for PoW-mined NFT cards on the Robinhood Chain. It provides access to stats, card information, and a leaderboard, based on the server description provided.

🛠️ Key Features

Read-only access to Spirit Cards data
PoW-mined NFT card information on Robinhood Chain
Card stats
Cards listing/details
Leaderboard data

🚀 Use Cases

Query NFT card stats for Robinhood Chain Spirit Cards
Retrieve details about specific Spirit Cards
Fetch leaderboard information for comparison or ranking

⚡ Developer Benefits

Provides structured, read-only access to Spirit Cards stats and leaderboard data
Includes focused outputs for cards, stats, and leaderboard content

⚠️ Limitations

Read-only: cannot modify or write data

Topics

ai-agentsmcpmodel-context-protocoltypescriptweb3

Captured live from the server via tools/list.

get_collection_stats

Live collection statistics for Spirit Cards: total minted, max supply, current mint price (ETH), difficulty (requiredBits/baseBits), cooldown, merge fee, burned/forged counters, paused flag, chainId and contract.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_card

Full profile of a Spirit Cards token by id: species, element, rarity tier, HP/ATK/DEF, and the deterministic on-chain seed. Works for any minted token id.

Parameters1

tokenId

string | number

required

Token id (unsigned integer)

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "description": "Token id (unsigned integer)",
      "type": [
        "string",
        "number"
      ]
    }
  },
  "required": [
    "tokenId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

verify_nonce

Recompute the proof-of-work for a (miner, nonce) pair exactly as the contract does: work = keccak256(chainId ‖ contract ‖ miner ‖ nonce). Returns the hash, its leading-zero-bit count, the current requiredBits threshold, and whether it would be accepted on-chain.

Parameters2

miner	string	required	Miner address (0x…)
nonce	string \| number	required	Nonce (unsigned integer)

Raw schema

{
  "type": "object",
  "properties": {
    "miner": {
      "type": "string",
      "description": "Miner address (0x…)"
    },
    "nonce": {
      "description": "Nonce (unsigned integer)",
      "type": [
        "string",
        "number"
      ]
    }
  },
  "required": [
    "miner",
    "nonce"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_leaderboard

On-chain activity-points leaderboard (mine/merge/stake/pvp-win points), top N wallets.

Parameters1

limit

integer

optional

Max rows (1–200)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 25,
      "description": "Max rows (1–200)",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_pool

Staking-pool / dividend status: accrued pool, split shares, vault total weight, undistributed rewards.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_recent_activity

Recent on-chain activity (mints / pack opens) from the latest blocks.

Parameters1

limit

integer

optional

Max events (1–50)

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "description": "Max events (1–50)",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_project_info

What Spirit Cards is: the game, the five-node loop (mine → merge → battle → stake → points), the chain (Robinhood Chain, CORE contract, explorer, ETH gas), official links, the collection (species / rarity tiers / battle elements) and the key economy (max supply, price step, fee split). Call get_mining_guide to start mining.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

get_mining_guide

Step-by-step guide to mine a Spirit Card: the exact proof-of-work rule, the live difficulty / price / cooldown / chip discount, where to get a miner (browser at /mine, public CLI), the exact contract call, and how to get a valid nonce with the find_nonce tool.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

find_nonce

Grind a proof-of-work nonce for a miner address so it can mint immediately: work = keccak256(chainId ‖ core ‖ miner ‖ nonce), using the live requiredBits threshold. Returns the first nonce whose work has at least requiredBits leading zero bits, within a ~20 s wall-clock cap. If the difficulty is high it may return found:false — retry or lower maxAttempts.

Parameters2

miner	string	required	Miner address (0x…)
maxAttempts	integer	optional	Maximum number of nonces to try (1000–5,000,000)

Raw schema

{
  "type": "object",
  "properties": {
    "miner": {
      "type": "string",
      "description": "Miner address (0x…)"
    },
    "maxAttempts": {
      "default": 1000000,
      "description": "Maximum number of nonces to try (1000–5,000,000)",
      "type": "integer",
      "minimum": 1000,
      "maximum": 5000000
    }
  },
  "required": [
    "miner"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

README.md5 KBView on GitHub

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

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 var	Default	Meaning
`SPIRIT_CARDS_API`	`https://spiritcards.fun`	Base 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

Tool	Args	Description
`get_project_info`	—	`/.well-known/ai.json` + a composed human `summary`
`get_collection_stats`	—	Live stats: supply, price, `baseBits`, cooldown, paused flag
`get_card`	`tokenId`	Card metadata (`/api/meta/{tokenId}`)
`get_leaderboard`	`limit?` (default 25)	Points leaderboard, trimmed to `limit`
`get_pool`	—	Staking pool: accrued pool, split shares, vault weight (undistributed)
`get_recent_activity`	`limit?` (default 10)	Recent events, trimmed to `limit`
`verify_nonce`	`miner`, `nonce`	Verify a nonce's work locally (no tx): `{work, leadingZeroBits, valid}`
`find_nonce`	`miner`, `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:

code

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

Prompt	Args	Description
`project_overview`	—	Introduce the game to a newcomer (calls the info + stats tools)
`start_mining`	`wallet?`	Walk through finding a nonce and the exact mint transaction

Hosted HTTP MCP

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

code

https://spiritcards.fun/api/mcp

License

Install

Tools (9)

get_collection_statsget_cardverify_nonceget_leaderboardget_poolget_recent_activityget_project_infoget_mining_guide

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://spiritcards.fun/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

fun.spiritcards/spirit-cards-mcp — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_collection_stats

get_card

verify_nonce

get_leaderboard

get_pool

get_recent_activity

get_project_info

get_mining_guide

find_nonce

spirit-cards-mcp

Quick start

Run with npx (after publishing)

Run from source

Use in Claude Desktop

Use in Cursor

Configuration

Tools

Proof-of-work

Prompts

Hosted HTTP MCP

License

Install

Remote endpoint

Related servers