• GROUPING
  • DRAWING
  • ORDERING
  • REVIEW

How to manage custom card piles with your AI

Connect the Deck of Cards MCP to your agent to handle specific card groups. Once connected, you can group, shuffle, and draw cards using natural language.

Ask AI about this page

Short answer

How can I manage custom card piles with my AI?

You tell your AI to move cards into named piles or draw from them. It handles the organization, shuffling, and drawing while you focus on the game or session. You get full control over how cards are grouped and accessed.

Where every card lands.

Organized card management

The AI handles the heavy lifting of card movement and deck state.

GROUPING

Named card piles

The AI moves specific cards into custom piles. You can keep discard piles, player hands, or special event decks separate.

DRAWING

Controlled card draws

Your agent pulls cards from the top or bottom of any pile. This keeps the flow of your session moving without manual tracking.

ORDERING

Randomized decks

The AI shuffles any pile you specify. It ensures the next draw is unpredictable and follows your rules.

REVIEW

Human oversight

You decide when to check the contents of a pile. The AI lists the cards so you can verify everything is where it should be.

The workflow

What your AI does when you request pile changes.

The AI acts as your dealer and deck manager.

  1. Categorize cards

    The AI sorts specific cards into the groups you define. This keeps your session organized by moving items into named piles.

    add_to_pile

  2. Check pile contents

    If you need to see what is left in a deck, the AI provides a full list of the cards in that specific pile.

    list_pile

  3. Shuffle the deck

    When a pile needs to be randomized, the AI reorders the cards instantly.

    shuffle_pile

  4. Distribute cards

    The AI pulls cards from either the top or the bottom of a pile based on your instructions.

    draw_from_piledraw_from_pile_bottom

Try it

Copy these to start.

Use these prompts to begin managing your cards.

Starting points

Swap the bracketed text for your actual pile names or card names.

Deck of Cards API Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Deck of Cards API capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "deck-of-cards-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp"
    }
  }
}
Copy into chat04

  • Add the Ace of Spades and King of Hearts to a pile named 'High Value'.

  • Shuffle the 'Main Deck' pile.

  • Draw the top card from the 'Player 1' pile.

  • List all the cards currently in the 'Discard' pile.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Deck of Cards once, then ask.

One click connects the MCP to your client. Your credentials stay encrypted, and you can start managing piles immediately.

Connect Deck of Cards to your AI

FAQ

How the card management behaves

  • 01

    Can the AI create new piles automatically?

    Yes, when you tell the AI to add a card to a new pile name, it creates that pile for you.

  • 02

    Can the AI delete a pile?

    No, the AI can only move cards or list what is inside. You must manage the existence of piles yourself.

  • 03

    Does the AI remember the card order between sessions?

    The AI manages the state of the piles as they exist in the current session.

  • 04

    Can the AI draw from the bottom of the deck?

    Yes, you can specifically ask it to draw from the bottom of any pile.

  • 05

    Can the AI change the rules of the game?

    No, the AI only performs the physical actions of moving, shuffling, and drawing cards.

  • More questions about Deck of Cards? The Connector page answers them. See everything the Deck of Cards Connector can do

Connect Deck of Cards API to Claude, Cursor, ChatGPT & more