# aparté docs

> aparté docs is an open-source MCP server for developer tools. Search and read the aparté component docs from a coding agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://apartejs.dev/guides/docs-for-agents/
- **Repository:** https://github.com/apartejs/aparte/tree/HEAD/packages/tools/docs-mcp
- **MCP Registry name:** io.github.PaulRichez/aparte-docs-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

This server turns the aparté documentation into something a coding agent can search while it writes your integration. It reads the text the docs site publishes for models, the llms.txt index and its per-topic files, so answers match the version that ships.

Four tools cover the loop: list the topics with one sentence each, search pages by plain words such as how to approve a tool call, read one page as Markdown, or pull a whole topic at once. Topics include theming, tools and approval, running the agent loop on a server, and providers and transports.

Start it with npx @aparte/docs-mcp. It needs network access to apartejs.dev, though APARTE_DOCS_URL can point it at a local or staging docs build. A createDocsMcpServer helper embeds it in your own host.

## Features

- **Topic list:** Lists documentation sets with a one-sentence summary.
- **Plain-word search:** Returns matching pages with snippets.
- **Page reader:** Fetches a page as Markdown.
- **Whole-topic read:** Returns a full topic at once.
- **Custom docs URL:** Can serve an offline or staging build.

## Good for

- Have an agent find how to approve tool calls
- Look up theming variables while styling
- Read the provider setup before wiring a model
- Test against a local docs build

## Install

### Claude Code (Terminal)

```sh
claude mcp add aparte-docs-mcp -- npx -y @aparte/docs-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `list_sets`: Lists documentation topics with a sentence each.
- `search_docs`: Searches pages by plain words and returns snippets.
- `get_page`: Returns one page as Markdown.
- `get_set`: Returns a whole topic at once.

## FAQ

### How do I install it?

Run npx -y @aparte/docs-mcp or add it with claude mcp add aparte-docs.

### Does it work offline?

It reads apartejs.dev, so it needs the network unless you point APARTE_DOCS_URL elsewhere.

### Do I need it?

Not necessarily; you can give a model the llms.txt index instead.

### Which clients work?

Claude Code, Claude Desktop, Cursor and other MCP clients.

### Is aparté docs free?

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

### How do I add aparté docs to Claude Code?

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

### What are the best alternatives to aparté docs?

The closest alternatives to aparté 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/aparte-docs
