Windsurf + Moxie Docs

MCP server for Windsurf - live docs from your repository

Windsurf agents benefit from the same compact, citation-backed context as Cursor and Claude Code. Moxie Docs keeps an index of your repository current on every merge and serves it through standard MCP tools.

  • Standard MCP. Works with Windsurf's MCP client configuration - no custom plugin required.
  • Always current. Documentation and conventions update when your team merges code.
  • Scoped to your repo. Context is repository-specific - not generic library docs from the public internet.
Set up with one promptConnect GitHub repoMCP overview

Set up Windsurf with Moxie

  1. Step 1

    Connect GitHub

    Start a trial and select the repository Windsurf should understand.

  2. Step 2

    Configure MCP

    Run npx moxie-docs setup or copy the Windsurf MCP snippet from your dashboard.

  3. Step 3

    Use agent skills

    Install the moxie-docs skill so Windsurf knows when to pull doc impact and conventions.

$ npx moxie-docs setup

Sign in, configure your editor, and install the skill - one command.

FAQ

Does Moxie work with Windsurf out of the box?+

Yes. Moxie exposes a standard MCP endpoint. Run npx moxie-docs setup after connecting a repository, or copy the MCP config from your dashboard once the first index finishes.

What context do agents receive?+

Conventions, generated docs, open doc gaps, verified commands, and doc-impact hints for the files an agent plans to change - all scoped to the repository you selected.