# Docs MCP

Canonical URL: https://docs.perisclaw.com/docs-mcp

The documentation is available as a read-only Model Context Protocol (MCP)
server. Connect it once and your agent can look up current Perisclaw behavior
instead of relying on memory or a pasted bundle of old docs.

**Note: Public documentation only**

  This MCP contains the same public pages as this website. It cannot see your
  account, WhatsApp, connected apps, or customer data, and it cannot change
  anything.

## Connect the server

### 1. Open your agent's MCP settings

Add a new remote server using **Streamable HTTP**. The exact
button name varies between Claude, Codex, Cursor, and other clients.

### 2. Use the docs endpoint

Paste this address as the remote MCP URL:

```text
https://docs.perisclaw.com/api/mcp
```

### 3. Test one lookup

Ask the agent to search the Perisclaw docs before answering a product
question. It should call `search_docs` , then read the most
relevant page.

> **Try this:** Use the Perisclaw docs to explain how I connect my WhatsApp number.

**Done when:**
The answer links back to the relevant public guide.

## Available tools

| Tool               | Use it for                                                        |
| ------------------ | ----------------------------------------------------------------- |
| `list_docs`        | Browse every public page and its direct Markdown URL.             |
| `search_docs`      | Find the best pages for a product question.                       |
| `read_doc`         | Read one page as agent-friendly Markdown.                         |
| `get_doc_markdown` | Get clean Markdown to copy into a note, prompt, or support reply. |

## Direct Markdown options

Every page also advertises a Markdown version in its metadata. For larger
imports, use [`/llms.txt`](/llms.txt) as the index or
[`/llms-full.txt`](/llms-full.txt) as a single combined document.

**Tip: Give your agent one rule**

  Tell it to search the docs before making claims about setup, capabilities,
  permissions, privacy, pricing, or integrations. That keeps answers tied to
  the current published source.

### [Connect your WhatsApp too](/mcp-server)

The Perisclaw MCP server lets AI clients read and act on your chats.