---
sidebar_position: 9
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lium.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Endpoint

The Lium docs site exposes a [Model Context Protocol](https://modelcontextprotocol.io) endpoint at `/mcp`. AI agents and MCP-compatible clients can use this to search the documentation and read individual pages.

:::info For agents
This endpoint is for the **docs**. To call the **platform** API directly (create pods, manage volumes, …), use the live [OpenAPI spec](./openapi) at `https://lium.io/api/openapi.json`. The [AI Agents](./agents) page shows when to reach for which surface.
:::

## Endpoint

```
POST https://docs.lium.io/mcp
```

The endpoint uses the MCP HTTP transport (JSON-RPC 2.0 over HTTP POST).

## Available tools

### `search`

Full-text search across all documentation pages, with optional audience filtering.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | yes | Search query |
| `audience` | string | no | Filter to one audience: `providers`, `validators`, `pod-users`, `developers` |
| `limit` | number | no | Max results (default: 10) |

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "register a node",
      "audience": "providers",
      "limit": 5
    }
  }
}
```

### `read_page`

Read a page's source markdown by URL or slug. Resolution order: full URL > absolute slug (`/providers/quickstart`) > basename (`quickstart`), with tie-breaking by audience nav order.

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url_or_slug` | string | yes | Full URL, absolute slug, or page basename |

**Example:**

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "read_page",
    "arguments": {
      "url_or_slug": "/providers/quickstart"
    }
  }
}
```

## Using with Claude

To connect Claude to the Lium docs MCP server, add it to your MCP configuration:

```json
{
  "mcpServers": {
    "lium-docs": {
      "url": "https://docs.lium.io/mcp"
    }
  }
}
```

## `.md` URLs

Every page on the docs site is also available as a raw markdown URL by appending `.md`:

```bash
curl https://docs.lium.io/providers/quickstart.md
```

You can also use `Accept: text/markdown` on any page URL:

```bash
curl -H 'Accept: text/markdown' https://docs.lium.io/providers/quickstart
```