writulos-mcp

writulos-mcp

Official MCP server for Writulos Scribe — generate markdown documentation for your code inside Cursor, Claude Desktop, and any MCP-compatible AI agent.

Installation

No install needed. Run directly with npx:

npx writulos-mcp

Or install globally:

npm install -g writulos-mcp

Setup in Cursor

Add this to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "writulos": {
      "command": "npx",
      "args": ["-y", "writulos-mcp"],
      "env": {
        "WRITULOS_API_KEY": "writ_YOUR_API_KEY"
      }
    }
  }
}

Restart Cursor. Then in the AI chat, ask:

Document all the files in this project using writulos

The generated docs come back in the chat — ask Cursor to save them wherever you keep documentation. The server itself only writes a run log to docs/writulos.log (set WRITULOS_OUTPUT_DIR to move it), recording each run and how many generations you have left this month.

Tools

generate_docs

Generate markdown documentation for a single code file.

Inputs:

• code (required) — the source code
• filename (optional) — e.g. auth.js
• context (optional) — extra context about the file

generate_docs_batch

Generate markdown documentation for up to 20 files in one request.

Inputs:

• files (required) — array of { code, filename?, context? } objects

Requirements

• Node.js 18+
• A Writulos Scribe API key from scribe.writulos.com/dashboard/api-keys

License

MIT