@razzgames/mcp-server

MCP server for Razz.games - play provably fair games with real SOL wagering from any AI agent. Dice, flip, crash, plinko, limbo, mines, tower, and HexWar.

Quick Setup

1. Get an API Key

Use the razz_register tool after connecting, or create an account at razz.games.

2. Configure Your MCP Client

Add this config to your client. The only thing that changes is where the config goes.

{
  "razz": {
    "command": "npx",
    "args": ["-y", "@razzgames/mcp-server"],
    "env": {
      "RAZZ_API_KEY": "<your-api-key>"
    }
  }
}

Per-Client Config Locations

Client	Config File
Claude Desktop	~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Claude Code	.claude/mcp.json (project) or ~/.claude/mcp.json (global)
Cursor	.cursor/mcp.json (project) or ~/.cursor/mcp.json (global)
VS Code (Copilot)	.vscode/mcp.json
Windsurf	Settings panel
Gemini CLI	CLI settings

For Claude Desktop, wrap in "mcpServers": { ... }. For others, the format above works directly.

Python (LangChain)

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

async with MultiServerMCPClient({
    "razz": {
        "command": "npx",
        "args": ["-y", "@razzgames/mcp-server"],
        "env": {"RAZZ_API_KEY": "your-key"}
    }
}) as client:
    agent = create_react_agent(model, client.get_tools())
    result = await agent.ainvoke({"messages": [("user", "Play dice for 0.01 SOL")]})

Python (CrewAI)

from crewai import Agent

player = Agent(
    role="Razz Player",
    goal="Play games on Razz",
    mcps=[{
        "command": "npx",
        "args": ["-y", "@razzgames/mcp-server"],
        "env": {"RAZZ_API_KEY": "your-key"}
    }]
)

Available Tools (57)

All tool names are prefixed with razz_ (configurable via TOOL_PREFIX env var).

Account (3)

Tool	Description
register	Create a new agent account (returns API key)
connect	Connect with existing API key
link_wallet	Link a Solana wallet for no-memo deposits and withdrawals

Games - Instant (4)

Tool	Description
play_dice	Roll 1-100, over 50 wins (1.96x payout). Optional SOL wager.
play_flip	Coin flip, heads wins (1.96x payout). Optional SOL wager.
play_plinko	Drop ball through peg board. Risk levels: low/medium/high. 1% house edge.
play_limbo	Set target multiplier (1.01-1000x), win if generated multiplier meets it. 2% edge.

Games - Session (6)

Tool	Description
play_mines	Start 5x5 mines game (1-24 mines, 2% edge, up to 50x). Use mines_click and mines_cashout.
mines_click	Reveal a cell (row 0-4, col 0-4). Gem = higher multiplier, mine = lose.
mines_cashout	Cash out at current multiplier. Must reveal at least one gem first.
play_tower	Start 10-floor tower (3 or 4 doors per floor, 2% edge, up to 50x). Use tower_pick and tower_cashout.
tower_pick	Pick a door on current floor. Safe = advance, trap = lose.
tower_cashout	Cash out at current multiplier. Must clear at least one floor first.

Games - Crash (7)

Tool	Description
play_crash	Enter a

... View full README on GitHub