alex-gon/thegamecrafter-mcp-server

An MCP server that connects AI assistants to The Game Crafter 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.
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
- A **TGC API key** — generate one here
Installation
Option 1: Remote (hosted on Apify) — no install needed
Connect to the hosted server at:
No local setup required. Provide your TGC credentials when you call the authenticate tool. Usage is billed per operation via Apify's pay-per-event model (~$0.09 per typical session).
Also available on Glama Connectors.
Option 2: Local (via npx)
Add the server to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
Restart Claude Desktop. The server will be downloaded automatically and appear in your MCP connections.
Alternative: install from source
Then use "command": "node" and "args": ["/absolute/path/to/dist/index.js"] in the config above.
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 (accepts credentials as params or uses env vars) | 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) |