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.
LABSCO SUMMARY
get_component_sizes saves the most work of anything here, and it needs no account at all.
Width, height, bleed and safe zone in pixels with the finished size in inches is precisely what has to be known before artwork is made, because getting it wrong means redrawing rather than re-uploading. It sits beside get_game_catalog, which also needs no authentication, so the design research can happen before an account is involved at all. Two operations carry their own cautions worth respecting: upload_file is described as heavyweight and not for repeated calls in quick succession, and delete_game states that it cannot be undone. get_pricing_estimate depends on components already being added, so pricing is a step after assembly rather than a lookup before it.
What it is
A Game Crafter client with 14 tools covering session authentication, the printable component catalog and its exact dimensions, designer and game management, component assembly and file upload, and pricing estimates.
What you get
- get_game_catalog browses the printable component types — cards, boards, boxes and the rest — and needs no authentication.
- get_component_sizes returns a component type's pixel dimensions with width, height, bleed and safe zone, plus its finished size in inches, and also needs no authentication.
- Session handling as tools: authenticate creates a session from an api key id, username and password, and logout destroys it.
- Game management: get_my_designers, get_my_games by designer with paging, create_game under a designer, get_game_details with the component list, quantities, file references and pricing, update_game for name, description and visibility, and delete_game, which cannot be undone.
- add_component_to_game adds a printable component by catalog identity such as BridgeDeck, or a stock part by UUID, with a quantity.
- upload_file uploads an image to a folder for use in a component; the vendor describes it as heavyweight and asks that it not be called repeatedly in quick succession.
- get_pricing_estimate returns a per-component cost breakdown and the total price at various order quantities, once components have been added.
- get_component_details returns information about a component type by catalog identity or a game part by UUID.
Requirements
The Game Crafter credentials a session needs — an api key id, a username and a password, supplied as TGC_API_KEY_ID, TGC_USERNAME and TGC_PASSWORD, or passed to authenticate directly. The catalog and component-size reads work without a session.
Setup effort
One command plus a key — npx -y @alex-gon/tgc-mcp-server, then supply credentials
USE CASES
01
Sizing artwork correctly before drawing any of it
Bleed and safe zone in pixels are what decide whether a design survives printing, and both reads work without an account.
02
Setting up a new game project
A game belongs to a designer, so resolving the designer id comes before creating anything.
03
Assembling the components a game needs
Components go in by catalog identity or as a stock part UUID with a quantity, and the game detail read shows the assembled list.
04
Getting artwork onto a component
Uploads are described as heavyweight and not to be repeated in quick succession, so batching the artwork rather than looping matters.
05
Working out what a print run would cost
Pricing needs components already added, and it comes back per component and in total across several order quantities.
14 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
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.
create_game
Create a new game project under a designer. Requires authentication.
delete_game
Permanently delete a game project. This action cannot be undone.
get_component_details
Get detailed information about a component type by catalog identity (e.g., 'BridgeDeck') or a game part by UUID.
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_game_catalog
Browse TGC printable component types (cards, boards, boxes, etc.). No authentication required.
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.
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_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.
logout
Destroy the current TGC session.
update_game
Update a game's name, description, or visibility. 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.
BEFORE YOU INSTALL
What to know first
Tools you get
14 tools when we connected. On the hosted route, authenticate takes your credentials as parameters. Only authenticate, get_game_catalog, get_component_sizes and get_component_details work without a session.
Requires
- npx on PATH
- Node.js 18 or later
Where it runs
Of the 3 documented setups, 2 run the server on your machine and 1 connects to a hosted endpoint.
CONTEXT COST
Light Standing cost
Rated by the size of the 14 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
npx
TERMINAL
npx -y @alex-gon/tgc-mcp-serverHosted endpoint
ENDPOINT URL
https://chillbot3000--tgc-mcp-server.apify.actor/mcpAdd this hosted endpoint to your MCP client using the credentials listed under Requirements.
MCP Clients
Any MCP client — hosted
ANY MCP CLIENT — HOSTED · JSON
{
"mcpServers": {
"thegamecrafter-mcp-server": {
"url": "https://chillbot3000--tgc-mcp-server.apify.actor/mcp"
}
}
}Provide your TGC credentials when you call the authenticate tool
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"thegamecrafter": {
"command": "npx",
"args": [
"-y",
"@alex-gon/tgc-mcp-server"
],
"env": {
"TGC_API_KEY_ID": "<YOUR_TGC_API_KEY_ID>",
"TGC_USERNAME": "<YOUR_TGC_USERNAME>",
"TGC_PASSWORD": "<YOUR_TGC_PASSWORD>"
}
}
}
}Claude Desktop — local build
CLAUDE DESKTOP — LOCAL BUILD · JSON
{
"mcpServers": {
"thegamecrafter-mcp-server": {
"command": "node",
"args": [
"<YOUR_PATH_TO_DIST>/index.js"
]
}
}
}
