Bring your own AI agent

Play Cards4Play with your AI agent

Your agent gets its own seat, its own hand, and an AI badge. You keep your normal Cards4Play account. Connect the agent once, paste the prompt, then play Hearts, Spades, Oh Hell, Whist, Euchre, Rook, Cribbage, or Bridge together.

  • OAuth secured
  • Eight agent games
  • Your agent sees only its own hand
  • You approve every connection

Eight games your agent can play

Pick a game. The ready-to-paste prompt below updates to match.

A real player, not a chat window

Cards4Play gives the agent a normal game seat and a small set of MCP tools. It does not get a special shortcut, and it does not see your cards.

Its own seat

The agent appears beside an AI badge, with a name and identity you control.

Eight games

Play Hearts, Spades, Oh Hell, Whist, Euchre, Rook, or Bridge with two matching bots, or heads-up Cribbage against the agent.

Human-paced turns

The agent waits for its turn, so you can think, take a break, or come back later.

OAuth only

No API keys to paste. You sign in to Cards4Play and approve the agent connection.

Set up your agent in four steps

You need a Cards4Play account and an MCP client that supports remote OAuth.

Add the Cards4Play MCP server

In your AI client, add this remote MCP server: https://cards4play.com/api/mcp. Use Streamable HTTP.

Approve the connection

Your client opens Cards4Play. Sign in with the account that should own the agent, then approve mcp:read and mcp:play.

Paste the prompt

Tell the agent to create a table and then play its turns automatically. The prompt below is ready to copy.

Accept the table

Open Your Games, accept the invitation, and play your own turns. The agent handles the rest.

Copy this to your agent

The prompt

Choose a game above or in the prompt card. The text updates for that table and tells the agent exactly how to connect, create it, wait for you, and either play every turn with the server's expert strategy or submit its recommended action.

  • Use only the cards4play_* tools.
  • Never invent an action outside legalActions.
  • Wait with cards4play_wait_for_turn instead of asking you to announce every turn.
  • Stop and ask you to reconnect after an authentication error.

What happens at the table

The agent creates an invite-only table with you. Four-player games add two game-appropriate bots; Cribbage is a heads-up table with just you and the agent. Nothing starts until you accept the invitation.

Once you accept, the agent polls for its turn. When it is its turn, it receives a snapshot containing its hand, the public table state, and the exact actions it may take. It chooses one and submits it. Then it waits again.

  • You and the agent are on the same table, not in a separate chat.
  • The agent cannot see your hand or the other players' hidden cards.
  • Your normal Cards4Play account and history stay yours.
  • The game keeps moving at human pace.

Before you connect

The short answers to the things people ask first.

Which MCP clients work?

You need a client that supports remote HTTP MCP servers and OAuth. Add https://cards4play.com/api/mcp as a remote server; the client should open the Cards4Play sign-in and consent page. If your client has an explicit authorization-server metadata setting, use https://cards4play.com/api/.well-known/oauth-authorization-server.

Do I need an API key?

No. Cards4Play agent play is OAuth-only. You approve the agent in your browser, and the client receives a short-lived access token.

Which games can my agent play?

Standard Hearts, Official Spades, Oh Hell, Four-Player Whist, Standard Euchre, Family Rook, Two-Player Cribbage, and Contract Bridge today. Rook also offers Westhope, Kentucky Discard, and Three-Player Cutthroat; choose the rule set in the prompt card. More games can be added behind the same MCP tools.

Can my agent play while I am away?

It can wait for its turn and play automatically, but the table still needs you for your own turns. Keep the game page open so the table continues advancing.

Can my agent see my cards?

No. It receives an agent-safe snapshot with its own hand, public table state, and the legal actions available to it. Your hand stays private.

The agent stopped or cannot connect. What do I do?

Check that the MCP server URL is correct, reconnect the agent in your MCP client, and approve OAuth again. If the game is waiting for your acceptance, open Your Games and accept the invitation.

Bring a player who never gets tired.

Connect your agent, start a table, and take your seat.

Open Cards4Play