Thegamecrafter MCP Server

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.