foundry-browser-mcp

An MCP server bridge that connects AI models (via the Model Context Protocol) to a live Foundry VTT session over WebSocket.

Installation

npm install -g foundry-browser-mcp

Or run directly with npx:

npx foundry-browser-mcp

Environment Variables

| Variable | Default | Description | |---|---|---| | FOUNDRY_MCP_PORT | 3000 | WebSocket port the bridge listens on |

The bridge communicates with the MCP client over stdin/stdout and with Foundry VTT over WebSocket.

Usage

Add to your MCP client configuration:

OpenCode (~/.config/opencode/opencode.jsonc)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "foundry": {
      "type": "local",
      "command": ["npx", "foundry-browser-mcp"],
      "environment": { "FOUNDRY_MCP_PORT": "3000" },
      "enabled": true
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "foundry": {
      "command": "npx",
      "args": ["foundry-browser-mcp"],
      "env": { "FOUNDRY_MCP_PORT": "3000" }
    }
  }
}

Requirements

• A Foundry VTT instance with the foundry-browser-mcp module installed (see GitHub repo)
• Node.js 18+

License

ISC