Back to Home
adambdooley icon

foundry-vtt-mcp

Verified Safe

by adambdooley

Overview

Connects Foundry VTT to Claude Desktop for AI-powered campaign management, character/compendium queries, content creation, and AI map generation.

Installation

Run Command
node path/to/foundry-vtt-mcp/packages/mcp-server/dist/index.js

Environment Variables

  • LOG_LEVEL
  • FOUNDRY_HOST
  • FOUNDRY_PORT
  • FOUNDRY_NAMESPACE
  • MAP_GEN_HOST
  • MAP_GEN_PORT
  • MAP_GEN_ENABLED
  • MAP_GEN_INSTALL_PATH
  • MAP_GEN_PYTHON_PATH
  • MAP_GEN_VENV_PATH
  • MAP_GEN_WORKFLOW_PATH

Security Notes

The server architecture is designed with security in mind, employing a registry pattern and Zod schemas for input validation. Critical operations, such as character data extraction and content creation, are restricted to Game Master (GM) users in Foundry VTT, with additional configurable permissions for write operations ('Allow Write Operations' setting). The use of `execSync` and `spawn` for process execution is isolated to installation scripts (e.g., for Python/ComfyUI) and internal backend management (e.g., spawning the ComfyUI service), rather than processing arbitrary user input. No direct `eval` of user input is observed. Network communication uses WebSocket and WebRTC, typical for such applications. There are no obvious hardcoded API keys or sensitive credentials exposed. The biggest remaining risks would be a vulnerability in the underlying Foundry VTT API itself, or an undiscovered injection vector in the prompt processing that could bypass validation and lead to unintended system commands, though current code mitigates this by abstracting actions through specific tools. Requires user's Claude Pro/Max plan for MCP access, which implies an additional layer of external security.

Similar Servers

Stats

Interest Score33
Security Score8
Cost ClassMedium
Avg Tokens750
Stars19
Forks15
Last Update2026-01-04

Tags

Foundry VTTClaude AITTRPGCampaign ManagementMap GenerationAI Agent