Moxie Docs

What is Moxie Docs?

Moxie Docs is a Model Context Protocol (MCP) server that indexes a connected GitHub repository, keeps its documentation alive by generating docs, discovering conventions, tracking gaps and drift, and opening pull requests to sync docs with code. It provides live context and documentation tools for coding agents like Claude Code, Cursor, VS Code, and Codex.

How to use Moxie Docs?

Run npx moxie-docs setup from your repository’s directory. This signs you in via OAuth, writes the MCP config for your editor, installs the moxie-docs skill and AGENTS.md guidance, and verifies the connection. Alternatively, connect a repository at https://moxiedocs.com and configure your MCP client with the server URL and a bearer token.

Key features of Moxie Docs

• Indexes your GitHub repository to keep documentation alive.
• Discovers coding conventions with confidence scores and source citations.
• Identifies documentation gaps, drift, and recommended doc work.
• Provides read‑only tools and proposals for doc updates/removals.
• Exposes prompts to script “document‑this‑change” and “fix‑stale‑docs” workflows.
• Installs deterministic skill and guidance files into your repository.
• Supports both Bearer token and OAuth 2.1 authentication.

Use cases of Moxie Docs

• Before editing code, get a compact briefing of repository conventions, commands, and open gaps.
• After changing files, automatically propose matching documentation updates in the same PR.
• Find and repair stale or missing docs across the entire repository.
• Ground coding agents in your repository’s actual conventions and command verification.
• Keep generated documentation synced with code changes without manual oversight.

FAQ from Moxie Docs

What transport does the Moxie Docs MCP server use?

Streamable HTTP MCP at https://moxiedocs.com/api/mcp (protocol version 2025-06-18).

How does authentication work?

You can use a Bearer token from the dashboard (Authorization: Bearer <TOKEN>) or OAuth 2.1 sign‑in (authorization‑code + PKCE) for clients that support it. Both resolve to the same token model.

Does Moxie Docs edit my repository directly?

No. All write tools are proposals that return file paths and content for your agent to write into its own branch. Moxie never edits your repository through MCP and never merges.

What files does Moxie install into my repository?

An AGENTS.md pointer file, plus the moxie-docs skill in .claude/skills/ and .agents/skills/. These are deterministic and contain no volatile data.

Where is my repository’s data stored?

The hosted server, indexing pipeline, and your generated docs are kept in the private Moxie service (not in this open‑source repository). Only token hashes, prefixes, scope, and last‑used timestamps are stored.