@doublehitgames/gdd-mcp

MCP server for GDD Manager — lets Claude (and other MCP-compatible AI assistants) read and write your game design documents.

This is the stdio transport, meant for local clients like Claude Desktop and Claude Code. It runs on your machine and talks to the GDD Manager REST API using a personal API key.

Prefer zero-setup? If you use claude.ai or Claude Desktop, you can connect via the remote server with OAuth instead — no install, no key. Add a custom connector pointing to https://gdd-app.vercel.app/api/mcp and authorize with your account. Use this npm package only when you specifically want the local/stdio route (e.g. Claude Code, scripts, or working without a browser login).

Requirements

• Node.js 18+
• A GDD Manager API key (gdd_sk_...) — generate one at https://gdd-app.vercel.app/settings/api-keys

Claude Desktop

Add this to your claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gdd-manager": {
      "command": "npx",
      "args": ["-y", "@doublehitgames/gdd-mcp"],
      "env": {
        "GDD_API_KEY": "gdd_sk_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. In a new chat, try: "List my GDD projects".

Claude Code

claude mcp add gdd-manager -e GDD_API_KEY=gdd_sk_your_key_here -- npx -y @doublehitgames/gdd-mcp

Configuration

| Variable | Required | Default | Description | | --- | --- | --- | --- | | GDD_API_KEY | yes | — | Your personal API key (gdd_sk_...). | | GDD_API_URL | no | https://gdd-app.vercel.app | Base URL of the GDD Manager API (override for self-hosting). |

What it exposes

• Projects, sections, and addons — full CRUD (list, read, create, update, delete).
• Typed addon tools for each addon type (currency, inventory, economy link, progression table, production, data schema, attributes, and more), so the assistant fills the right fields.
• Search across your projects and sections.
• Prompts — ready-made flows like listing projects, viewing a project, and analyzing a GDD.

The key scopes access to your own projects — the assistant only sees what your account can see.

Links

• GDD Manager: https://gdd-app.vercel.app
• Manage API keys: https://gdd-app.vercel.app/settings/api-keys

License

MIT