Skip to main content
Glama
CozyVTT-Agent

CozyVTT-Agent

Official
by ShamanicArts

CozyVTT-Agent

CozyVTT-Agent is an installed, trusted CozyVTT plugin that adapts the host's campaign-scoped capability interface to MCP Streamable HTTP. CozyVTT owns OAuth, campaign authorization, approvals, command execution, replay, audit, and result validation. This plugin owns MCP protocol behavior only.

It does not import CozyVTT backend code, access its database, or proxy through an agent-specific HTTP API.

Development

npm install
npm test

Related MCP server: SagaSmith Narrative

Build an Installable Package

Use the same review key configured in CozyVTT. The command creates a bundled, signed package under build/cozyvtt-agent/ and prints its immutable checksum.

TRUSTED_EXTENSION_REVIEW_KEY=local-review-key npm run package:extension

Configure CozyVTT with:

EXTENSION_PACKAGE_ROOT=/path/to/CozyVTT-Agent/build
TRUSTED_EXTENSION_REVIEW_KEY=local-review-key
TRUSTED_EXTENSION_ALLOWLIST='[{"extensionId":"cozyvtt.agent","version":"0.2.0","checksum":"sha256:..."}]'

An administrator can then install and activate cozyvtt.agent through the generic extension administration API. Its MCP resource is exposed at /api/plugin-transports/cozyvtt.agent/mcp; OAuth discovery and token issuance are provided by CozyVTT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      B
      maintenance
      An authoritative MCP server for long-form tabletop narrative play, managing campaign state, phases, revisions, and tool exposure while delegating semantic review and narration to Agent/Skill procedures.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes AgentHansa's MCP tools to remote clients over Streamable HTTP, enabling ChatGPT and desktop agents to use the AgentHansa service through a secure authenticated endpoint.
      MIT