MCP server for Foundry VTT v13 — direct socket.io connection for document CRUD, embedded documents, chat, dice rolling, and file uploads.
View on GitHub →
Try with Claude — $10 free →
Quick Install
Copy the config for your editor. Some servers may need additional setup — check the README.
Claude Desktop
Claude Code
Cursor
Add to claude_desktop_config.json:
{
"mcpServers": {
"foundry-mcp-server": {
"command": "npx",
"args": [
"-y",
"JoeLuker/foundry-mcp-server"
]
}
}
}
📋 Copy
Run in terminal:
claude mcp add foundry-mcp-server npx -y JoeLuker/foundry-mcp-server
📋 Copy
Add to .cursor/mcp.json:
{
"mcpServers": {
"foundry-mcp-server": {
"command": "npx",
"args": [
"-y",
"JoeLuker/foundry-mcp-server"
]
}
}
}
📋 Copy
README Excerpt
MCP server for [Foundry VTT](https://foundryvtt.com/) v13. Connects directly via Socket.IO with 65 tools for full world management. Includes an optional companion module for bidirectional RPC with the browser game context. - **Direct connection** to Foundry VTT via Socket.IO with HTTP session authentication
Tools (20)
FOUNDRY_PASSWORD FOUNDRY_URL FOUNDRY_USER_ID foundry_activate_scene foundry_advance_combat foundry_apply_active_effect foundry_browse_files foundry_control_combat foundry_control_playlist foundry_create_directory foundry_create_document foundry_create_document_batch foundry_create_embedded foundry_create_embedded_batch foundry_create_journal foundry_create_light foundry_create_wall foundry_deal_cards foundry_delete_document foundry_delete_document_batch