How do I use TDC MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@TDC MCP Server search for tokens with fire damage and healing abilities" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

TDC MCP Server

An MCP server that exposes True Dungeon Companion game data — tokens, set/group bonuses, and rulebook pages — as tools for Claude and other MCP clients.

Tools

Tool	Description
`search_tokens`	Search tokens by name, slot, rarity, or class
`advanced_search_tokens`	Build arbitrary AND/OR filter trees across 29 fields (abilities, stats, damage, etc.)
`get_token`	Get full detail for a single token (effects, slots, damage wheel, etc.)
`list_set_bonuses`	List all set bonuses with tier effects
`list_group_bonuses`	List all group bonuses with tier effects
`list_rulebook_pages`	List all rulebook pages (title + path)
`get_rulebook_page`	Get the full text content of a rulebook page

Quick start (npx)

No install or build needed. Add to your .claude/settings.json:

{
  "mcpServers": {
    "tdc": {
      "command": "npx",
      "args": ["@tdcompanion/mcp-server"],
      "env": {
        "TDC_API_KEY": "tdc_live_<your-key>"
      }
    }
  }
}

Environment variables

Variable	Default	Description
`TDC_API_BASE_URL`	`https://tdcompanion.app`	API base URL
`TDC_API_KEY`	(none)	Optional bearer key for higher rate limits (600 req/min vs 60)

The server works without an API key (anonymous access), but authenticated keys get 10x the rate limit. Generate one from your profile's Developer tab at https://tdcompanion.app/profile.

Development

cd src/MCP/@tdcompanion/mcp-server
npm install
npm run build     # compile TypeScript → dist/
npm start         # run locally via stdio

Publishing

npm run build
npm publish

The prepublishOnly script runs the build automatically. The files field in package.json ensures only dist/ is included in the published package.