How to Use the Deck of Cards MCP in Claude Code

Q: Can I manage multiple decks at once with Deck of Cards and Claude Code?

Yes. Each time you run createnewdeck or shufflenewdeck, you get a unique deckid. You can manage as many of these as you need, making it easy to script scenarios with multiple decks.

Q: What's the easiest way to shuffle a deck with Deck of Cards from Claude Code?

The shufflenewdeck tool. It creates and shuffles a deck in a single step. Just run it through Claude Code and you'll get back a JSON object with the deckid and confirmation that it's been shuffled.

Run card simulations and build game backends from your terminal. A simple, scriptable API for any card-based logic in your Claude Code workflow.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Deck of Cards MCP to Claude Code

Create your Vinkius account to connect Deck of Cards to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Deck of Cards with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Scriptable decks for backend tasks

This server gives you a scriptable card deck right in your terminal. Run a command with Claude Code to `shuffle_new_deck` and pipe the resulting JSON to `jq` to grab the deck ID. It's designed for automation. From there, you can build simple shell scripts for complex tasks. A single script can `create_new_deck`, `draw_cards` for multiple players, and use `add_to_pile` to set up a full game state. It's perfect for prototyping a game backend without writing any server code.

Manage game state for headless applications

You can run an entire game logic from the command line. Use the tools to manage player hands as `piles`. Your scripts can `draw_cards`, check hand values, and `return_to_deck` at the end of a round. It works as a simple, stateful service for your automated tasks. Because Claude Code can execute these tools, you can build simple cron jobs or daemons that run simulations. For example, run a Monte Carlo simulation for a card game by repeatedly calling `shuffle_new_deck` and `draw_cards` in a loop, logging the results to a file for analysis.

Generate test data in your CI/CD pipeline

This MCP server is a solid source for test data. In a GitHub Action or other CI environment, have Claude Code use `create_partial_deck` to generate a specific hand that you know should win or lose. Then, run your game's validation logic against it. This makes your tests more reliable. Instead of using a fixed seed for randomization, you can `reshuffle_deck` to test the true randomness of a game. Or, use `draw_from_pile_random` to ensure your logic correctly handles drawing from a messy discard pile.

Setup guide

Set up Deck of Cards MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see deck-of-cards-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Deck of Cards transactions." It will automatically discover and invoke the available Deck of Cards tools.

Terminal

claude mcp add --transport http deck-of-cards-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Deck of Cards MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "deck-of-cards-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Deck of Cards API. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Deck of Cards now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Deck of Cards MCP in Claude Code

You can call the tools directly from your CI scripts via Claude Code. For example, use `create_partial_deck` to set up a specific test case for your game logic, then pipe the output to your test runner. It's a reliable way to generate test data.

Yes. Each time you run `create_new_deck` or `shuffle_new_deck`, you get a unique `deck_id`. You can manage as many of these as you need, making it easy to script scenarios with multiple decks.

The `shuffle_new_deck` tool. It creates and shuffles a deck in a single step. Just run it through Claude Code and you'll get back a JSON object with the `deck_id` and confirmation that it's been shuffled.

Yes, everything returns clean JSON. This makes it easy to pipe the output to command-line tools like `jq` for parsing or to use the output directly in your shell scripts.

Only the commands to manipulate cards, like 'draw 2 cards from deck_id xyz'. The server is completely unaware of your shell environment, your scripts, or what you do with the JSON data it returns. The Vinkius platform ensures each request is isolated.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript