Spirit Cards

fun.spiritcardsv0.1.0Updated Oct 6, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Read-only access to Spirit Cards, a proof-of-work minted collectible card game on Robinhood Chain: stats, cards, leaderboard, pool, and local nonce…

What it does
Exposes read-only tools for the Spirit Cards game: project info, live collection stats (supply, price, required difficulty, cooldown), card metadata by token ID, the points leaderboard, the staking pool snapshot, and recent on-chain activity. It also verifies a mining nonce locally and can grind for a valid nonce, plus prompts that introduce the game and walk through minting.
When to use it
Useful when an assistant needs to inspect or explain the Spirit Cards collection, look up a card, check live stats or the leaderboard, or verify and search for proof-of-work nonces without a wallet or transactions.
Requirements
A local Node.js runtime to run the npm package via npx, or the hosted HTTP endpoint. The optional environment variable SPIRIT_CARDS_API sets the API base URL and defaults to the project site. Network access is needed for the read-only GET endpoints.
Before you install
The server is described as read-only: no keys, secrets, signing, or transactions, and all network calls are plain GETs. Nonce grinding is compute-intensive and capped by attempts and time. Data is fetched from a third-party hosted API, so queries go to that service.

Installation

In SourceWeft

  1. Open Spirit Cards in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

Source: README.md at commit 0b2fe7b

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.1.0LatestOct 6, 2026