Texas Holdem

Provides a Texas Holdem MCP server that lets agents play via MCP clients by running a local node server.

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "freshlife001-mcp_poker": {
      "command": "node",
      "args": [
        "/path/to/poker-mcp-server/dist/mcpServer.js"
      ],
      "env": {
        "DEBUG": "*"
      }
    }
  }
}

You can run a Texas Holdem poker MCP server that lets MCP client agents join a game, play hands, and interact with the game logic through a standard MCP interface. This server is built with Node.js and TypeScript and provides a complete game server, a client, and an MCP server adapter so you can control and automate play via MCP clients.

How to use

To use this server with an MCP client, start the local MCP server and configure your client to load the server tool. The client will then connect to the local server and you can participate in Texas Holdem games by issuing actions like bet, call, raise, or fold through the MCP interface.

How to install

Prerequisites: ensure you have Node.js installed on your machine. You can verify by running node -v and npm -v in your terminal.

Install dependencies and build the project.

/
```bash
npm install
npm run build

Run the Poker Server in development mode.

/
```bash
npm run dev

Open the Poker Client in your browser to start interacting with the game.

Access the client at the following URL once the server is running: http://localhost:3000/.

Configure your MCP client to add the server tool. Use the following configuration snippet to load the MCP server from your local build path.

/
```json
{
  "mcpServers": {
    "poker_mcp_server": {
      "command": "node",
      "args": ["/path/to/poker-mcp-server/dist/mcpServer.js"],
      "env": {
        "DEBUG": "*"
      }
    }
  }
}

Additional notes

If you want to try an example workflow, you may craft a prompt that designates a poker expert character and uses only the MCP server’s functions to participate in hands. For example: You are a Texas Hold'em poker expert. Please use the name "Super Awesome Pro" to join a Texas Hold'em poker game and win more chips. You can only use the functions provided by the poker-mcp-server MCP server. After joining the game, you must wait for your turn to act before proceeding to the next move.