The Game Crafter
Design, manage, and price tabletop games on The Game Crafter via MCP.
★ 0MITother
Install
Config snippet generator goes here (5 client tabs)
README
# The Game Crafter MCP Server
[](https://www.npmjs.com/package/@alex-gon/tgc-mcp-server)
[](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.alex-gon/thegamecrafter)
[](LICENSE)
[](https://github.com/alex-gon/thegamecrafter-mcp-server/actions)
[](https://glama.ai/mcp/servers/alex-gon/thegamecrafter-mcp-server)
An MCP server that connects AI assistants to [The Game Crafter](https://www.thegamecrafter.com/) API, letting you design, manage, and price tabletop games through natural conversation.
Browse the component catalog, create game projects, add card decks and boards, upload artwork, and get instant pricing estimates — all through your AI assistant.
[](https://glama.ai/mcp/servers/alex-gon/thegamecrafter-mcp-server)
## Who it's for
Indie board game designers, tabletop creators, and TGC users who want to manage their projects through an AI assistant instead of navigating the TGC web interface manually.
## Prerequisites
- **Node.js** 18 or later
- A **TGC account** — [sign up here](https://www.thegamecrafter.com/)
- A **TGC API key** — [generate one here](https://www.thegamecrafter.com/account/apikeys)
## Installation
Add the server to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"mcpServers": {
"thegamecrafter": {
"command": "npx",
"args": ["-y", "@alex-gon/tgc-mcp-server"],
"env": {
"TGC_API_KEY_ID": "your-api-key-id",
"TGC_USERNAME": "your-tgc-username",
"TGC_PASSWORD": "your-tgc-password"
}
}
}
}
```
Restart Claude Desktop. The server will be downloaded automatically and appear in your MCP connections.
<details>
<summary>Alternative: install from source</summary>
```bash
git clone https://github.com/alex-gon/thegamecrafter-mcp-server.git
cd thegamecrafter-mcp-server
npm install && npm run build
```
Then use `"command": "node"` and `"args": ["/absolute/path/to/dist/index.js"]` in the config above.
</details>
## Configuration
| Variable | Required | Description |
|----------|----------|-------------|
| `TGC_API_KEY_ID` | Yes | Your TGC API key ID |
| `TGC_USERNAME` | Yes | Your TGC account username |
| `TGC_PASSWORD` | Yes | Your TGC account password |
| `TGC_API_BASE` | No | API base URL (defaults to `https://www.thegamecrafter.com/api`) |
| `TGC_UPLOAD_BASE_DIR` | No | Restrict file uploads to this directory (defaults to working directory) |
See `.env.example` for a template.
## Available tools
### Tools
| Tool | Description | Auth |
|------|-------------|------|
| `authenticate` | Create a TGC session using stored credentials | No |
| `logout` | Destroy the current TGC session | Yes |
| `get_game_catalog` | Browse printable component types (cards, boards, boxes) | No |
| `get_component_sizes` | Get pixel dimensions and finished inches for component types | No |
| `get_component_details` | Get detailed info for a component type or game part | No |
| `get_my_designers` | List designer profiles for the authenticated user | Yes |
| `get_my_games` | List all games for a designer (paginated) | Yes |
| `get_game_details` | Get full game info with components, files, and pricing | Yes |
| `create_game` | Create a new game project under a designer | Yes |
| `update_game` | Update a game's name, description, or visibility | Yes |
| `delete_game` | Permanently delete a game project | Yes |
| `add_component_to_game` | Add a printable component or stock part to a game | Yes |
| `upload_file` | Upload an image to a TGC folder (from disk or URL) | Yes |
| `get_pricing_estimate` | Get per-component cost breakdown for a game | Yes |
### Resources
| URI | Description |
|-----|-------------|
| `tgc://catalog` | Full catalog of printable component types (cached 30 min) |
| `tgc://game/{id}/summary` | Complete summary of a game project |
| `tgc://component-sizes` | Pixel dimensions for all component types (cached 30 min) |
### Prompts
| Prompt | Description |
|--------|-------------|
| `new_game_setup` | Guided workflow for creating a complete game project with components |
| `estimate_game_cost` | Step-by-step cost estimation for an existing game |
## Example prompts
Try saying these to your AI assistant:
- "Show me all my games on The Game Crafter with their component lists"
- "Create a new card game called Stellar Drift with a standard poker deck and tuck box"
- "What pixel dimensions do I need for a poker card face ima