---
title: "MCP"
url: "/help/buuk/guides/mcp"
updated: "2026-10-22T11:14:06.713Z"
---
# MCP

Buuk speaks the Model Context Protocol (JSON-RPC 2.0) over HTTP. Use your `buuk_cli_` token for the authenticated endpoint, or point read-only agents at a workspace's public endpoint.

## Authenticated endpoint

Full read and write tools for the token's workspace. Send the token in the `Authorization` header.

```bash
curl -X POST https://app.getbuuk.com/api/mcp \
  -H "Authorization: Bearer buuk_cli_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'
```

## Public endpoint

Read-only access to a public help center — no token required. Private sections and hidden or group-only articles are never returned. Enable it from **Settings → General**.

```bash
curl -X POST https://app.getbuuk.com/api/public/mcp/buuk \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

## Methods and tools

Call `initialize`, `ping`, `tools/list`, or `tools/call`. The server exposes seven tools:

- search_docs — search published help articles, guides, and FAQs
- get_article — fetch one published article by slug or id
- list_sections — list docs sections in display order
- list_recent_updates — most recently updated published articles
- list_api_specs — published OpenAPI specs with operation counts
- search_api_reference — search API reference operations
- get_api_operation — fetch one API operation as LLM-readable markdown

> [!TIP]
> Prefer a read-only token for agents that should not edit live articles.