Deck of Cards API Connector for AI agents.
13 live capabilities
Manage playing card mechanics and probability simulations for games.
Waiting for input…
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.
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
- Real-world use case 01
Blackjack Prototype
A developer asks the agent to deal 6 decks.
- Real-world use case 02
Probability Study
A scientist needs a Monte Carlo simulation.
- 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.
01—04
4 capabilities in this set.
Part of 13 available through Deck of Cards API.
- 01 Capability
Add to pile
Put cards into a specific pile. It lets you organize hands or discard areas.
- 02 Capability
Create new deck
Make a standard 52 card deck. Use this to start a new game session.
- 03 Capability
Create partial deck
Build a deck with only specific cards. It is perfect for custom game setups.
- 04 Capability
Draw cards
Pull cards from a deck. Use this to deal hands to players.
05—07
3 capabilities in this set.
Part of 13 available through Deck of Cards API.
- 05 Capability
Draw from pile bottom
Take cards from the bottom of a pile. This is useful for specific game rules.
- 06 Capability
Draw from pile random
Grab random cards from a pile. Use this for unpredictable game events.
- 07 Capability
Draw from pile
Pull cards from a named pile. It helps manage cards that are not in the main deck.
08—10
3 capabilities in this set.
Part of 13 available through Deck of Cards API.
- 08 Capability
List pile
See every card in a specific pile. Use this to check player hands or discard lists.
- 09 Capability
Return pile to deck
Move cards from a pile back to the main deck. It cleans up the game state.
- 10 Capability
Reshuffle deck
Mix up an existing deck. This ensures the next draw is truly random.
11—13
3 capabilities in this set.
Part of 13 available through Deck of Cards API.
- 11 Capability
Return to deck
Put cards back into the main deck. Use this to reset cards after an action.
- 12 Capability
Shuffle new deck
Create a new deck that is already shuffled. You can even specify multiple decks.
- 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 previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Deck of Cards API, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Deck of Cards API for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Deck of Cards API URL.
- Step 03
Save and start
Save the connection and enable Deck of Cards API in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"deck-of-cards": {
"url": "https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Deck of Cards API
Open Agent mode in chat and ask: "Using Deck of Cards API, help me...". 13 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"deck-of-cards": {
"url": "https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Deck of Cards API
Ask Copilot: "Using Deck of Cards API, help me...". 13 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"deck-of-cards": {
"url": "https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Deck of Cards API
Open Cascade and ask: "Using Deck of Cards API, help me...". 13 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"deck-of-cards": {
"url": "https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Deck of Cards API
Ask Cline: "Using Deck of Cards API, help me...". 13 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add deck-of-cards --transport http "https://edge.vinkius.com/vk_preview_ppGGatZULo8V8oGVrPXqMiye2E9qZMCChBXawpaI/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Deck of Cards API
Ask Claude: "Using Deck of Cards API, show me...". 13 tools are ready
Where the request belongs
Work Deck of Cards API can move forward.
Game developers tired of coding manual shuffling logic, data scientists running Monte Carlo simulations, and educators teaching probability.
Game Developer
Prototypes card game mechanics and logic quickly without building a custom backend.
Data Scientist
Runs probability simulations and Monte Carlo experiments using a standardized card API.
Educator
Creates interactive examples to teach students about probability and statistics.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsYu-Gi-Oh
Access the ultimate Yu-Gi-Oh! database. search for cards, explore archetypes, and check set lists directly from your AI agent.
Scryfall
Access the ultimate Magic: The Gathering database. search cards, fetch rulings, and explore sets directly from your AI agent.
TarotAPI
Draw tarot cards, get readings, and explore card meanings via AI.
Pokemon TCG
Search and browse the entire Pokemon Trading Card Game database. find specific cards, explore sets, and filter by types or rarities.
Tarot Card Drawer
A cryptographically secure random generator for Tarot card draws, spreads, and deck analysis.
Card Draw Probability Calculator
Calculate the mathematical likelihood of drawing specific cards in TCGs like Magic: The Gathering or Yu-Gi-Oh.
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