battlemap-mcp
Drive Dungeondraft from an AI assistant to build and edit battle maps with your assets
- Pricing
- Open source
- Platforms
- Windows, macOS, Linux
- Runs
- Locally
- Version
- 1.4.3
- Listing updated
- 3 days ago
About battlemap-mcp
battlemap-mcp is an open-source MCP server for games and play. It runs locally on your machine and is started by your AI client.
Map-making in Dungeondraft can be tedious at scale, and this bridge lets an AI client place rooms, terrain, furniture and lighting in the map you already have open. It does not generate art. It only uses assets installed in your Dungeondraft, and the README asks users to support the artists behind them.
The setup has a Dungeondraft mod and a companion program from the same release; the companion connects your MCP client to the mod over a local connection. Dungeondraft 1.2.0.1 and a client that runs local MCP servers on the same computer are required. It also detects some community mods, such as Unofficial Patch, Custom Snap Mod, Soft Shadows and Sketch Tool, and adapts, for instance by reading a hex grid or keeping sketch notes out of exports.
Tasks include building a map from a brief, planning an encounter, furnishing a room, and exporting to or rebuilding from a Universal VTT file. The project states it has no accounts, telemetry or analytics, apart from an optional daily release check.
Install
Run in a terminal
claude mcp add battlemap-mcp -- npx -y https://github.com/thekannen/battlemap-mcp/releases/download/v1.4.3/battlemap-mcp-1.4.3.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"battlemap-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/thekannen/battlemap-mcp/releases/download/v1.4.3/battlemap-mcp-1.4.3.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"battlemap-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/thekannen/battlemap-mcp/releases/download/v1.4.3/battlemap-mcp-1.4.3.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"battlemap-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/thekannen/battlemap-mcp/releases/download/v1.4.3/battlemap-mcp-1.4.3.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"battlemap-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/thekannen/battlemap-mcp/releases/download/v1.4.3/battlemap-mcp-1.4.3.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"battlemap-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/thekannen/battlemap-mcp/releases/download/v1.4.3/battlemap-mcp-1.4.3.mcpb"
]
}
}
}What it does
- Uses your own assets
- Works with packs already installed in Dungeondraft.
- Local bridge
- Mod and companion talk on your computer; no accounts or telemetry.
- Mod awareness
- Detects Unofficial Patch, Custom Snap Mod, Soft Shadows and Sketch Tool.
- Universal VTT
- Export to or rebuild from a Universal VTT file.
- Several clients
- Claude Desktop, Claude Code, Codex, OpenCode or any MCP client.
Good for
- Lay out a tavern from a written brief
- Furnish and light a single room
- Plan an encounter route on an existing map
- Hand off repetitive object placement
Pricing
Open source
Free, MIT licence; requires a Dungeondraft licence
Prices change. Check knownframe.com before you buy.
battlemap-mcp FAQ
Does it create art?
No. It places assets you already own in Dungeondraft.
What do I need?
Dungeondraft 1.2.0.1 and an AI client that runs local MCP servers on the same computer.
What platforms?
Windows, macOS and Linux.
What does it cost?
It is free and open source under the MIT licence; Dungeondraft is bought separately.
Is battlemap-mcp free?
Yes. battlemap-mcp is open source, so you can use and self-host it for free.
How do I add battlemap-mcp to Claude Code?
Run this command in your terminal: claude mcp add battlemap-mcp -- npx -y https://github.com/thekannen/battlemap-mcp/releases/download/v1.4.3/battlemap-mcp-1.4.3.mcpb
What are the best alternatives to battlemap-mcp?
The closest alternatives to battlemap-mcp are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.
Alternatives to battlemap-mcp

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media