Foundry VTT MCP Bridge
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
What is Foundry VTT MCP Bridge?
Foundry VTT MCP Bridge is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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...
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
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Connects Claude Desktop to Foundry VTT for AI-powered campai
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx foundry-vtt-mcp-bridgeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Foundry VTT MCP Bridge
The Foundry VTT MCP Bridge connects Claude Desktop to a running Foundry Virtual Tabletop instance, exposing 40 tools that let game masters manage campaigns through natural language. You can create quests, manage characters and tokens, search compendiums, roll dice, generate maps, and control scenes — all by talking to Claude instead of clicking through Foundry's interface. It supports D&D 5e NPC creation, DSA5 character archetypes, and WFRP4e, making it a powerful assistant for GMs who want AI help with session prep and real-time game management.
Prerequisites
- Foundry VTT instance running (self-hosted or accessible on your network)
- The Foundry VTT MCP Bridge module installed in your Foundry world
- Node.js 18+ installed for building the MCP server
- An MCP client such as Claude Desktop
Install the Foundry VTT module
Install the MCP Bridge module inside Foundry VTT through the Add-on Modules interface. Enable it in your world settings and configure connection options in the module settings panel.
Clone and build the MCP server
Clone the repository and build the TypeScript MCP server that Claude Desktop will connect to.
git clone https://github.com/adambdooley/foundry-vtt-mcp.git
cd foundry-vtt-mcp
npm install
npm run buildNote the path to the built server
After building, find the path to the compiled server entry point. You will need this absolute path for the Claude Desktop configuration.
# The server entry point is at:
# /path/to/foundry-vtt-mcp/packages/mcp-server/dist/index.js
ls packages/mcp-server/dist/Configure Claude Desktop with the server path and Foundry connection
Add the Foundry MCP server to claude_desktop_config.json. Set FOUNDRY_HOST and FOUNDRY_PORT to match your running Foundry instance. Default port is 31415 (Foundry's MCP bridge port, not 30000).
{
"mcpServers": {
"foundry-mcp": {
"command": "node",
"args": ["/absolute/path/to/foundry-vtt-mcp/packages/mcp-server/dist/index.js"],
"env": {
"FOUNDRY_HOST": "localhost",
"FOUNDRY_PORT": "31415"
}
}
}
}Enable write operations in Foundry module settings
In Foundry's module settings for MCP Bridge, enable write operation permissions if you want Claude to create quests, move tokens, or modify actors. By default, write operations may be restricted.
Restart Claude Desktop and verify
Restart Claude Desktop to load the configuration. Ask Claude about the current scene or a character to confirm the bridge is working.
Foundry VTT MCP Bridge Examples
Client configuration
Claude Desktop configuration for the Foundry VTT MCP Bridge, connecting to a local Foundry instance.
{
"mcpServers": {
"foundry-mcp": {
"command": "node",
"args": ["/Users/yourname/foundry-vtt-mcp/packages/mcp-server/dist/index.js"],
"env": {
"FOUNDRY_HOST": "localhost",
"FOUNDRY_PORT": "31415"
}
}
}
}Prompts to try
Example natural language prompts for managing a Foundry VTT campaign through Claude.
- "What's in the current scene?"
- "Show me Clark's character stats and equipment"
- "Create a quest journal entry: 'The Missing Merchant — villagers report a trader disappeared on the north road'"
- "Find all CR 5-8 undead creatures in the compendium"
- "Roll stealth checks for all tokens named 'Tulkas' and 'Gimli'"
- "Create a D&D 5e NPC: a level 3 bandit captain named Raven"
- "Generate a dungeon map for a medium-sized underground cave"Troubleshooting Foundry VTT MCP Bridge
Connection refused — Claude cannot reach the Foundry bridge
Verify that the MCP Bridge module is installed, enabled, and active in your running Foundry world. Check that FOUNDRY_PORT is set to the bridge port (31415 by default, not Foundry's main port 30000). Also confirm FOUNDRY_HOST matches where Foundry is running.
npm run build fails with TypeScript errors
Ensure Node.js 18+ is installed. Run 'node --version' to check. Delete the node_modules directory and run 'npm install' again before retrying the build. Check the repository for any additional build prerequisites.
Write operations (create quest, move token) are blocked
Open Foundry's module settings for MCP Bridge and enable write operation permissions. By default, the bridge may be in read-only mode for safety. You can also restrict which write operations are allowed per-category in the settings.
Frequently Asked Questions about Foundry VTT MCP Bridge
What is Foundry VTT MCP Bridge?
Foundry VTT MCP Bridge is a Model Context Protocol (MCP) server that 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 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Foundry VTT MCP Bridge?
Follow the installation instructions on the Foundry VTT MCP Bridge GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Foundry VTT MCP Bridge?
Foundry VTT MCP Bridge works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Foundry VTT MCP Bridge free to use?
Yes, Foundry VTT MCP Bridge is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.
Foundry VTT MCP Bridge Alternatives — Similar Business Applications Servers
Looking for alternatives to Foundry VTT MCP Bridge? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Foundry VTT MCP Bridge in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Foundry VTT MCP Bridge?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.