Register

Foundry API Bridge (Foundry MCP)

An Add-on Module for Foundry Virtual Tabletop

Author: Nitrmonoon Project: Source Foundry Versions 11+ (Verified 14) Last Updated 1 day, 20 hours ago
AI Usage Explanation

AI (Claude) was used as a development tool to assist with writing TypeScript code, tests, and documentation (README). All code was reviewed and tested by the developer. The module itself does not contain AI-generated game content — it is a technical integration layer that connects Foundry VTT to external AI services via API.

Foundry API Bridge connects your Foundry VTT world to AI assistants and to a public REST API through foundry-mcp.com. Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Windsurf, Cline or any client that speaks the Model Context Protocol can read your campaign and act in it: roll dice, run combat, write journals, move tokens, import from compendiums.

The module runs only in the Game Master's browser. It opens an outgoing WebSocket connection to the server, receives commands, executes them in Foundry with GM permissions and sends the results back. Nothing runs on players' clients, nothing listens for incoming connections on your machine, and your world data is not stored on the server: commands pass through and results go straight back.

 

WHAT THE ASSISTANT CAN DO (121 tools)

Code mode: Claude Code and Codex can also write a short TypeScript script against a typed foundry.* API and run it in a sandbox on the server, so bulk edits and multi-step tasks finish in one call. See foundry-mcp.com/code.

REST API: the same module serves the public REST API at api.foundry-mcp.com (documentation at api.foundry-mcp.com/docs) for bots, scripts and custom tools.

GAME SYSTEMS

The core tools are system-agnostic. Rolls, item use, conditions and compendium filters have dedicated versions for D&D 5e (dnd5e-*) and Pathfinder 2e (pf2e-*); each works only in a world running that system.

 

ACCESS AND TIERS

 

A Patreon account is enough to start. Access follows your membership: without one you get world info and dice rolls; a free member gets actors, inventory and world items, folders, active effects, actor rolls and chat; Adventurer adds journals and roll tables; Dungeon Master adds scenes and doors, tokens, combat, compendiums and imports, world time, pause and UI helpers. Locked tools stay visible to the assistant and answer with the tier that unlocks them. Membership changes reach the server automatically. Details: foundry-mcp.com.

Supported Game Systems

  1. Dungeons & Dragons Fifth Edition

    Latest Version: Version 6.1.1 Last Updated 12 hours ago
  2. Pathfinder Second Edition

    Latest Version: Version 8.7.0 Last Updated 1 week, 5 days ago

Categories

Available Versions

  1. Version 8.19.0

    1 day, 20 hours ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  2. Version 8.18.0

    2 weeks, 3 days ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  3. Version 8.17.0

    2 weeks, 4 days ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  4. Version 8.16.0

    2 weeks, 4 days ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  5. Version 8.15.0

    3 weeks, 3 days ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  6. Version 8.14.0

    1 month, 1 week ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  7. Version 8.13.0

    1 month, 1 week ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  8. Version 8.12.1

    2 months ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  9. Version 8.12.0

    2 months ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  10. Version 8.11.2

    2 months, 3 weeks ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  11. Version 8.11.0

    4 months ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  12. Version 8.10.1

    4 months, 2 weeks ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  13. Version 8.10.0

    4 months, 2 weeks ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  14. Version 8.9.0

    4 months, 2 weeks ago
    Foundry Version 11+ (Verified 14) Manifest URL Read Notes
  15. Version 8.8.0

    4 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  16. Version 8.7.0

    4 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  17. Version 8.6.0

    4 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  18. Version 8.5.1

    5 months ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  19. Version 8.5.0

    6 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  20. Version 8.4.0

    6 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  21. Version 8.3.1

    6 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  22. Version 8.3.0

    6 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  23. Version 8.2.0

    6 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  24. Version 8.1.0

    7 months ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  25. Version 8.0.1

    7 months ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  26. Version 8.0.0

    7 months ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  27. Version 7.7.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  28. Version 7.6.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  29. Version 7.5.1

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  30. Version 7.5.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  31. Version 7.4.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  32. Version 7.3.1

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  33. Version 7.3.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  34. Version 7.2.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  35. Version 7.1.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  36. Version 7.0.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  37. Version 6.13.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  38. Version 6.12.1

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  39. Version 6.12.0

    7 months, 1 week ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  40. Version 6.11.0

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  41. Version 6.10.0

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  42. Version 6.9.2

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  43. Version 6.9.1

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  44. Version 6.9.0

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  45. Version 6.8.4

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  46. Version 6.8.3

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  47. Version 6.8.2

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  48. Version 6.8.1

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  49. Version 6.8.0

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  50. Version 6.7.0

    7 months, 2 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  51. Version 6.6.0

    7 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  52. Version 6.4.0

    7 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  53. Version 6.3.0

    7 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  54. Version 6.2.0

    7 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  55. Version 6.1.3

    7 months, 3 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  56. Version 6.1.1

    7 months, 4 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  57. Version 6.1.0

    7 months, 4 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes
  58. Version 6.0.0

    7 months, 4 weeks ago
    Foundry Version 11 - 13 (Verified 13) Manifest URL Read Notes