How do I install Spirit Cards?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Spirit Cards need an API key?

No required environment variable is listed on this record.

What transport does Spirit Cards use?

Spirit Cards is reached over HTTP.

When was Spirit Cards last checked?

Last checked 2026-11-08. Read-only Spirit Cards MCP: PoW-mined NFT cards on Robinhood Chain — stats, cards, leaderboard.

Spirit Cards MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://spiritcards.fun/api/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http fun.spiritcards-spirit-cards-mcp https://spiritcards.fun/api/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "fun.spiritcards-spirit-cards-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://spiritcards.fun/api/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.1.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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

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:

https://spiritcards.fun/api/mcp

Spirit Cards

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Spirit Cards?

Does Spirit Cards need an API key?

What transport does Spirit Cards use?

When was Spirit Cards last checked?

Documentation

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