# MCP Server for API Docs

This MCP server provides AI tools with search access to the Lumar API documentation site. It does not interact with the Lumar API itself — it searches the documentation content you see on this site.

## Quick Setup

Add the following to your AI tool's MCP configuration:

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

No API keys or authentication required.

## Tool-Specific Setup

### Claude Code

Add to your project's `.claude/settings.json` or global settings:

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

### Claude Desktop

Open **Settings > Developer > Edit Config** and add:

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

### Cursor

Open **Settings > MCP Servers > Add Server** and enter the URL:

```
https://api-docs.lumar.io/mcp
```

### VS Code (Copilot)

Add to your `.vscode/settings.json`:

```json
{
  "mcp": {
    "servers": {
      "lumar-api-docs": {
        "type": "http",
        "url": "https://api-docs.lumar.io/mcp"
      }
    }
  }
}
```

## Available Tools

The MCP server exposes three tools:

### `search_docs`

Search across all Lumar API documentation.

**Parameters:**

- `query` (string, required) — Search query
- `limit` (number, optional, default: 5) — Maximum results (1-20)

**Example use case:** "How do I authenticate with the Lumar API?"

### `get_doc_page`

Fetch the full content of a specific documentation page.

**Parameters:**

- `path` (string, required) — URL path of the page (e.g. `docs/graphql/authentication`)

**Example use case:** Retrieve the complete authentication guide.

### `list_doc_sections`

Browse the documentation structure and available sections.

**Parameters:** None

**Example use case:** Discover what topics are covered in the documentation.

## Health Check

The MCP server exposes a health check endpoint:

```
GET https://api-docs.lumar.io/mcp/health
```

Returns `{"status": "ok"}` when the server is running.