Skip to content
MCP server

battlemap-mcp

Drive Dungeondraft from an AI assistant to build and edit battle maps with your assets

Runs locallyStatus and history
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media