# picomcp docs

> picomcp docs is an open-source MCP server for developer tools. Search and read picomcp documentation from your coding agent while it writes MCP servers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://picomcp.github.io/picomcp/docs/agents
- **Repository:** https://github.com/picomcp/picomcp/tree/HEAD/packages/docs
- **MCP Registry name:** io.github.picomcp/picomcp-docs
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

picomcp-docs is a documentation server for developers who build MCP servers with the picomcp TypeScript library and let an agent write the code. Instead of pasting docs into a chat, the agent searches and reads them as needed.

On first call it downloads the site's `llms-full.txt` and keeps it in memory, so it always serves the latest published docs with nothing to update. Setting `PICOMCP_DOCS` points it at another copy, such as a local build. It needs Node 22 or later and is MIT licensed.

The project is itself a demonstration: the server is built with picomcp in about 100 lines. The docs site also lists common mistakes agents make, such as writing to stdout in a stdio server.

## Features

- **List pages:** Lists every documentation page with its URL.
- **Search docs:** Finds matching pages with a short excerpt.
- **Read as Markdown:** Returns a full page by title or slug.
- **Page resources:** Every page is also a picomcp-docs resource.
- **Always current:** Fetches the latest llms-full.txt from the docs site.
- **Local build override:** Point PICOMCP_DOCS at another copy.

## Good for

- Give a coding agent accurate picomcp reference
- Check how tools and resources are defined
- Avoid common stdio mistakes
- Read docs against a local build

## Install

### Claude Code (Terminal)

```sh
claude mcp add picomcp-docs -- npx -y picomcp-docs
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "picomcp-docs": {
      "command": "npx",
      "args": [
        "-y",
        "picomcp-docs"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "picomcp-docs": {
      "command": "npx",
      "args": [
        "-y",
        "picomcp-docs"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "picomcp-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "picomcp-docs"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "picomcp-docs": {
      "command": "npx",
      "args": [
        "-y",
        "picomcp-docs"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "picomcp-docs": {
      "command": "npx",
      "args": [
        "-y",
        "picomcp-docs"
      ]
    }
  }
}
```

## Tools

- `list_docs`: Lists every documentation page with its URL.
- `search_docs`: Finds pages that match a query, with a short excerpt.
- `read_doc`: Returns a full page as Markdown by title or slug.

## FAQ

### How do I install it?

Run `claude mcp add picomcp-docs -- npx -y picomcp-docs`, or add the same command to your client's config.

### What Node version?

22 or later.

### How does it stay updated?

It downloads llms-full.txt on first call.

### Licence?

MIT.

### Is picomcp docs free?

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

### How do I add picomcp docs to Claude Code?

Run this command in your terminal: claude mcp add picomcp-docs -- npx -y picomcp-docs

### What are the best alternatives to picomcp docs?

The closest alternatives to picomcp docs 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/picomcp-docs
