battlemap-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
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
Tool reference: every tool, generated from the server
For contributors: Bridge protocol, Developer installation, Building releases, Contributing, Changelog.
Affiliation and legal
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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect any AI to your Foundry VTT world: actors, combat, dice, journals, tokens, compendiums.
Create AI Characters and generate their DM and comment replies from any MCP client.
MCP server for Argo RPG Platform — connects AI assistants to campaign data via OAuth2
Remote MCP server for D&D: read and update your CharGen campaigns, generate NPCs and art.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceConnects 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.82MIT
- FlicenseAqualityDmaintenanceMCP server for managing Foundry VTT journal content (entries, categories, pages) and listing actors, enabling AI-assisted world-building via natural language commands.11-

SagaSmith D&D MCPofficial
AlicenseNot gradedqualityFmaintenanceA 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- AlicenseNot gradedqualityBmaintenanceEnables 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