Ninjo's Foundry MCP

Ninjo's Foundry MCP turns your Foundry world into something you can simply talk to. Ask Claude to build a scene from artwork you already have, write a quest chain that fits what your journals already say, archive a finished chapter into a compendium, or send a stealth check to one specific player — and watch it happen at the table.

Whether you are preparing a session at midnight, rebuilding an archive that grew out of hand, or salvaging a scene you deleted three weeks ago, the bridge does the clicking for you.

⚠ This module is one half of a pair. It carries out the work inside Foundry, but the requests come from a companion MCP server that runs on the GM's own PC next to Claude Desktop. Both ship from the same release and carry the same version. The module on its own does nothing — you need both halves. Installation of both is described in the repository.

Key Features:

• Scene Management: Build a scene from an image or video already on disk, with the dimensions measured from the file itself. Copy grid, lighting and module settings from a template scene — but never its id, so nothing gets silently overwritten. Nested folders are created as needed.
• Restore From Backup: Bring a scene back out of a world backup, complete with its walls, tiles, lights, sounds and tokens. The tool that saves you after a bad afternoon.
• Journals and Quests: Write, search and restructure journals, split and rewrite pages, and link quests to the NPCs who give them.
• Compendium Management: Create, fill, sort, lock and inspect compendiums — built for archiving chapters you have finished playing. List what is actually inside a pack, and remove named entries surgically.
• Actors and NPCs: Build complete D&D 5e NPCs from a prompt — stat block, attacks, saves, spellcasting — or manage actors of any type on any supported system.
• Interactive Dice: Send roll requests to specific players; the result comes back into the conversation.
• GM-Only, With Brakes: Players never get access. Permissions are graded per document type — read, create and edit, or additionally delete — and deleting is switched off everywhere by default. There is deliberately no "empty this compendium".
• Fully Bilingual: Native English and German interface.

Supports D&D 5e, Pathfinder 2e, DSA 5, Cosmere RPG, WFRP 4e and Mongoose Traveller 2e. Most tools work regardless of system.

An independent fork of adambdooley/foundry-vtt-mcp by Adam Dooley, used under the MIT license — not a replacement for the original project.

For installation of both halves, full documentation and the complete tool list, please visit the Official GitHub Repository.

Deutsche Beschreibung

Ninjo's Foundry MCP macht deine Foundry-Welt zu etwas, mit dem du einfach reden kannst. Bitte Claude, aus vorhandenem Bildmaterial eine Szene zu bauen, eine Questreihe zu schreiben, die zu dem passt, was in deinen Journalen schon steht, ein fertig gespieltes Kapitel ins Kompendium zu archivieren, oder einen Heimlichkeitswurf bei genau einem Spieler anzufordern — und sieh zu, wie es am Tisch passiert.

Ob du um Mitternacht eine Sitzung vorbereitest, ein Archiv neu aufbaust, das dir über den Kopf gewachsen ist, oder eine Szene bergen willst, die du vor drei Wochen gelöscht hast — die Brücke klickt für dich.

⚠ Dieses Modul ist eine Hälfte von zweien. Es führt die Arbeit in Foundry aus, die Aufträge kommen aber von einem MCP-Server auf dem PC des Spielleiters, neben Claude Desktop. Beide stammen aus demselben Release und tragen dieselbe Version. Das Modul allein tut nichts — du brauchst beide Hälften. Die Einrichtung beider ist im Repository beschrieben.

Haupt-Features:

• Szenenverwaltung: Bau eine Szene aus einem Bild oder Video, das schon auf der Platte liegt — die Maße werden aus der Datei gemessen. Übernimm Gitter, Beleuchtung und Moduleinstellungen aus einer Vorlagenszene, aber niemals ihre Kennung, damit nichts stillschweigend überschrieben wird. Verschachtelte Ordner entstehen von selbst.
• Aus der Sicherung bergen: Hol eine Szene aus einer Weltsicherung zurück, vollständig mit Wänden, Kacheln, Lichtern, Klängen und Figuren. Das Werkzeug, das einen verdorbenen Nachmittag rettet.
• Journale und Quests: Schreiben, durchsuchen, umbauen, Seiten teilen und neu setzen, und Quests mit den NSC verknüpfen, die sie vergeben.
• Kompendienverwaltung: Anlegen, befüllen, sortieren, sperren und hineinsehen — gedacht zum Archivieren fertig gespielter Abschnitte. Zeigt, was wirklich in einem Pack liegt, und entfernt benannte Einträge gezielt.
• Figuren und NSC: Vollständige D&D-5e-NSC aus einer Beschreibung — Werteblock, Angriffe, Rettungswürfe, Zauberei — oder Figuren jeder Art auf jedem unterstützten System.
• Interaktive Würfel: Wurfanforderungen an einzelne Spieler; das Ergebnis kommt ins Gespräch zurück.
• Nur für den Spielleiter, mit Bremsen: Spieler bekommen keinen Zugriff. Rechte sind je Dokumentart abgestuft — lesen, anlegen und ändern, oder zusätzlich löschen — und Löschen ist ab Werk überall aus. Ein „leere dieses Kompendium“ gibt es bewusst nicht.
• Vollständig zweisprachig: Englisch und Deutsch.

Unterstützt D&D 5e, Pathfinder 2e, DSA 5, Cosmere RPG, WFRP 4e und Mongoose Traveller 2e. Die meisten Werkzeuge arbeiten systemunabhängig.

Ein eigenständiger Fork von adambdooley/foundry-vtt-mcp von Adam Dooley, verwendet unter der MIT-Lizenz — kein Ersatz des Ursprungsprojekts.

Für die Einrichtung beider Hälften, die vollständige Dokumentation und die Werkzeugliste besuche bitte das Offizielle GitHub Repository.