MCP (Model Context Protocol) server for NexGenSpin — manage game sessions, browse games, and query platform data from Claude, Cursor, Windsurf, and other AI assistants.

Built on top of the official @nexgenspin/client TypeScript SDK.

Quick start

1. Get your credentials

During onboarding, NexGenSpin provides your Operator ID and you exchange Ed25519 keys. See the Environments & Access docs.

2. Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ngs": {
      "command": "npx",
      "args": ["-y", "ngs-mcp"],
      "env": {
        "NGS_OPERATOR_ID": "your-operator-id",
        "NGS_PRIVATE_KEY": "hex-encoded-ed25519-private-key",
        "NGS_API_ENDPOINT": "staging"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "ngs": {
      "command": "npx",
      "args": ["-y", "ngs-mcp"],
      "env": {
        "NGS_OPERATOR_ID": "your-operator-id",
        "NGS_PRIVATE_KEY": "hex-encoded-ed25519-private-key",
        "NGS_API_ENDPOINT": "staging"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add ngs -- npx -y ngs-mcp

3. Use it

Just ask your AI assistant:

• "What games are available?"
• "Create a demo session for Glass Bridge"
• "Launch a USD session for customer 12345 on the Mines game"
• "What currencies does NGS support?"
• "List all supported languages"

Available tools

| Tool | Description | |---|---| | list_games | All available games with names, descriptions, mode, house edge, thumbnails | | list_currencies | Supported currencies with ISO 4217 codes and decimal precision | | list_languages | Supported languages as BCP 47 tags | | create_session | Create a game session for a customer (returns iframe URL) | | create_demo_session | Create a demo session (no real funds, no customer required) |

Environment variables

| Variable | Required | Description | |---|---|---| | NGS_OPERATOR_ID | Yes | Operator ID assigned during onboarding (Request-Caller-Id) | | NGS_PRIVATE_KEY | Yes | Hex-encoded Ed25519 private key for request signing | | NGS_API_ENDPOINT | No | production (default), staging, or custom URL |

Extracting the private key

Generate your Ed25519 key pair per the NGS docs:

# Generate keys
openssl genpkey -algorithm Ed25519 -out operator.pem
openssl pkey -in operator.pem -pubout -out operator_pub.pem

# Extract hex-encoded private key for NGS_PRIVATE_KEY
openssl pkey -in operator.pem -outform DER | xxd -p -c 256

Send operator_pub.pem to your NGS onboarding manager. Use the hex output as NGS_PRIVATE_KEY.

Architecture

This MCP server wraps the Coordinator API (Operator → NGS direction):

AI Assistant (Claude/Cursor)
    ↓ MCP protocol
NexGenSpin MCP Server
    ↓ GraphQL + Ed25519 signing
NGS Coordinator API

The Seamless Wallet (NGS → Operator direction) is not covered — that's a server the operator implements to handle balance queries, wager reservations, settlements, and cancellations.

Development

git clone https://github.com/pnplsrcrr/ngs-mcp.git
cd ngs-mcp
npm install
npm run build
npm start

Links

• NexGenSpin — Gaming platform
• Integration Docs — API documentation
• @nexgenspin/client — Official TypeScript SDK
• MCP Protocol — Model Context Protocol spec

License

MIT