Deck of Cards

Deck of Cards MCP Connector for Claude

D

Simulate a full deck of cards via the Deck of Cards API — shuffle, draw, manage piles, and create custom decks for games or simulations.

13 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect to the Deck of Cards API to integrate standard playing card mechanics into your AI agent. Perfect for building games, probability simulations, or interactive entertainment through natural conversation.

What you can do

  • Deck Management — Create new decks, shuffle existing ones, or generate partial decks with specific cards (e.g., only Aces and Kings).
  • Draw Mechanics — Draw cards from the top, bottom, or random positions in a deck or specific named piles.
  • Pile Organization — Create named piles (like 'Player 1 Hand' or 'Discard Pile') and move cards between them seamlessly.
  • Custom Configurations — Include jokers or use multiple decks (up to 6 or more) for complex casino-style simulations.
  • State Tracking — List cards in specific piles and track the remaining count in the main deck.

How it works

  1. Subscribe to this server
  2. Initialize your session by providing a Deck ID or using the 'new' keyword
  3. Start playing or simulating card games directly from Claude, Cursor, or any MCP-compatible client

No more manual randomization or complex state management for card games. Your AI acts as the dealer and game engine.

Who is this for?

  • Game Developers — prototype card game logic and mechanics quickly without writing a backend
  • Data Scientists — run probability simulations and Monte Carlo experiments using a standardized card API
  • Hobbyists & Educators — play simple card games or teach probability and statistics with interactive examples
playing-cardsgame-mechanicssimulationapi-integrationrandomization

13 tools expose this connector's capabilities to your AI agent.

add_to_pile

Add cards to a pile

create_new_deck

Create a brand new deck in standard order

create_partial_deck

Create a partial deck with specific cards

draw_cards

Draw cards from a deck

draw_from_pile_bottom

Draw cards from the bottom of a pile

draw_from_pile_random

Draw random cards from a pile

draw_from_pile

Draw cards from a pile

list_pile

List cards in a pile

reshuffle_deck

Reshuffle an existing deck

return_pile_to_deck

Return cards from a pile to the main deck

return_to_deck

Return cards to the main deck

shuffle_new_deck

Can optionally use multiple decks. Create a new shuffled deck

shuffle_pile

Shuffle a specific pile

See how to talk to your AI agent using Deck of Cards.

Create a new shuffled deck using 6 standard decks for a blackjack simulation.

I've initialized a new multi-deck set. Deck ID: `3p40paa87x90`. It contains 312 cards and is fully shuffled. Ready to deal!

Draw 5 cards from deck 3p40paa87x90 and add them to a pile named 'player_hand'.

I've drawn 5 cards (8H, AD, 2C, KS, 4D) and moved them to the 'player_hand' pile. There are 307 cards remaining in the main deck.

List all the cards currently in the 'discard' pile for deck 3p40paa87x90.

The 'discard' pile currently contains 3 cards: Queen of Hearts (QH), 10 of Spades (0S), and 5 of Diamonds (5D).

Yes! Use the `create_new_deck` tool and set the `jokers_enabled` parameter to true. This will add two Jokers to your standard 52-card deck.

Related Connectors