Skip to main content
Glama
battlemap-mcp
by thekannen

battlemap-mcp

An AI collaborator for your Dungeondraft maps: 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, using assets you already own.

Documentation: knownframe.com/battlemap-mcp/docs · Setup video: install it in five minutes (YouTube)

Sped up 11×; the full build took about five minutes. Watch the narrated build (YouTube).

Support creators first

This is a local automation layer for your own Dungeondraft map-making session. It does not generate original assets or art for you; it drives what you already own in Dungeondraft. Please buy and support Dungeondraft, and support the artists whose asset packs you use.

Related MCP server: foundry-cli

Supported mods

battlemap-mcp notices these Dungeondraft mods when they are loaded and works with them. Without them, nothing changes.

Mod

What your assistant does with it

Unofficial Patch by Moulk

Resizes maps up to 200 tiles a side and uses the Above Lights layer. Keeps your Free Transform shapes and groups when it moves or copies objects, and leaves the patch's extra terrain slots alone.

Custom Snap Mod by Lievven

Reads your square, hex or custom grid and, when you ask, places things on it, as your cursor would. It never changes your snap settings.

Soft Shadows by Moulk

Adds, adjusts and removes soft shadows on objects, walls and paths, and keeps your own shadows when it moves, edits, deletes, undoes or copies them. Roof and pattern shadows are left as you set them.

Sketch Tool by Moulk

Keeps your sketch notes out of the map images it exports, as Dungeondraft's own Export does.

Some steps depend on a mod's version, and run only on the versions they were checked against. Details: Using other mods.

What you can make

Build a whole map from a brief, plan an encounter together, furnish one room, export to or rebuild from a Universal VTT file, or hand off tedious placement. See example prompts.

Get started

You need Dungeondraft 1.2.0.1 and an AI app that can run local MCP servers, on the same computer. Follow Get started, then the Windows, macOS or Linux guide. Downloads are on the Releases page. Prefer to watch? The setup video installs everything with the Claude desktop app, start to finish.

Include your asset packs

See Include your asset packs.

Install from Claude

Use the Claude desktop extension or the Claude Code plugin: see Install from Claude.

Platform limits

See Platform limits.

If something does not work

See Troubleshooting.

Documentation

For contributors: Bridge protocol, Developer installation, Building releases, Contributing, Changelog.

battlemap-mcp is an independent, unofficial project and is not sponsored, operated, or endorsed by Megasploot or Tailwind Games, LLC. It does not include or redistribute Dungeondraft software, maps, or art assets. See Legal and attribution.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      A
      maintenance
      Connects Claude Desktop to Foundry VTT for AI-powered campaign management, enabling natural language interaction with game data including quest creation, character management, compendium searches, and dice rolling. Provides 20 MCP tools for seamless integration between Claude and your tabletop RPG sessions.
      82
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      A local MCP server for Dungeons & Dragons campaign management, combining core runtime with skill and module-generation packs. It enables campaign creation, module generation and import, rule and skill searching via tools, resources, and prompts.
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables local-first, source-cited AI answers about your TTRPG campaign lore from your own documents, usable in Discord, Foundry VTT, or any MCP client while refusing to invent information outside your sources.
      MIT