Skip to main content
MCP server CX Codex

battlemap-mcp — Claude Code MCP server: maps and setup

The battlemap-mcp Claude Code MCP server lets an AI assistant work on an open Dungeondraft map through a local connection. It can build from a brief, furnish a room, or place objects.

MIT ★ 12 updated 2026-11-15

Open on GitHub

What battlemap-mcp does

battlemap-mcp connects an AI assistant to the map currently open in Dungeondraft. The assistant can create or edit the map with asset packs already available in the app, furnish a room, or take on object placement. Maps can also be exported to Universal VTT or rebuilt from a Universal VTT file.

The setup requires Dungeondraft 1.2.0.1 and an app that supports local MCP servers, running on the same computer. The assets must already be available in Dungeondraft; the server does not create new artwork or asset packs. When loaded, it recognizes Unofficial Patch, Custom Snap Mod, Soft Shadows, and Sketch Tool. Some mod-specific actions depend on the mod version.

What it helps with

  • build a map from a short brief
  • furnish a room for an encounter
  • export a map to Universal VTT or rebuild one from a file
  • delegate object placement to an assistant

Example prompts for the agent

  • Build a tavern map in Dungeondraft from this description.
  • Furnish the encounter room and place objects on the grid.
  • Create a map from this Universal VTT file.

How to install battlemap-mcp

Install

The MCP registry has no launch command for it: see the repository README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about battlemap-mcp

How do I install battlemap-mcp in Claude Code?

Download a battlemap-mcp release, then follow the Get started guide and the instructions for your operating system. Setup uses a local MCP client.

What does battlemap-mcp do?

It connects an AI assistant to the open Dungeondraft map so the assistant can build or edit it with assets already available in the app. It also supports Universal VTT export and map creation from a Universal VTT file.

What does battlemap-mcp need to run?

It requires Dungeondraft 1.2.0.1 and an app that can run local MCP servers; both must run on the same computer.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open