The Game Crafter MCP Server

1# The Game Crafter MCP Server
2 
3[![npm](https://img.shields.io/npm/v/@alex-gon/tgc-mcp-server)](https://www.npmjs.com/package/@alex-gon/tgc-mcp-server)
4[![MCP Registry](https://img.shields.io/badge/MCP_Registry-active-green)](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.alex-gon/thegamecrafter)
5[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
6[![CI](https://github.com/alex-gon/thegamecrafter-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/alex-gon/thegamecrafter-mcp-server/actions)
7 
8An 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.
9 
10Browse the component catalog, create game projects, add card decks and boards, upload artwork, and get instant pricing estimates — all through your AI assistant.
11 
12## Who it's for
13 
14Indie 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.
15 
16## Prerequisites
17 
18- **Node.js** 18 or later
19- A **TGC account** — [sign up here](https://www.thegamecrafter.com/)
20- A **TGC API key** — [generate one here](https://www.thegamecrafter.com/account/apikeys)
21 
22## Installation
23 
24Add the server to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
25 
26```json
27{
28  "mcpServers": {
29    "thegamecrafter": {
30      "command": "npx",
31      "args": ["-y", "@alex-gon/tgc-mcp-server"],
32      "env": {
33        "TGC_API_KEY_ID": "your-api-key-id",
34        "TGC_USERNAME": "your-tgc-username",
35        "TGC_PASSWORD": "your-tgc-password"
36      }
37    }
38  }
39}
40```
41 
42Restart Claude Desktop. The server will be downloaded automatically and appear in your MCP connections.
43 
44<details>
45<summary>Alternative: install from source</summary>
46 
47```bash
48git clone https://github.com/alex-gon/thegamecrafter-mcp-server.git
49cd thegamecrafter-mcp-server
50npm install && npm run build
51```
52 
53Then use `"command": "node"` and `"args": ["/absolute/path/to/dist/index.js"]` in the config above.
54</details>
55 
56## Configuration
57 
58| Variable | Required | Description |
59|----------|----------|-------------|
60| `TGC_API_KEY_ID` | Yes | Your TGC API key ID |
61| `TGC_USERNAME` | Yes | Your TGC account username |
62| `TGC_PASSWORD` | Yes | Your TGC account password |
63| `TGC_API_BASE` | No | API base URL (defaults to `https://www.thegamecrafter.com/api`) |
64| `TGC_UPLOAD_BASE_DIR` | No | Restrict file uploads to this directory (defaults to working directory) |
65 
66See `.env.example` for a template.
67 
68## Available tools
69 
70### Tools
71 
72| Tool | Description | Auth |
73|------|-------------|------|
74| `authenticate` | Create a TGC session using stored credentials | No |
75| `logout` | Destroy the current TGC session | Yes |
76| `get_game_catalog` | Browse printable component types (cards, boards, boxes) | No |
77| `get_component_sizes` | Get pixel dimensions and finished inches for component types | No |
78| `get_component_details` | Get detailed info for a component type or game part | No |
79| `get_my_designers` | List designer profiles for the authenticated user | Yes |
80| `get_my_games` | List all games for a designer (paginated) | Yes |
81| `get_game_details` | Get full game info with components, files, and pricing | Yes |
82| `create_game` | Create a new game project under a designer | Yes |
83| `update_game` | Update a game's name, description, or visibility | Yes |
84| `delete_game` | Permanently delete a game project | Yes |
85| `add_component_to_game` | Add a printable component or stock part to a game | Yes |
86| `upload_file` | Upload an image to a TGC folder (from disk or URL) | Yes |
87| `get_pricing_estimate` | Get per-component cost breakdown for a game | Yes |
88 
89### Resources
90 
91| URI | Description |
92|-----|-------------|
93| `tgc://catalog` | Full catalog of printable component types (cached 30 min) |
94| `tgc://game/{id}/summary` | Complete summary of a game project |
95| `tgc://component-sizes` | Pixel dimensions for all component types (cached 30 min) |
96 
97### Prompts
98 
99| Prompt | Description |
100|--------|-------------|
101| `new_game_setup` | Guided workflow for creating a complete game project with components |
102| `estimate_game_cost` | Step-by-step cost estimation for an existing game |
103 
104## Example prompts
105 
106Try saying these to your AI assistant:
107 
108- "Show me all my games on The Game Crafter with their component lists"
109- "Create a new card game called Stellar Drift with a standard poker deck and tuck box"
110- "What pixel dimensions do I need for a poker card face image?"
111- "Upload this image and assign it as the front face of my card deck"
112- "Estimate the cost of my game based on its current components"
113- "Help me set up a new game project from scratch — walk me through it"
114- "What component types are available for board games?"
115- "Delete my test game project"
116 
117## Limitations
118 
119- **Rate limits** — The server enforces 3 requests/second to TGC (below their 4/sec limit) with per-session budgets of 500 reads and 200 writes.
120- **Authentication** — Uses environment variable credentials only. OAuth 2.1 support is planned for a future release with HTTP transport.
121- **File uploads** — Maximum 50 MB per file. Images must be between 50x50 and 10,000x10,000 pixels. Supported formats: PNG, JPG, GIF, BMP, TIFF, SVG, WebP, PDF.
122- **Transport** — Stdio only. HTTP/SSE transport planned for v2.
123- **Read-only catalog** — The component catalog and pricing come from TGC and cannot be modified.
124 
125## Contributing
126 
127Bug reports and pull requests are welcome. Please open an issue first to discuss what you'd like to change.
128 
129To run the development server:
130 
131```bash
132cp .env.example .env    # fill in your credentials
133npm run dev             # starts with tsx + hot reload
134npm test                # run the test suite
135```
136 
137## License
138 
139[MIT](LICENSE)
140