# Microtoll Engine

> Microtoll Engine is an open-source MCP server for developer tools. Search Microtoll Engine docs and scaffold an end-to-end-encrypted notes app locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://microtoll.dev/for-agents.html
- **Repository:** https://github.com/microtoll/engine/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.microtoll/mcp
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-16

## About

Microtoll Engine is a toolkit for apps whose server stores only data it cannot read. This package gives a coding agent the documentation and a project starter without leaving the editor: the pages ship inside the npm package, nothing is fetched, and nothing runs beyond the code in src/. It has zero dependencies and needs Node 24 or later.

Three tools cover it. Two search and read the docs, and the third writes the notes starter into an empty directory, including client files, a Compose file that runs Postgres, the server and nginx, and a README of next steps. It only adds files, never overwrites, refuses a non-empty directory and runs no commands.

The site also publishes llms.txt and llms-full.txt, and gives agents guidance such as not inventing cryptography, using the one namespace string in both client and server, and stating the app's limits honestly.

## Features

- **Docs search:** Full-text search over the engine documentation with page, section and excerpt.
- **Page reader:** Reads one documentation page as Markdown.
- **Notes scaffold:** Writes a starter app into an empty directory with the namespace and origin filled in.
- **Offline by design:** Docs are bundled; no network access.
- **Zero dependencies:** Small stdio server licensed Apache-2.0.

## Good for

- Wire the encryption engine into a project from inside the editor
- Look up how the engine handles a threat model
- Generate a notes starter with Docker Compose
- Give an agent the docs without opening a browser

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp -- npx -y @microtoll/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@microtoll/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@microtoll/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@microtoll/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@microtoll/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@microtoll/mcp"
      ]
    }
  }
}
```

## Tools

- `microtoll_search_docs`: Full-text search over the engine documentation.
- `microtoll_read_doc`: Returns one documentation page as Markdown.
- `microtoll_scaffold`: Writes the notes starter into an empty directory.

## FAQ

### Does it use the network?

No. The docs are inside the package and none of the three tools uses the network.

### Can the scaffold overwrite files?

No. It refuses a directory that is not empty and never overwrites.

### How do I add it?

Run claude mcp add microtoll -- npx -y @microtoll/mcp.

### What licence and runtime?

Apache-2.0, on Node 24 or later.

### Is Microtoll Engine free?

Yes. Microtoll Engine is open source, so you can use and self-host it for free.

### How do I add Microtoll Engine to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y @microtoll/mcp

### What are the best alternatives to Microtoll Engine?

The closest alternatives to Microtoll Engine 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/microtoll-engine
