# Scribe

> Scribe is a freemium MCP server for developer tools. Generate markdown documentation for code files, one at a time or 20 in a batch. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5.99 a month
- **Platforms:** API, CLI
- **Website:** https://scribe.writulos.com
- **Repository:** https://github.com/writulos/writulos-mcp
- **MCP Registry name:** com.writulos/scribe
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/scribe
