Scribe MCP

Scribe MCP is a production documentation and audit platform for agent-driven software work. It gives teams a durable execution record, governed planning artifacts, and tool contracts that make multi-agent development observable, reviewable, and reproducible.

If your system depends on agents making changes over time, Scribe is the layer that preserves truth.

Overview

Scribe is designed to solve four hard problems in one package:

• persistent audit logging for agent and operator actions
• governed document workflows for architecture, planning, and execution tracking
• consistent file/search/edit tool contracts for automation-safe operations
• portable runtime modes for local usage and authenticated remote access

This repository ships the public package, public docs, and public plugin bundles needed to run Scribe in real projects.

Core capabilities

• Structured audit trail: project-aware entries with queryable history
• Governed docs engine: architecture/phase/checklist/progress workflows with managed updates
• Operator tooling: file read/search/edit helpers and diagnostics for day-to-day execution
• Storage flexibility: local-first operation with optional remote-backed posture
• Plugin bundles: ready-to-use Codex and Claude plugin surfaces under plugins/

Install and start

Install from PyPI:

pip install scribe-mcp

Quick sanity check:

scribe --help
scribe-server --help

Minimal local run:

scribe-server

Runtime postures

Posture	Status	Usage
Local/core runtime	Default and recommended	Day-to-day usage, local development, and most integrations
Authenticated remote/client runtime	Supported	Managed/private deployments that require centralized access
Open unauthenticated internet exposure	Unsupported	Not a supported security posture

For authenticated remote clients:

export SCRIBE_REMOTE_URL="https://your-scribe-endpoint.example"
export SCRIBE_REMOTE_AUTH_TOKEN="replace-with-your-token"

Documentation index

Start here for product truth and boundaries:

• Compatibility matrix
• Release surface
• Release file map

Usage and operator references:

• Scribe usage guide
• MCP server guide
• Remote client contract
• Bridge development
• Template variables reference

Deployment and environment setup:

• Global deployment guide
• Deployment README

Examples:

• mcp.json example
• opencode.json example

Background and context:

• Scribe MCP whitepaper

Plugins and integrations

Public plugin bundles are included in this repository:

• plugins/codex/
• plugins/claude/

These are packaged as public integration surfaces for downstream users.

License

See LICENSE.