How do I connect Foundryvtt MCP Server to Claude?

The listing records `bunx foundryvtt-mcp` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Claude Code, VS Code as compatible clients.

Is Foundryvtt MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Foundryvtt MCP Server do?

Foundryvtt MCP Server documents 31 tools to the agent, including apply_status_effect, create_actor_item, create_journal_entry. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Foundryvtt MCP

Unclaimed

by laurigates

A Model Context Protocol (MCP) server that integrates with FoundryVTT, allowing AI assistants to interact with your tabletop gaming sessions. Query actors, roll dice, generate content, and manage your game world through natural language.

Install

$bunx foundryvtt-mcp

Set up this server

Compare servers My Stack

This server needs project-specific setup. Follow the project instructions; no reusable public launch command is available yet.

Project instructions

foundryvttmanaged-by-opentofumcp

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

31 of 31 tools

Documented tools (31)

From project documentation. A server handshake does not verify each tool’s description or behavior.

apply_status_effect

apply or remove a status condition (e.g. prone, stunned) on a token's actor

create_actor_item

add an inline item to an actor

create_journal_entry

create a journal entry with one or more text pages

delete_actor_item

remove an item from an actor

diagnose_errors

analyze errors with troubleshooting suggestions

end_combat

end (delete) the active combat encounter

generate_loot

create treasure appropriate for level

generate_npc

create random NPCs

get_actor_details

detailed character information

get_chat_messages

recent chat history

get_combat_state

combat state and initiative order

get_health_status

comprehensive health diagnostics

get_journal

retrieve a specific journal entry

get_recent_logs

retrieve filtered FoundryVTT logs

get_scene_info

current scene details

get_system_health

server performance and health metrics

get_users

list online users and their status

get_world_summary

overview of the current world state

lookup_rule

game rules and spell descriptions

move_token

move a token to new x/y coordinates on its scene

next_turn

advance the active combat to the next turn (wraps to the next round)

refresh_world_data

reload world data from FoundryVTT

roll_dice

roll dice with any formula

search_actors

find characters, NPCs, monsters

search_items

find equipment, spells, consumables

search_journals

search notes and handouts

search_logs

search logs with regex patterns

search_world

full-text search across all game entities

set_initiative

set a combatant's initiative in the active combat

update_actor_attributes

patch an actor's system attributes (HP, currency, spell slots, …)

update_actor_item

apply a JSON merge patch to an actor's item

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Foundryvtt MCP Server

How do I connect Foundryvtt MCP Server to Claude?: The listing records `bunx foundryvtt-mcp` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Claude Code, VS Code as compatible clients.
Is Foundryvtt MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Foundryvtt MCP Server do?: Foundryvtt MCP Server documents 31 tools to the agent, including apply_status_effect, create_actor_item, create_journal_entry. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.