The Game Crafter

by alex-gon

287 downloads

Not rated

GitHub

About

MCP server for The Game Crafter's print-on-demand platform. Browse component catalogs, create game projects, add card decks and boards, upload artwork, and get instant pricing estimates.

Details

Author: alex-gon
Downloads: 287
Categories: Developer Tools, Other, Automation, Media, Design

- Browse component catalog and get pixel dimensions
- Create, update, and delete game projects
- Add printable components and stock parts to games
- Upload artwork to TGC folders (up to 50 MB)
- Get per-component cost breakdowns for games
- Guided workflows via new_game_setup and estimate_game_cost prompts

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name The Game Crafter

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

From the repository

Add the server to your Claude Desktop configuration using npx -y @alex-gon/tgc-mcp-server and setting the required environment variables (TGC_API_KEY_ID, TGC_USERNAME, TGC_PASSWORD). Restart Claude Desktop—the server will be downloaded automatically. Available tools include authenticate, create_game, get_game_catalog, get_pricing_estimate, and upload_file, among others.

`get_game_catalog`

Browse TGC printable component types (cards, boards, boxes, etc.). No authentication required.

`authenticate`

Create a TGC session. Provide your TGC credentials (api_key_id, username, password) to authenticate. All three are required for remote usage. Local users with environment variables configured can omit them.

`logout`

Destroy the current TGC session.

`get_my_designers`

List designer profiles for the authenticated user. Returns designer ID, name, and user ID. Use the designer_id with get_my_games or create_game. Requires authentication.

`get_my_games`

List all games for a designer with name, ID, and status. Returns paginated results. Requires a designer_id from get_my_designers. Requires authentication.

`get_game_details`

Get full game info including name, description, component list with quantities, file references, and pricing. Use this to review a game before making changes. Requires authentication.

`create_game`

Create a new game project under a designer. Requires authentication.

`add_component_to_game`

Add a printable component (card deck, board, box, etc.) or stock part to a game. Use a catalog identity (e.g., 'BridgeDeck') for printable components, or a stock part UUID. Requires authentication.

`upload_file`

Upload an image file to a TGC folder for use in a game component. This is a heavyweight operation — avoid calling repeatedly in quick succession. Requires authentication.

`get_component_sizes`

Get pixel dimensions (width, height, bleed, safe zone) and finished inches for TGC component types. Use this to determine correct image sizes before uploading artwork. No authentication required.

`get_pricing_estimate`

Get per-component cost breakdown and total price for a game at various order quantities. The game must have components added first via add_component_to_game. Requires authentication.

`update_game`

Update a game's name, description, or visibility. Requires authentication.

`get_component_details`

Get detailed information about a component type by catalog identity (e.g., 'BridgeDeck') or a game part by UUID.

`delete_game`

Permanently delete a game project. This action cannot be undone.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "the game crafter": {
            "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"
                }
            }
        }
    }
}

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"
        }
    }
}

The Game Crafter 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

Add the server to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "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>

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 image?"
- "Upload this image and assign it as the front face of my card deck"
- "Estimate the cost of my game based on its current components"
- "Help me set up a new game project from scratch — walk me through it"
- "What component types are available for board games?"
- "Delete my test game project"

Limitations

- 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.
- Authentication — Uses environment variable credentials only. OAuth 2.1 support is planned for a future release with HTTP transport.
- 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.
- Transport — Stdio only. HTTP/SSE transport planned for v2.
- Read-only catalog — The component catalog and pricing come from TGC and cannot be modified.

Contributing

Bug reports and pull requests are welcome. Please open an issue first to discuss what you'd like to change.

To run the development server:

cp .env.example .env    # fill in your credentials
npm run dev             # starts with tsx + hot reload
npm test                # run the test suite

License

MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_game_catalog

authenticate

logout

get_my_designers

get_my_games

get_game_details

create_game

add_component_to_game

upload_file

get_component_sizes

get_pricing_estimate

update_game

get_component_details

delete_game

Claude Desktop / Cursor

McpServers

The Game Crafter MCP Server

Who it's for

Prerequisites

Installation

Configuration

Available tools

Tools

Resources

Prompts

Example prompts

Limitations

Contributing

License

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sequential Thinking

Sentry

Github

`get_game_catalog`

`authenticate`

`logout`

`get_my_designers`

`get_my_games`

`get_game_details`

`create_game`

`add_component_to_game`

`upload_file`

`get_component_sizes`

`get_pricing_estimate`

`update_game`

`get_component_details`

`delete_game`