Repository avatar
Other Tools
v1.0.2
active

cards4play

com.cards4play/cards4play

Play Hearts, Spades, Euchre, Rook and more with friends or bots from your agent.

Documentation

Cards4Play MCP server

Metadata and connection documentation for the Cards4Play MCP server: a real card table your AI agent can join.

Cards4Play is a free online card table for classic trick-taking and melding games — Rook, Hearts, Euchre, Spades, Five Hundred, Bridge, Whist, Pitch, Pinochle, Canasta, Skat, Belote and more. A human invites an agent to the same table and both play their own hands.

Connect

Endpointhttps://cards4play.com/api/mcp
TransportStreamable HTTP
AuthOAuth 2.1 with dynamic client registration and PKCE
Scopesmcp:read, mcp:play
Guidehttps://cards4play.com/agent-play/

The server is remote only. There is no package to install; add the URL to an MCP client that supports remote servers and OAuth, sign in as the human who should own the agent, and approve the scopes.

OAuth metadata:

  • https://cards4play.com/.well-known/oauth-protected-resource
  • https://cards4play.com/api/.well-known/oauth-authorization-server

Tools

ToolWhat it does
cards4play_list_gamesLists supported games and rule sets
cards4play_get_rulesReturns a rules summary for a game and optional variant
cards4play_create_tableCreates an invite-only table for the human and the agent
cards4play_list_tablesLists the agent's tables
cards4play_accept_tableAccepts an invitation on the agent's behalf
cards4play_get_stateReturns the agent-safe snapshot, legalActions and advice
cards4play_get_adviceReturns the expert strategy's recommended action
cards4play_autoplayPlays one turn with the expert strategy
cards4play_submit_actionSubmits one legal action
cards4play_wait_for_turnWaits for the agent's next turn or a table change

Agents never see other players' hands, the stock, or the nest. They receive explicit legal actions rather than raw state, and every action is validated by the same rules engine humans play against.

Example prompt

Connect to the Cards4Play MCP server and use only the cards4play_* tools.
Create a Hearts table for me, tell me the game id, then wait while I accept in Cards4Play.
After I accept, play your turns with cards4play_autoplay and wait between turns.

Publishing

The server is published to the official MCP Registry under the com.cards4play namespace, verified by a DNS TXT record on cards4play.com. The canonical metadata is server.json in this repository.

Links

No installation packages available.

Remote