{
  "markdown": "# The Game Crafter MCP Server\n\n[![npm](https://img.shields.io/npm/v/@alex-gon/tgc-mcp-server)](https://www.npmjs.com/package/@alex-gon/tgc-mcp-server)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-active-green)](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.alex-gon/thegamecrafter)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![CI](https://github.com/alex-gon/thegamecrafter-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/alex-gon/thegamecrafter-mcp-server/actions)\n[![alex-gon/thegamecrafter-mcp-server MCP server](https://glama.ai/mcp/servers/alex-gon/thegamecrafter-mcp-server/badges/score.svg)](https://glama.ai/mcp/servers/alex-gon/thegamecrafter-mcp-server)\n\nAn MCP server that connects AI assistants to [The Game Crafter](https://www.thegamecrafter.com/) API, letting you design, manage, and price tabletop games through natural conversation.\n\nBrowse the component catalog, create game projects, add card decks and boards, upload artwork, and get instant pricing estimates — all through your AI assistant.\n\n[![The Game Crafter MCP server](https://glama.ai/mcp/servers/alex-gon/thegamecrafter-mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/alex-gon/thegamecrafter-mcp-server)\n\n## Who it's for\n\nIndie 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.\n\n## Prerequisites\n\n- **Node.js** 18 or later\n- A **TGC account** — [sign up here](https://www.thegamecrafter.com/)\n- A **TGC API key** — [generate one here](https://www.thegamecrafter.com/account/apikeys)\n\n## Installation\n\n### Option 1: Remote (hosted on Apify) — no install needed\n\nConnect to the hosted server at:\n\n```\nhttps://chillbot3000--tgc-mcp-server.apify.actor/mcp\n```\n\nNo 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).\n\nAlso available on [Glama Connectors](https://glama.ai/mcp/connectors).\n\n### Option 2: Local (via npx)\n\nAdd the server to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"thegamecrafter\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@alex-gon/tgc-mcp-server\"],\n      \"env\": {\n        \"TGC_API_KEY_ID\": \"your-api-key-id\",\n        \"TGC_USERNAME\": \"your-tgc-username\",\n        \"TGC_PASSWORD\": \"your-tgc-password\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The server will be downloaded automatically and appear in your MCP connections.\n\n<details>\n<summary>Alternative: install from source</summary>\n\n```bash\ngit clone https://github.com/alex-gon/thegamecrafter-mcp-server.git\ncd thegamecrafter-mcp-server\nnpm install && npm run build\n```\n\nThen use `\"command\": \"node\"` and `\"args\": [\"/absolute/path/to/dist/index.js\"]` in the config above.\n</details>\n\n## Configuration\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `TGC_API_KEY_ID` | Yes | Your TGC API key ID |\n| `TGC_USERNAME` | Yes | Your TGC account username |\n| `TGC_PASSWORD` | Yes | Your TGC account password |\n| `TGC_API_BASE` | No | API base URL (defaults to `https://www.thegamecrafter.com/api`) |\n| `TGC_UPLOAD_BASE_DIR` | No | Restrict file uploads to this directory (defaults to working directory) |\n\nSee `.env.example` for a template.\n\n## Available tools\n\n### Tools\n\n| Tool | Description | Auth |\n|------|-------------|------|\n| `authenticate` | Create a TGC session (accepts credentials as params or uses env vars) | No |\n| `logout` | Destroy the current TGC session | Yes |\n| `get_game_catalog` | Browse printable component types (cards, boards, boxes) | No |\n| `get_component_sizes` | Get pixel dimensions and finished inches for component types | No |\n| `get_component_details` | Get detailed info for a component type or game part | No |\n| `get_my_designers` | List designer profiles for the authenticated user | Yes |\n| `get_my_games` | List all games for a designer (paginated) | Yes |\n| `get_game_details` | Get full game info with components, files, and pricing | Yes |\n| `create_game` | Create a new game project under a designer | Yes |\n| `update_game` | Update a game's name, description, or visibility | Yes |\n| `delete_game` | Permanently delete a game project | Yes |\n| `add_component_to_game` | Add a printable component or stock part to a game | Yes |\n| `upload_file` | Upload an image to a TGC folder (from disk or URL) | Yes |\n| `get_pricing_estimate` | Get per-component cost breakdown for a game | Yes |\n\n### Resources\n\n| URI | Description |\n|-----|-------------|\n| `tgc://catalog` | Full catalog of printable component types (cached 30 min) |\n| `tgc://game/{id}/summary` | Complete summary of a game project |\n| `tgc://component-sizes` | Pixel dimensions for all component types (cached 30 min) |\n\n### Prompts\n\n| Prompt | Description |\n|--------|-------------|\n| `new_game_setup` | Guided workflow for creating a complete game project with components |\n| `estimate_game_cost` | Step-by-step cost estimation for an existing game |\n\n## Example prompts\n\nTry saying these to your AI assistant:\n\n- \"Show me all my games on The Game Crafter with their component lists\"\n- \"Create a new card game called Stellar Drift with a standard poker deck and tuck box\"\n- \"What pixel dimensions do I need for a poker card face image?\"\n- \"Upload this image and assign it as the front face of my card deck\"\n- \"Estimate the cost of my game based on its current components\"\n- \"Help me set up a new game project from scratch — walk me through it\"\n- \"What component types are available for board games?\"\n- \"Delete my test game project\"\n\n## Limitations\n\n- **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.\n- **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.\n- **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.\n- **Transport** — Stdio for local usage. Remote HTTP available via the [hosted Apify endpoint](https://chillbot3000--tgc-mcp-server.apify.actor/mcp).\n- **Read-only catalog** — The component catalog and pricing come from TGC and cannot be modified.\n\n## Contributing\n\nBug reports and pull requests are welcome. Please open an issue first to discuss what you'd like to change.\n\nTo run the development server:\n\n```bash\ncp .env.example .env    # fill in your credentials\nnpm run dev             # starts with tsx + hot reload\nnpm test                # run the test suite\n```\n\n## License\n\n[MIT](LICENSE)",
  "bytes": 6899,
  "sha": "c3155c0cb08f70c329b0a30b15c8530f6a54fa31a1aab1f3c9feef53e7d04853",
  "repo_slug": "alex-gon/thegamecrafter-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_alex_gon_thegamecrafter_c7b8095a/readme"
}