battlemap-mcp docs
battlemap-mcp is 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 in Dungeondraft, using assets you already own. It does not generate art; please support Dungeondraft and the artists whose work it drives. About battlemap-mcp has a demo video and an overview.
Start here
Section titled “Start here”Get startedWhat you need, and the install guide for Windows, macOS or Linux.
Install from ClaudeThe Claude desktop extension or the Claude Code plugin.
Include your asset packsMaps come out noticeably better with them.
Example promptsBuild a whole map, develop one room, or hand off a tedious job.
Get started
Section titled “Get started”- Get started: what you need and how to connect.
- Install on Windows, macOS or Linux
- Install from Claude
- Other AI clients: manual setup for Codex, Claude Code, OpenCode and any STDIO MCP client.
Use battlemap-mcp
Section titled “Use battlemap-mcp”Reference
Section titled “Reference”- Technical reference: how it connects, working with maps, local state and environment variables.
- Tool reference: every tool your assistant can call, with its parameters.
- Troubleshooting
- Known limitations
- Privacy and the battlemap-mcp privacy policy
- Legal and attribution: battlemap-mcp is independent and unofficial, and not endorsed by Megasploot or Tailwind Games, LLC.
- Bugs and feature requests: open an issue. Release notes are with each release.
battlemap-mcp is open source (MIT). Source code is on GitHub; to contribute, see CONTRIBUTING.md.