# battlemap-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12 repo stars
- Author: thekannen
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thekannen/battlemap-mcp
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/battlemap-mcp

## What it 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.

## Install

### Claude Code (native platform)

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

## When to use it
- 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
- 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.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
