foundryvtt-mcp

Hybridenishi/foundryvtt-mcp
★ 0 stars JavaScript Code/Dev Tools Updated today
Personal MCP server for Foundry VTT v14 — connects Hermes to Foundry over Socket.IO with a focused set of read/write/dice tools.
View on GitHub → 🔍 Audit Wallet Slippage →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "foundryvtt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "Hybridenishi/foundryvtt-mcp"
      ]
    }
  }
}

README Excerpt

Focused MCP server connecting an MCP-compatible agent to Foundry VTT v14 and D&D 5e. ``` Hermes → MCP Server (stdio) → Sidecar (REST :30001) → Foundry (Socket.IO :30000) ↕ Same-origin reverse proxy /mcp-bridge ↔ MCP Bridge module (active GM client) ``` The **sidecar** runs alongside Foundry and handles Socket.IO auth internally. The MCP server talks plain HTTP — no auth handshake, no session cookies, no internal protocol concerns. The optional MCP Bridge module supplies values prepared by Foundr

Tools (20)

apply_condition_changeapply_hp_changeapply_spell_slot_adjustmentcreate_actorcreate_chat_messagedelete_actorexecute_item_activity_useget_5e_actor_summaryget_actorget_chat_logget_combat_stateget_itemget_item_activityget_journal_entryget_prepared_5e_actor_summaryget_prepared_party_overviewget_scene_tokensget_scenesget_userslist_actor_items