Skip to content
Vinkius

Deck of Cards API Connector for AI agents.

13 live capabilities

Manage playing card mechanics and probability simulations for games.

Live agent request Deck of Cards API / Connector

Waiting for input…

AI Agent

Why people use Deck of Cards API

Deck of Cards for Card Game Prototyping

This Connector fixes that by moving the state management out of the chat history and into a dedicated system. Your agent just calls a capability to deal a card or shuffle a pile, and the Connector handles the math. You get a consistent game that does not break after five turns.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • Visual Studio Code
  • Windsurf

What Vinkius changes

Your agent becomes a reliable dealer that never loses track of the cards.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

  1. Real-world use case 01

    Blackjack Prototype

    A developer asks the agent to deal 6 decks.

  2. Real-world use case 02

    Probability Study

    A scientist needs a Monte Carlo simulation.

  3. Real-world use case 03

    Card Game Education

    A teacher has students draw cards.

Complete set · 13capabilities

The complete Deck of Cards API capability set.

These are the exact actions your AI can choose when you ask it to work with Deck of Cards API.

Capability set01 / 04

01—04

4 capabilities in this set.

Part of 13 available through Deck of Cards API.

  1. 01 Capability

    Add to pile

    Put cards into a specific pile. It lets you organize hands or discard areas.

  2. 02 Capability

    Create new deck

    Make a standard 52 card deck. Use this to start a new game session.

  3. 03 Capability

    Create partial deck

    Build a deck with only specific cards. It is perfect for custom game setups.

  4. 04 Capability

    Draw cards

    Pull cards from a deck. Use this to deal hands to players.

Capability set02 / 04

05—07

3 capabilities in this set.

Part of 13 available through Deck of Cards API.

  1. 05 Capability

    Draw from pile bottom

    Take cards from the bottom of a pile. This is useful for specific game rules.

  2. 06 Capability

    Draw from pile random

    Grab random cards from a pile. Use this for unpredictable game events.

  3. 07 Capability

    Draw from pile

    Pull cards from a named pile. It helps manage cards that are not in the main deck.

Capability set03 / 04

08—10

3 capabilities in this set.

Part of 13 available through Deck of Cards API.

  1. 08 Capability

    List pile

    See every card in a specific pile. Use this to check player hands or discard lists.

  2. 09 Capability

    Return pile to deck

    Move cards from a pile back to the main deck. It cleans up the game state.

  3. 10 Capability

    Reshuffle deck

    Mix up an existing deck. This ensures the next draw is truly random.

Capability set04 / 04

11—13

3 capabilities in this set.

Part of 13 available through Deck of Cards API.

  1. 11 Capability

    Return to deck

    Put cards back into the main deck. Use this to reset cards after an action.

  2. 12 Capability

    Shuffle new deck

    Create a new deck that is already shuffled. You can even specify multiple decks.

  3. 13 Capability

    Shuffle pile

    Mix up the cards in a specific pile. This works for hands or discard areas.

Set up in minutes

One URL. Then ask Deck of Cards API to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Deck of Cards API from the conversation.

Choose your client

Live preview
Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP
https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp
  1. Step 01

    Open Connectors

    In Claude Web or Claude Desktop, open Settings and choose Connectors.

  2. Step 02

    Add the URL

    Choose Add custom connector, name it Deck of Cards API, and paste the URL above.

  3. Step 03

    Turn it on in chat

    Select +, open Connectors, and enable Deck of Cards API for the conversation.

Where the request belongs

Work Deck of Cards API can move forward.

Built around the request

Game developers tired of coding manual shuffling logic, data scientists running Monte Carlo simulations, and educators teaching probability.

01

Game Developer

Prototypes card game mechanics and logic quickly without building a custom backend.

02

Data Scientist

Runs probability simulations and Monte Carlo experiments using a standardized card API.

03

Educator

Creates interactive examples to teach students about probability and statistics.

Bring your own AI

Change the model, client or framework. Keep Deck of Cards API connected.

  • Claude
  • ChatGPT
  • Gemini
  • Cursor
  • VS Code
  • Windsurf
  • ZCode
  • Cline
  • Zed
  • Continue
  • Kiro
  • Roo Code
  • Zencoder
  • Goose
  • Void
  • Augment Code
  • Amp
  • Qodo
  • Tabnine
  • Pieces
  • Sourcegraph Cody
  • JetBrains
  • Warp
  • Amazon Q
  • Antigravity
  • BoltAI
  • Raycast
  • Jan
  • LM Studio
  • AnythingLLM
  • Open WebUI
  • Msty
  • Cherry Studio
  • LibreChat
  • TypingMind
  • Chorus
  • 5ire
  • n8n
  • LangChain
  • LlamaIndex
  • CrewAI
  • Vercel AI SDK

Before you connect

Questions about Deck of Cards API.

The practical details behind the request, access and result.

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 capability 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 capability 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 capability and set the deck_count parameter to 6. This will return a single deck_id containing 312 cards (52 * 6) in a randomized order.

One connection away

Give your agent a direct line to Deck of Cards API.

Connect Deck of Cards API once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available