Skip to content
MCP server

Scribe

Generate markdown documentation for code files, one at a time or 20 in a batch

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
1.0.3
Listing updated
2 days ago

About Scribe

Scribe is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Scribe's MCP server is a thin client for the Writulos documentation service, so every call needs a Writulos API key, taken from the dashboard. Without a key it still starts but each tool call explains where to get one. Run it with npx writulos-mcp from Cursor, Claude Code or Claude Desktop.

Two tools are exposed: one documents a single file, the other up to 20 files per request. Output is structured Markdown with functions, parameters, return types and examples, returned to the chat; you ask the assistant to save it. The server only writes a run log, docs/writulos.log, noting runs and the generations left.

Each file uses one generation from the plan's monthly allowance, shared with the web app and GitHub Action, and failed generations are not charged. The wider product tracks documentation drift against commits, and the site says code is not used for training.

Install

Run in a terminal

claude mcp add scribe --env WRITULOS_API_KEY='<WRITULOS_API_KEY>' -- npx -y writulos-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "scribe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "writulos-mcp"
      ],
      "env": {
        "WRITULOS_API_KEY": "<WRITULOS_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • WRITULOS_API_KEYYour Writulos Scribe API key, from https://scribe.writulos.com/dashboard/api-keysRequired
  • WRITULOS_OUTPUT_DIRDirectory for the run log (writulos.log). Defaults to "docs", relative to the project root.
  • WRITULOS_PROJECT_ROOTProject root the run log is written under. Defaults to the working directory.
  • WRITULOS_API_URLOverride the API base URL, for testing against another deployment. Defaults to https://scribe.writulos.com/api

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

generate_docs
Generates markdown documentation for a single code file.
generate_docs_batch
Generates markdown documentation for up to 20 files in one request.

What it does

Single-file docs
Documents one file with optional filename and context.
Batch of 20
Documents up to 20 files in one request.
Structured output
Overview, functions, parameters and examples.
Run log
Records each run and generations remaining.
Shared allowance
Uses the same monthly generations as the web app and Action.

Good for

  • Document a whole folder from inside Cursor
  • Add context to a tricky file before documenting
  • Refresh docs after a refactor
  • Check how many generations remain

Pricing

Freemium, from $5.99 a month

Free 20 generations/month; Pro $5.99, Business $9.99 per developer/month

Prices change. Check scribe.writulos.com before you buy.

Scribe FAQ

Do I need an API key?

Yes, from scribe.writulos.com.

What does it cost?

Free for 20 generations a month; Pro $5.99 and Business $9.99 per developer a month.

Is code used for training?

The site says no.

What about private repos?

Send only the file you document.

Is Scribe free?

Scribe has a free plan, with paid plans for more usage or features. Paid plans start at $5.99 a month.

How do I add Scribe to Claude Code?

Run this command in your terminal: claude mcp add scribe --env WRITULOS_API_KEY='<WRITULOS_API_KEY>' -- npx -y writulos-mcp

What are the best alternatives to Scribe?

The closest alternatives to Scribe are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Scribe

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools