# Deck of Cards MCP for AI Agents AI Agent Connect > Deck of Cards MCP lets your agent manage full decks of playing cards for games or simulations. You can shuffle, draw from specific piles, and create custom setups like multi-deck blackjack. It handles the state of every card so you don't have to track them manually. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/ai-agent-connect - **Tags:** playing-cards, game-mechanics, simulation, api-integration, randomization ## Description This Connector gives your agent the ability to handle complex card game mechanics without you having to manually track every single card in a list. If you are building a card game or running a probability simulation, you can just tell your agent to deal the cards, move them to a discard pile, or shuffle a specific hand. It manages the underlying state of the deck, including multiple decks for casino-style games and custom card sets. Instead of your agent hallucinating what is left in the deck, this Connector provides the ground truth. It is a great way to bring interactive entertainment or rigorous data experiments to life through a natural conversation. You can find this among the 4,000+ options in the Vinkius catalog to get your agent up and running in minutes. It handles the heavy lifting of randomization and pile organization, letting you focus on the rules of your game or the goals of your study. ## Tools ### add_to_pile Put cards into a specific pile. It lets you organize hands or discard areas. ### create_new_deck Make a standard 52 card deck. Use this to start a new game session. ### create_partial_deck Build a deck with only specific cards. It is perfect for custom game setups. ### draw_cards Pull cards from a deck. Use this to deal hands to players. ### draw_from_pile_bottom Take cards from the bottom of a pile. This is useful for specific game rules. ### draw_from_pile_random Grab random cards from a pile. Use this for unpredictable game events. ### draw_from_pile Pull cards from a named pile. It helps manage cards that are not in the main deck. ### list_pile See every card in a specific pile. Use this to check player hands or discard lists. ### return_pile_to_deck Move cards from a pile back to the main deck. It cleans up the game state. ### reshuffle_deck Mix up an existing deck. This ensures the next draw is truly random. ### return_to_deck Put cards back into the main deck. Use this to reset cards after an action. ### shuffle_new_deck Create a new deck that is already shuffled. You can even specify multiple decks. ### shuffle_pile Mix up the cards in a specific pile. This works for hands or discard areas. ## Prompt Examples **Prompt:** ``` I want to play a game of Blackjack. Set up 6 decks and deal me in. ``` **Response:** ``` ### Blackjack Session Initialized I have set up a multi-deck game for you. **Deck Details:** - **Total Decks:** 6 - **Total Cards:** 312 - **Status:** Shuffled and ready. **Your Hand:** - 8 of Hearts (8H) - Ace of Diamonds (AD) **Remaining Cards:** 310 What would you like to do next? ``` **Prompt:** ``` Draw 3 cards from the bottom of the discard pile. ``` **Response:** ``` I have pulled 3 cards from the bottom of the discard pile for you: - **Jack of Spades** (JS) - **4 of Clubs** (4C) - **10 of Hearts** (10H) Would you like to move these back to the main deck or keep them? ``` **Prompt:** ``` Create a deck that only has the four Aces. ``` **Response:** ``` ### Custom Deck Created I have generated a partial deck containing only the Aces: | Card | Suit | | :--- | :--- | | Ace | Spades | | Ace | Hearts | | Ace | Diamonds | | Ace | Clubs | This deck is ready for your simulation. ``` ## Capabilities ### Shuffle any deck or pile Mix up the cards in a main deck or any named pile like a hand or discard area. ### Draw from specific positions Pull cards from the top, bottom, or random positions in a deck or pile. ### Manage card piles Create named piles and move cards between them to organize game states. ### Create custom decks Generate partial decks with specific cards or full standard decks for any game. ### Track deck state See exactly which cards are in a pile and how many remain in the main deck. ### Multi-deck support Handle multiple decks at once for complex games like blackjack. ## Use Cases ### Blackjack Prototype A developer asks the agent to deal 6 decks. The agent uses shuffle_new_deck and draw_cards to manage the game state perfectly. ### Probability Study A scientist needs a Monte Carlo simulation. The agent uses create_partial_deck to isolate Aces and Kings for a specific study. ### Card Game Education A teacher has students draw cards. The agent uses draw_from_pile_random to simulate a lucky draw for a classroom activity. ### Custom RPG Mechanic A DM wants a deck of loot cards. The agent uses create_new_deck and list_pile to track items as they are pulled from the deck. ## Benefits - Handle multi-deck setups like blackjack using shuffle_new_deck to manage hundreds of cards at once. - Maintain perfect game state by moving cards between hands and discard areas with add_to_pile and return_to_deck. - Create specialized card sets for unique games by using create_partial_deck to define exactly which cards are available. - Execute complex draw rules by choosing between draw_cards, draw_from_pile_bottom, and draw_from_pile_random. - Verify game status instantly by using list_pile to see exactly what cards are in any named pile. ## How It Works The bottom line is your agent becomes a reliable dealer that never loses track of the cards. 1. Connect the Connector to your preferred AI client. 2. Initialize a session by creating a new deck or using a specific Deck ID. 3. Command your agent to perform actions like drawing cards or moving them to piles. ## Frequently Asked Questions **Can the Deck of Cards MCP handle multi-deck games?** Yes, it supports up to 6 decks or more, making it ideal for games like blackjack where multiple decks are standard. **How does the Deck of Cards MCP track my cards?** It maintains a persistent state for the main deck and all named piles, so your agent always knows exactly which cards are where. **Can I use the Deck of Cards MCP for custom card sets?** Yes, you can create partial decks that include only specific cards or custom configurations for unique game rules. **Can the Deck of Cards MCP shuffle specific piles?** Yes, you can shuffle any named pile, such as a player's hand or a discard pile, independently of the main deck. **Does the Deck of Cards MCP handle drawing from the bottom?** Yes, it includes specific options to draw from the top, bottom, or random positions within a deck or pile. **Is the Deck of Cards MCP good for probability experiments?** It is perfect for data science and probability studies because it provides a standardized way to run card-based simulations. **Can I create a deck that includes Jokers for games like Rummy?** 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. **Is it possible to draw cards from the bottom of a pile instead of the top?** Absolutely. Use the `draw_from_pile_bottom` tool by specifying the `deck_id` and `pile_name`. You can also use `draw_from_pile_random` if you need a random card from the middle of a pile. **How do I simulate a casino game that uses 6 shuffled decks?** Use the `shuffle_new_deck` tool and set the `deck_count` parameter to 6. This will return a single `deck_id` containing 312 cards (52 * 6) in a randomized order.