# Moxie-Docs-MCP [Verified] [Health: Active]

**Category:** 🧠 Knowledge & Memory  
**Repository:** https://github.com/Jackalope-Dev/Moxie-Docs-MCP  
**GitHub Stars:** 2  
**npm Downloads (last month):** 109  
**Views:** 21  
**Installs:** 25  
**Upvotes:** 4  
**Directory Page:** https://allmcps.com/mcp/moxie-docs-mcp

## Description
MCP & Agent Skills for Automated Documentation, and codebase conventions + context

## Tools
Capabilities this server exposes over MCP:

- **moxie.get_ai_context** — Compact pre-edit briefing: repo status, verified commands, top conventions, open gaps, team notes. Read this first.
- **moxie.get_doc_impact** — Given the paths you're about to change (and any you're deleting), returns the conventions, gaps, and existing docs whose evidence overlaps them - and flags net-new/undocumented surfaces.
- **moxie.get_api_context** — Given paths you're about to touch, returns structured context for any API endpoints they map to: method, path, schema, and known consumers/features.
- **moxie.review_change** — Self-review a change before opening the PR; returns a severity-ranked verdict (clean / warnings / must-fix) covering convention breaches, stale docs, undocumented surface, and broken references.
- **moxie.get_conventions** — Discovered coding conventions, grouped by category, with confidence scores, agent guidance, and source-file citations.
- **moxie.search_docs** — Semantic + keyword search over generated docs, conventions, gaps, and AI context.
- **moxie.get_doc_gaps** — Unresolved documentation gaps with severity and the paths they concern.
- **moxie.get_documentation_opportunities** — Recommended doc work: missing docs, drift repairs, and PR templates.
- **moxie.get_documentation_patterns** — How the repository organizes and maintains its docs (where new docs belong).
- **moxie.list_docs** — Paginated, section-grouped table of contents of every generated doc.
- **moxie.propose_doc_update** — Add or update a doc as part of your current change; returns the target path + Markdown to write into your branch.
- **moxie.propose_doc_removal** — Remove a Moxie-tracked doc your change makes obsolete; returns the path to delete in your branch.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "moxie-docs-mcp": {
    "command": "npx",
    "args": ["-y","moxie-docs"]
  }
}
```

## Documentation

## What Moxie-Docs-MCP MCP server does

Moxie-Docs-MCP MCP server exposes repository-aware documentation and codebase context to MCP clients. It works with a GitHub repository connected through Moxie Docs and organizes generated documentation, discovered conventions, unresolved gaps, API relationships, and documentation maintenance recommendations.

The tools are designed for coding workflows rather than general-purpose code search. An agent can request a short pre-edit briefing, identify documentation affected by planned file changes, inspect API endpoints associated with paths, and search the indexed repository context. It can also run a change review that reports convention violations, stale documentation, undocumented surfaces, and broken references with severity levels.

Write-oriented operations return proposals. The agent receives a target path and Markdown content, or a path to remove, and applies the change in its own branch. The MCP service does not directly edit the repository or merge pull requests.

## How it works

The hosted MCP endpoint is `https://moxiedocs.com/api/mcp` and uses Streamable HTTP. Moxie Docs indexes a connected GitHub repository, then serves compact results backed by source-file citations. Repository selection can be supplied as an `owner/name` argument when a credential covers multiple repositories and no default repository is available.

A typical coding sequence starts with `moxie.get_ai_context`, followed by tools such as `moxie.get_doc_impact`, `moxie.get_api_context`, or `moxie.get_conventions` for the files under consideration. After editing, `moxie.review_change` can identify issues before a pull request is opened. Search, gap, opportunity, pattern, and document-listing tools provide additional ways to navigate the indexed material.

Moxie-Docs-MCP MCP server supports bearer authentication with a dashboard token. MCP clients that implement the relevant OAuth flow can instead sign in through the browser using OAuth 2.1 with PKCE.

## Setup and configuration

Connect a repository at Moxie Docs, then configure an MCP client with the hosted endpoint. A bearer-token configuration sends an `Authorization: Bearer ...` header. Tokens should remain in local, untracked configuration or be supplied through a client-supported environment-variable reference.

The repository also publishes the `moxie-docs` npm package, whose CLI can configure clients and install repository guidance. Running `npx moxie-docs setup` performs browser sign-in, writes client configuration, installs the `moxie-docs` skill and `AGENTS.md` guidance, and checks the connection. The CLI requires Node.js 18 or newer. Supported CLI configuration targets listed in the material include Claude Code, Cursor, and VS Code.

## Tools and capabilities

- Retrieve repository status, verified commands, conventions, gaps, and team notes.
- Find documentation affected by paths being changed or deleted.
- Resolve API methods, paths, schemas, and known consumers for relevant files.
- Search generated docs, conventions, gaps, and AI context using semantic and keyword search.
- List documentation and inspect repository documentation patterns.
- Return recommended documentation work, including missing documentation and drift repairs.
- Propose Markdown additions, updates, or removals for the agent to apply.
- Review changes for convention breaches, stale docs, undocumented surfaces, and broken references.

## Limitations and notes

Moxie-Docs-MCP MCP server is not a local repository index or a direct file-editing service. The hosted server, indexing pipeline, connected repositories, and generated documentation are not stored in this source repository. Results depend on the repository connected to the Moxie Docs service and the scope of the authenticated account.

The server provides context and proposed file changes, but the client or agent must write those changes to its branch. It does not merge changes. The material identifies a hosted service and authentication requirements, but does not specify subscription pricing or a license for the repository.

_Full upstream README: https://allmcps.com/mcp/moxie-docs-mcp/readme_