MCP Endpoint

The Lium docs site exposes a Model Context Protocol endpoint at /mcp. AI agents and MCP-compatible clients can use this to search the documentation and read individual pages.

For agents

This endpoint is for the docs. To call the platform API directly (create pods, manage volumes, …), use the live OpenAPI spec at https://lium.io/api/openapi.json. The AI 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:

{
  "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:

{
  "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:

{
  "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:

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

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

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