battlemap-mcp

An AI collaborator for your Dungeondraft maps: a local bridge that lets your AI assistant (Claude Desktop, Claude Code, Codex, OpenCode, or any other MCP client) build, inspect, and refine the map you have open, using assets you already own.

Documentation: knownframe.com/battlemap-mcp/docs

<img src="docs/media/tavern-build.gif" alt="An AI agent building a tavern interior in Dungeondraft, sped up" width="100%">

_{Sped up 11×; the full build took about five minutes.}

Support creators first

This is a local automation layer for your own Dungeondraft map-making session. It does not generate original assets or art for you; it drives what you already own in Dungeondraft. Please buy and support Dungeondraft, and support the artists whose asset packs you use.

What you can make

Build a whole map from a brief, plan an encounter together, furnish one room, export to or rebuild from a Universal VTT file, or hand off tedious placement. See example prompts.

Get started

You need Dungeondraft 1.2.0.1 and an AI app that can run local MCP servers, on the same computer. Follow Get started, then the Windows, macOS or Linux guide. Downloads are on the Releases page.

<a id="5-include-your-asset-packs"></a>

Include your asset packs

See Include your asset packs.

Install from Claude

Use the Claude desktop extension or the Claude Code plugin: see Install from Claude.

Platform limits

See Platform limits.

If something does not work

See Troubleshooting.

Documentation

• Example prompts
• Tool reference: every tool, generated from the server
• Technical reference · Known limitations
• Privacy · Legal and attribution

For contributors: Bridge protocol, Developer installation, Building releases, Contributing, Changelog.

Affiliation and legal

battlemap-mcp is an independent, unofficial project and is not sponsored, operated, or endorsed by Megasploot or Tailwind Games, LLC. It does not include or redistribute Dungeondraft software, maps, or art assets. See Legal and attribution.