Skip to main content
Glama

Foundry VTT MCP Bridge

by adambdooley

Foundry VTT MCP Bridge

Connect Foundry VTT to Claude Desktop for AI-powered campaign management through the Model Context Protocol (MCP).

Overview

The Foundry MCP Bridge enables natural AI conversations with your Foundry VTT game data:

  • Quest Creation: Create quests from prompts that incorporate what exists in your world and journals
  • Character Management: Query character stats, abilities, and information
  • Compendium Search: Find items, spells, and creatures using natural language
  • Content Creation: Generate actors, NPCs, and quest journals from simple prompts
  • Scene Information: Access current scene data and world details
  • Dice Coordination: Interactive roll requests with player targeting
  • Campaign Management: Multi-part quest and campaign tracking

This project was built with the assistance of Claude Code. If you like this project, consider supporting it on Patreon.

Installation

Prerequisites

  • Foundry VTT v13
  • Claude Desktop with MCP support
  • Windows (for automated installer) or Node.js 18+ for manual installation
  1. Download the latest FoundryMCPServer-Setup.exe from Releases
  2. Run the installer - it will:
    • Install the MCP server with bundled Node.js runtime
    • Configure Claude Desktop automatically
    • Optionally install the Foundry module to your VTT installation
  3. Restart Claude Desktop
  4. Enable "Foundry MCP Bridge" in your Foundry Module Management

Option 2: Manual Installation

Install the Foundry Module
  1. Open Foundry VTT v13
  2. Select install module in the Foundry Add-ons menu
  3. At the bottom of the window, add the Manifest URL as: https://github.com/adambdooley/foundry-vtt-mcp/blob/master/packages/foundry-module/module.json and click install
  4. Enable "Foundry MCP Bridge" in Module Management
Install the MCP Server
# Clone repository git clone https://github.com/adambdooley/foundry-vtt-mcp.git cd foundry-vtt-mcp # Install dependencies and build npm install npm run build
Configure Claude Desktop

Add this to your Claude Desktop configuration (claude_desktop_config.json) file:

{ "mcpServers": { "foundry-mcp": { "command": "node", "args": ["path/to/foundry-vtt-mcp/packages/mcp-server/dist/index.js"], "env": { "FOUNDRY_HOST": "localhost", "FOUNDRY_PORT": "31415" } } } }

Starting Claude Desktop will start the MCP Server.

Getting Started

  1. Start Foundry VTT and load your world
  2. Open Claude Desktop
  3. Chat with Claude about your currently loaded Foundry World

Example Usage

Once connected, ask Claude Desktop:

  • "Show me my character Clark's stats"
  • "Find all CR 12 humanoid creatures for an encounter"
  • "Create a quest about investigating missing villagers"
  • "Roll a stealth check for Tulkas"
  • "What's in the current Foundry scene?"

Features

  • 20 MCP Tools that allow Claude to interact with Foundry
  • Character Management: Access stats, abilities, and inventory
  • Enhanced Compendium Search: Instant filtering by CR, type, abilities, and more
  • Content Creation: Generate actors, NPCs, and quest journals
  • Campaign Management: Multi-part quest tracking with progress dashboards
  • Interactive Dice System: Send different dice roll requests to players from Claude
  • Actor Ownership: Manage player permissions for characters and tokens
  • GM-Only: MCP Bridge only connects to Game Master users

Architecture

Claude Desktop ↔ MCP Protocol ↔ MCP Server ↔ WebSocket ↔ Foundry Module ↔ Foundry VTT
  • Foundry Module: Provides secure data access within Foundry VTT
  • MCP Server: External Node.js server handling Claude Desktop communication
  • No API Keys Required: Uses your existing Claude Desktop subscription

Security & Permissions

  • GM-Only Access: All functionality restricted to Game Master users
  • Configurable Permissions: Control what data Claude can access and modify
  • Session-Based Authentication: Uses Foundry's built-in authentication system

System Requirements

  • Foundry VTT: Version 13
  • Claude Desktop: Latest version with MCP support
  • Claude Pro/Max Plan: Required to connect to MCP servers
  • Operating System: Windows 10/11 (installer), or other OSes/manual Windows install with Node.js 18+ (manual)

Support & Development

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

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.

  1. Overview
    1. Installation
      1. Prerequisites
      2. Option 1: Windows Installer (Recommended)
      3. Option 2: Manual Installation
      4. Getting Started
    2. Example Usage
      1. Features
        1. Architecture
          1. Security & Permissions
            1. System Requirements
              1. Support & Development

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  Connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender for AI-assisted 3D modeling, scene manipulation, and rendering.
                  Last updated -
                  17
                  13,041
                  MIT License
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  Connects Claude and other MCP-compatible AI assistants to a Coreflux MQTT broker, enabling them to discover and execute Coreflux commands for managing models, actions, rules, and routes through natural language.
                  Last updated -
                  2
                  Apache 2.0
                  • Linux
                  • Apple
                • -
                  security
                  F
                  license
                  -
                  quality
                  An MCP server that connects Claude to FL Studio, allowing the AI to send melodies, chords, and drum patterns directly to the DAW via virtual MIDI ports.
                  Last updated -
                  3
                  • Apple
                • -
                  security
                  A
                  license
                  -
                  quality
                  A Model Context Protocol server that integrates with FoundryVTT, allowing AI assistants to interact with tabletop gaming sessions through natural language to query actors, roll dice, generate content, and manage game worlds.
                  Last updated -
                  1
                  6
                  MIT License

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/adambdooley/foundry-vtt-mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server