# alex-gon/thegamecrafter-mcp-server [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/alex-gon/thegamecrafter-mcp-server  
**GitHub Stars:** 3  
**npm Downloads (last month):** 264  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/alex-gon-thegamecrafter-mcp-server

## Description
Design, manage, and price tabletop games on The Game Crafter. Browse catalogs, create projects, upload artwork, get pricing.

## Tools
Capabilities this server exposes over MCP:

- **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 Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "thegamecrafter-mcp-server": {
    "command": "npx",
    "args": ["-y","@alex-gon/tgc-mcp-server"],
    "env": {
      "TGC_API_KEY_ID": "",
      "TGC_USERNAME": "",
      "TGC_PASSWORD": ""
    }
  }
}
```

**Requires environment variables:** `TGC_API_KEY_ID`, `TGC_USERNAME`, `TGC_PASSWORD` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What alex-gon/thegamecrafter-mcp-server MCP server does

The alex-gon/thegamecrafter-mcp-server MCP server connects an MCP client to The Game Crafter API for tabletop game project management. It covers the workflow from exploring available parts through creating a game, attaching components and artwork, reviewing project details, and estimating order costs.

Unauthenticated catalog operations include listing printable component types, checking component dimensions, and retrieving component details. Authenticated operations can identify the account’s designer profiles, list games for a designer, inspect a game, create or update projects, add components, upload files, estimate prices, and delete games. Deletion is permanent.

## How it works

The server supports local stdio transport and a hosted HTTP endpoint on Apify. For local use, an MCP client starts the npm package with npx. The server can read TGC credentials from environment variables; credentials may also be supplied to the authenticate tool, which is required for remote usage. The authenticate operation creates a TGC session, and logout ends it.

A typical project workflow starts by finding a designer, creating or selecting a game, and adding components from the catalog or by stock-part UUID. Component size information can be used to prepare artwork before upload. After components are present, the pricing tool returns per-component costs and totals for different order quantities. The server also exposes catalog, component-size, and game-summary resources, along with prompts for guided game setup and cost estimation.

## Setup and configuration

The local package requires Node.js 18 or newer, a TGC account, and a TGC API key. Configure `TGC_API_KEY_ID`, `TGC_USERNAME`, and `TGC_PASSWORD` for local stdio operation. `TGC_API_BASE` can override the default API URL, and `TGC_UPLOAD_BASE_DIR` can restrict uploads to a selected directory.

The documented local command is `npx -y @alex-gon/tgc-mcp-server`. The README also documents a hosted endpoint at `https://chillbot3000--tgc-mcp-server.apify.actor/mcp`; hosted usage does not require local installation but is billed per operation through Apify.

## Tools and capabilities

The alex-gon/thegamecrafter-mcp-server MCP server provides tools for:

- Browsing the TGC printable catalog and component specifications.
- Authenticating, ending sessions, and listing account designers and games.
- Creating, editing, inspecting, and permanently deleting game projects.
- Adding card decks, boards, boxes, and stock parts to games.
- Uploading image files from disk or a URL to a TGC folder.
- Calculating component-level and total prices for selected quantities.

Uploads are limited to 50 MB per file. Supported formats include PNG, JPG, GIF, BMP, TIFF, SVG, WebP, and PDF; images must be between 50×50 and 10,000×10,000 pixels.

## Limitations and notes

TGC requests are limited to three per second, with per-session budgets of 500 reads and 200 writes. Catalog data and pricing are read-only through this server. OAuth 2.1 is not currently supported; the documented authentication method uses TGC credentials and an API key. Hosted usage has a stated approximate cost of $0.09 per typical session under Apify’s pay-per-event model.

_Full upstream README: https://allmcps.com/mcp/alex-gon-thegamecrafter-mcp-server/readme_