Moxie Docs MCP server
online · 100% uptimeio.github.Jackalope-Dev/moxie-docs·v0.3.0·2 starsLiving docs and MCP context for GitHub repos — conventions, gaps, and source-cited pages on merge.
2 stars
Reviews
Write oneNobody has reviewed Moxie Docs yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Moxie Docs tools (12, 1 write)
write = sends, deletes, buys or postsmoxie.get_ai_contextFreeGet the compact briefing an agent should read before editing this repository: index status, verified commands, agent tips, top conventions, open documentation gaps, and queued documentation opportunities. Read-only; no side effects. Returns a single Markdown document. Call this first at the start of a task; once you know which files you'll change, follow up with get_doc_impact for path-scoped guidance.
moxie.get_api_contextFreeGiven file paths an agent is about to touch, return structured context for any API endpoints they map to: method, path, request/response schema, and known consumers/features. Read-only; no side effects. Call this before editing API route or schema code, alongside get_doc_impact.
moxie.get_conventionsFreeGet the coding conventions Moxie inferred for the repository. Read-only; no side effects. Returns a Markdown list grouped by category (e.g. testing, structure, docs, review); each convention has a title, summary, confidence score, agent guidance, and the source file paths that evidence it. Use this for the general rules to follow; when you already know the files you're about to edit, prefer moxie.get_doc_impact for conventions scoped to those paths.
moxie.get_doc_gapsFreeList the unresolved documentation gaps Moxie found - areas of the codebase that lack docs. Read-only; no side effects. Returns a Markdown list, each gap with a title, severity, summary, and suggested file paths. This is gaps only; for the full prioritized work queue that also includes drift repairs and PR-template work, use get_documentation_opportunities, and to scope gaps to files you're about to edit use get_doc_impact.
moxie.get_doc_impactFreeGiven the file paths an agent is about to change (and optionally a subset being deleted), return the conventions, documentation gaps, and existing/related docs whose evidence overlaps those paths, plus a net-new/undocumented analysis and any removal candidates. Read-only; no side effects. Returns a Markdown report. Call this BEFORE writing code so doc updates land in the same PR; then use propose_doc_update to write a doc, or propose_doc_removal for an orphaned one.
moxie.get_documentation_opportunitiesFreeList the actionable documentation updates Moxie recommends as a prioritized queue: missing docs, drift repairs, and PR-template work. Read-only; no side effects. Returns a Markdown list, each opportunity with a title, kind (documentation_gap | documentation_drift | pr_template), severity, summary, suggested action, estimated files changed, and source paths. Use this to pick the next doc task; it is the superset of get_doc_gaps (which lists gaps only).
moxie.get_documentation_patternsFreeGet Moxie's summary of how THIS repository organizes and maintains documentation - where docs live relative to code and how they are kept current. Read-only; no side effects. Returns a Markdown list of pattern entries, each with a title, explanation, and source citations. Use this to decide WHERE a new doc should go before calling propose_doc_update; for the list of WHICH docs need work, use get_documentation_opportunities instead.
moxie.list_docsFreeList the repository's generated documentation as a browsable table of contents - every doc page, not a query-filtered subset. Read-only; no side effects. Returns Markdown grouped by section, each entry with its title, slug, repository path, and source paths, plus the total count and a pagination cursor so you can tell whether more pages remain (no silent truncation). Use this to see what docs already exist before adding one (so you don't duplicate) or to find the slug to pass to propose_doc_update; when you are hunting for a specific topic, search_docs is more direct.
moxie.propose_doc_removalFreePropose deleting a Moxie-tracked documentation file that your change makes irrelevant, as part of YOUR current change. Moxie validates the path and returns it for you to delete in your working branch; Moxie itself does not delete files or open a PR - the deletion happens in your branch, so it lands in the SAME PR as the code. Returns the resolved path to delete. Provide either slug or targetPath.
moxie.propose_doc_updatewrite actionFreePropose a documentation file to add or update as part of YOUR current change. Records a new proposal each call (not idempotent) and does NOT modify your repository or open a PR - Moxie resolves the target path and returns the path + Markdown for YOU to write into your working branch, so the docs land in the SAME PR as the code. Returns the resolved target path and the content to write. Provide either targetPath or baseSlug.
moxie.review_changeFreeSelf-review a change you are about to commit BEFORE opening the PR. Pass the proposed new state of each changed file (and any deleted paths); Moxie returns a severity-ranked list of violations to fix: convention breaches, docs your change makes factually false, net-new API/surface added without docs, and doc references broken by deletions. Read-only; no side effects and no writes. Returns a Markdown verdict (clean | warnings | must-fix) with each finding's location, fix, and - for doc issues - the slug to pass to propose_doc_update. Call this as the final step of the edit flow, then fix findings and re-run.
moxie.search_docsFreeKeyword and semantic search across the connected repository's generated docs, conventions, documentation gaps, AI-context notes, and indexed code. Read-only; no side effects. Returns ranked matches in Markdown grouped into Documentation and Code sections, each with a title, snippet, and source paths. Use for open-ended lookups when you don't know which category holds the answer; when you do, the specific getters (get_conventions, get_doc_gaps, get_documentation_opportunities) are more direct. Omitting query returns recent context instead.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 5718ms12/20
- Tool poisoning12 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 1 write-action tools with no auth3/15
- Maintenancelast push 31 days ago12/15
- Maintainer identityregistry namespace matches repository owner7/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
How Moxie Docs compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 65/100
- higher than 20% of 1,119 Developer tools servers
- Tools
- 12
- the typical Developer tools server has 7
- Tools that change things
- 8%
- typical: 5%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Developer tools server answers 100%
- Response time
- 1,394 ms
- faster than 4% of 443 Developer tools servers
- GitHub stars
- 2
- more than 65% of 855 Developer tools servers
What its tools let an agent do: 11 read · 1 change
Install Moxie Docs in Claude Code, Cursor or VS Code
claude mcp add --transport http moxie-docs https://moxiedocs.com/api/mcp
What the publisher says
From the Moxie Docs repository's README, as published. We do not edit it. Read it on GitHub
Visit Moxie Docs
Moxie Docs — MCP & Agent Tools
The Moxie Docs Model Context Protocol (MCP) server, the agent skills Moxie installs into your repository, and the moxie-docs CLI that wires it all up — npx moxie-docs setup.
This repo is also the open-source home of the moxie-docs npm package: a setup CLI plus the MCP interface (tool catalog, prompts, server metadata, and skill renderers) you can import. The hosted server, indexing pipeline, and your generated docs stay in the private Moxie service.
Moxie Docs indexes a connected GitHub repository and keeps its documentation alive — generating docs, discovering conventions, tracking documentation gaps and drift, and opening pull requests that keep docs in sync with code. The MCP server exposes that living context to coding agents (Claude Code, Cursor, VS Code, Codex, and any MCP-capable client) so they ground their work in how your repository actually does things — and keep the docs current as they change code.
- Website / dashboard: https://moxiedocs.com
- Human docs for the MCP server: https://moxiedocs.com/mcp
- MCP endpoint: https://moxiedocs.com/api/mcp
This repository is documentation and distribution assets only. The hosted server, indexing pipeline, and your repositories' documentation are not stored here.
Contents
- Quick start
- CLI
- The MCP server
- Connection
- Authentication
- Client configuration
- Tools
- Prompts
- Claude plugin
- Skills
- The moxie-docs skill
- What Moxie installs into your repository
Quick start
The fastest path — from your repository's directory:
npx moxie-docs setupThis signs you in (OAuth in your browser), writes the MCP config for your editor, installs the moxie-docs skill + AGENTS.md guidance, and verifies the connection. After that, your agent reads live context with moxie.getaicontext before editing and proposes doc updates that land in the same PR.
Prefer to do it by hand? Connect a repository at https://moxiedocs.com, then add the server to your agent with a config block.
CLI
The moxie-docs CLI (Node ≥ 18, zero runtime dependencies) sets up and manages the connection. Run it with npx moxie-docs or install it globally (npm i -g moxie-docs).
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Moxie Docs: common questions
- Is Moxie Docs MCP server safe?
- With care: it is graded C, so read the findings first (65/100). Read the Moxie Docs safety report
- How do I install Moxie Docs?
- It runs remotely at moxiedocs.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Moxie Docs need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Moxie Docs maintained?
- The last commit was 72 days ago (2026-08-24). The latest release is v0.3.0.
- Is Moxie Docs up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Moxie Docs?
- Servers from other publishers that do the same job: GitHub MCP server, Gk CLI MCP server and OctoCounts MCP Server.
- How does Moxie Docs compare with other Developer tools MCP servers?
- safety score 65/100 (higher than 20% of 1,119 Developer tools servers); tools 12 (the typical Developer tools server has 7); tools that change things 8% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Moxie Docs
Same job from other publishers: the closest match first, then the best rated.
- GitHubConnect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.not reviewedEstablishedA
Gk CLIThe GitKraken MCP Server for managing repos, PRs, issues across GitHub, GitLab, Bitbucket and more.not reviewedEstablishedB- OctoCounts MCP ServerAnalyze and compare public GitHub repo line counts (SLOC) via OctoCounts, from any MCP client.not reviewedGrowingA
- GitLab MCP ServerGitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more.not reviewedWidely usedB
- GitDiagramArchitecture diagrams, explanations and Mermaid source for public GitHub repositories.not reviewedEstablishedA