Enables AI agents to search Microtoll documentation and scaffold end-to-end-encrypted applications directly within a coding editor.
Also known as microtoll/engine, mcp, @microtoll/mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Oct 6, 2026
- License
- —
What is Microtoll Engine MCP?
Microtoll Engine enables AI agents to search Microtoll documentation and scaffold end-to-end-encrypted applications directly within a coding editor.
Summary generated from the project's README
About Microtoll Engine MCP server
Microtoll Engine provides a Model Context Protocol server that allows AI agents to interact with Microtoll documentation and project scaffolding directly within a coding editor. It operates over standard input and output, making it compatible with hosts like Claude Code and Cursor. Because the documentation is bundled within the package as a JSON snapshot, the server functions entirely locally without fetching data from the network. This ensures that the information remains consistent with the official documentation.
Developers use three specific tools to manage their workflow. The microtoll_search_docs tool performs full-text searches to find specific pages and sections, while microtoll_read_doc retrieves entire pages in Markdown format. For starting new projects, the microtoll_scaffold tool writes a set of starter files into an empty directory, including files like package.json, docker-compose.yml, and nginx.conf. This server requires Node 24 or later and can be added to a host using npx.
What you can do with it
- 1Search technical documentationAn AI agent can perform a full-text search to find specific sections or excerpts within the Microtoll documentation.
- 2Read documentation pagesA developer can instruct an AI to read a specific documentation page in Markdown format to understand a feature.
- 3Scaffold a new projectAn agent can initialize a new project by writing a standard set of starter files into an empty directory.
Written from the project's README. Every use case is checked against a quote from it.
How to install Microtoll Engine MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Microtoll Engine MCP in Claude Code
$ claude mcp add mcp -- npx -y @microtoll/mcpInstall Microtoll Engine MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@microtoll/mcp"
]
}
}
}Install Microtoll Engine MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@microtoll/mcp"
]
}
}
}Install Microtoll Engine MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@microtoll/mcp"]}'Install Microtoll Engine MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@microtoll/mcp"
]
}
}
}Install Microtoll Engine MCP in Codex
$ codex mcp add mcp -- npx -y @microtoll/mcpInstall Microtoll Engine MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@microtoll/mcp"]
Install Microtoll Engine MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @microtoll/mcpInstall Microtoll Engine MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@microtoll/mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablemicrotoll/engine is public and reachablegithub.com/microtoll/engine ↗Pass
- Package names this repository as its source@microtoll/mcp names microtoll/engine as sourcenpmjs.com/package/@microtoll/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @microtoll/mcpnpmjs.com/package/@microtoll/mcp/v/0.1.3#provenance ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-06github.com/microtoll/engine ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @microtoll/mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@microtoll/mcp
Microtoll Engine inside your coding tool. A Model Context Protocol server
(over standard input and output) that Claude Code, Cursor and any MCP host
can call for the engine's documentation and for a project scaffold, so an
agent can wire the engine in without leaving the editor — and without
leaving the machine: the pages are inside the package, nothing is fetched,
nothing runs but what is in src/.
Status: published as @microtoll/mcp on npm and listed in the MCP
registry as io.github.microtoll/mcp. Apache-2.0. Zero dependencies.
Node 24 or later.
Add it to a host
claude mcp add microtoll -- npx -y @microtoll/mcp
Any other host takes the same command (npx -y @microtoll/mcp) as a stdio
server.
The three tools
| Tool | What it does |
|---|---|
microtoll_search_docs({ query, limit? }) |
Full-text search over the documentation — the same pages as microtoll.dev, shipped in generated/docs.json by the repository's docs build so they never drift. Returns page, section and excerpt. |
microtoll_read_doc({ path }) |
One page as Markdown, by the path a search result gives (packages/access.html) or from llms.txt. |
microtoll_scaffold({ directory, namespace?, origin?, name? }) |
Writes the notes starter into an empty directory: notes.js, page.js, index.html, docker-compose.yml, nginx.conf, package.json, README.md, with the namespace and origin filled in. Writes files and nothing else; refuses a directory that is not empty; never overwrites. The next steps (npm install, docker compose up) come back as text for the person to run. |
Each tool also carries a plain title and the specification's behaviour
hints (annotations), which a host may use to decide when to ask the
person first. The two documentation tools only read; the scaffold writes
files but only adds them (it never deletes or overwrites), and a second
call with the same arguments changes nothing; none of the three uses the
network.
What it speaks
JSON-RPC 2.0, one message per line: initialize (protocol version
2025-06-18, tools capability), ping, tools/list, tools/call;
notifications are acknowledged by silence; a tool's failure is a tool
result with isError, a protocol failure a JSON-RPC error. About 120 lines
in src/protocol.js, tested against a transcript of what a host sends.
Tests
npm test: the protocol over a real child process, the search and the
page reader over the shipped snapshot, the scaffold into a temporary
directory (placeholders filled, a non-empty directory refused), and each
tool's title and behaviour hints against what the tool does.
Microtoll Engine MCP questions
How do I add Microtoll Engine MCP to Claude Code?
Run claude mcp add mcp -- npx -y @microtoll/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Microtoll Engine MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I add Microtoll Engine to my MCP host?
You can add it using the command: claude mcp add microtoll -- npx -y @microtoll/mcp or by using npx -y @microtoll/mcp as a stdio server in other hosts.
Does this server require an internet connection to access documentation?
No, the documentation is contained within the package itself, so nothing is fetched from the network.
What happens if I use the scaffold tool on a directory that already contains files?
The scaffold tool refuses to work on any directory that is not empty and will never overwrite existing files.
What are the system requirements for running this server?
The server requires Node.js version 24 or later.