The Game Crafter

io.github.alex-gonPublished by GitHub account alex-gonv0.1.1Updated Oct 24, 2026

Design, manage, and price tabletop games on The Game Crafter via MCP.

VerifiedSTDIODesktop onlyBusiness & CommerceMedia & Design

Overview

AI-generated overview

Connects an AI assistant to The Game Crafter so it can browse components, create and manage tabletop game projects, upload artwork and estimate pricing.

What you can do
Browse the printable component catalog, component sizes and component details, plus cached catalog resources and game summaries as resources and guided prompts for new game setup and cost estimation.
When to use it
Useful for indie board game designers and TGC users who want to set up, edit, price or clean up game projects and artwork through conversation instead of the TGC web interface.
Requirements
Local run via npx needs Node.js 18 or later and a TGC account with an API key. Required environment variables: TGC_API_KEY_ID, TGC_USERNAME and TGC_PASSWORD; optional TGC_API_BASE and TGC_UPLOAD_BASE_DIR. A hosted remote endpoint is also offered, with credentials passed to the authenticate tool.
Before you install
Requires the TGC account password in TGC_PASSWORD, a sensitive credential; prefer a dedicated API key and restrict uploads with TGC_UPLOAD_BASE_DIR. Tools can create, update and permanently delete game projects and upload files, and the hosted option is billed per operation through Apify.

Installation

In SourceWeft

  1. Open The Game Crafter in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

The Game Crafter MCP Server

[npm] [MCP Registry] [License: MIT] [CI] [alex-gon/thegamecrafter-mcp-server 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.

[The Game Crafter MCP server]

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

Installation

Option 1: Remote (hosted on Apify) — no install needed

Connect to the hosted server at:

https://chillbot3000--tgc-mcp-server.apify.actor/mcp

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):

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

Alternative: install from source
bash
git clone https://github.com/alex-gon/thegamecrafter-mcp-server.gitcd thegamecrafter-mcp-servernpm install && npm run build

Then use "command": "node" and "args": ["/absolute/path/to/dist/index.js"] in the config above.

Configuration

VariableRequiredDescription
TGC_API_KEY_IDYesYour TGC API key ID
TGC_USERNAMEYesYour TGC account username
TGC_PASSWORDYesYour TGC account password
TGC_API_BASENoAPI base URL (defaults to https://www.thegamecrafter.com/api)
TGC_UPLOAD_BASE_DIRNoRestrict file uploads to this directory (defaults to working directory)

See .env.example for a template.

Available tools

Tools

ToolDescriptionAuth
authenticateCreate a TGC session (accepts credentials as params or uses env vars)No
logoutDestroy the current TGC sessionYes
get_game_catalogBrowse printable component types (cards, boards, boxes)No
get_component_sizesGet pixel dimensions and finished inches for component typesNo
get_component_detailsGet detailed info for a component type or game partNo
get_my_designersList designer profiles for the authenticated userYes
get_my_gamesList all games for a designer (paginated)Yes
get_game_detailsGet full game info with components, files, and pricingYes
create_gameCreate a new game project under a designerYes
update_gameUpdate a game's name, description, or visibilityYes
delete_gamePermanently delete a game projectYes
add_component_to_gameAdd a printable component or stock part to a gameYes
upload_fileUpload an image to a TGC folder (from disk or URL)Yes
get_pricing_estimateGet per-component cost breakdown for a gameYes

Resources

URIDescription
tgc://catalogFull catalog of printable component types (cached 30 min)
tgc://game/{id}/summaryComplete summary of a game project
tgc://component-sizesPixel dimensions for all component types (cached 30 min)

Prompts

PromptDescription
new_game_setupGuided workflow for creating a complete game project with components
estimate_game_costStep-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 — Credentials can be passed as authenticate tool parameters (required for remote usage) or via environment variables (for local stdio). OAuth 2.1 support is planned for a future release.
  • 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 for local usage. Remote HTTP available via the hosted Apify endpoint.
  • 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:

bash
cp .env.example .env    # fill in your credentialsnpm run dev             # starts with tsx + hot reloadnpm test                # run the test suite

License

MIT

Source: README.md at commit 7a65a11

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts