yanjingzhaisun/cozyvtt-mcp

Overview

MCP bridge that connects AI agents to CozyVTT, a self-hosted virtual tabletop. It exposes 37 tools for server-authoritative dice rolls, chat narration, tokens, maps, initiative, character sheets, and documents, letting an AI agent act as dungeon master or keeper. Supports CozyVTT v1.2.2 and v1.4.0.

Best for

Best for
GMs and developers who want an AI co-DM for self-hosted CozyVTT games.

Use cases

• Automating DM/KP duties in CozyVTT campaigns
• Managing combat initiative and tokens via AI
• Narrating scenes and rolling dice server-side

How to use

Tools exposed

• cozyvtt-mcp
• character_hitdice_spend
• COZYVTT_URL
• COZYVTT_EMAIL
• COZYVTT_PASSWORD
• COZYVTT_CAMPAIGN_ID

Tested with

Cursor

Notes

MCP bridge that connects AI agents to CozyVTT, a self-hosted virtual tabletop. It exposes 37 tools for server-authoritative dice rolls, chat narration, tokens, maps, initiative, character sheets, and documents, letting an AI agent act as dungeon master or keeper. Supports CozyVTT v1.2.2 and v1.4.0.

1 stars on GitHub. Last updated 2026-09-20. Licensed MIT.

Use cases

• Automating DM/KP duties in CozyVTT campaigns
• Managing combat initiative and tokens via AI
• Narrating scenes and rolling dice server-side

Pros

• Server-authoritative dice ensure fair rolls
• 37 tools cover core VTT actions
• Supports two CozyVTT versions

Cons

• Only 1 GitHub star, early stage
• Supports only CozyVTT v1.2.2 and v1.4.0, not all versions
• Requires self-hosted CozyVTT setup

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.