---
title: "MCP server"
description: "Connect Claude, Cursor, VS Code and other AI tools to the Otus Analytics docs with MCP."
canonical_url: "https://docs.otusanalytics.com/ai/mcp"
---

> Index of every page on this site: [llms.txt](https://docs.otusanalytics.com/llms.txt)

The Otus Analytics docs include an [MCP](https://modelcontextprotocol.io/) (Model Context Protocol) server. Connect it to your AI assistant and it can search and read these docs while it answers your questions. This helps when you're installing the tracker, setting up events or troubleshooting.

<callout icon="i-lucide-info">

The MCP server gives access to the **documentation** only. It can't read your analytics data or change your account.

</callout>

## Server address

The server uses the Streamable HTTP transport and needs no authentication:

```txt
https://docs.otusanalytics.com/mcp
```

## Available tools

<table>
<thead>
  <tr>
    <th>
      Tool
    </th>
    
    <th>
      What it does
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        list_pages
      </code>
    </td>
    
    <td>
      Lists the docs pages with their titles and descriptions.
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        search_pages
      </code>
    </td>
    
    <td>
      Searches all pages for a word or phrase, such as <code>
        consent mode
      </code>
      
       or <code>
        ecommerce
      </code>
      
      .
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        get_page_markdown
      </code>
    </td>
    
    <td>
      Returns the full content of one page as Markdown.
    </td>
  </tr>
</tbody>
</table>

You don't need to call these yourself. Your assistant chooses when to use them, for example when you ask "How do I track purchases with Otus?"

## Setup

### Claude Code

Run:

```bash
claude mcp add --transport http otus-docs https://docs.otusanalytics.com/mcp
```

### Claude (web and desktop)

1. Open **Settings** > **Connectors**.
2. Click **Add custom connector**.
3. Enter `Otus Analytics Docs` as the name and `https://docs.otusanalytics.com/mcp` as the URL.

### ChatGPT

1. Open **Settings** > **Apps & Connectors** and turn on **Developer mode** under **Advanced settings**.
2. Click **Create** and enter `https://docs.otusanalytics.com/mcp` as the MCP server URL, with no authentication.

### Cursor

Create or update `.cursor/mcp.json` in your project, or `~/.cursor/mcp.json` to use it in every project:

```json [.cursor/mcp.json]
{
  "mcpServers": {
    "otus-docs": {
      "type": "http",
      "url": "https://docs.otusanalytics.com/mcp"
    }
  }
}
```

### Visual Studio Code

Make sure GitHub Copilot Chat is installed, then create or update `.vscode/mcp.json`:

```json [.vscode/mcp.json]
{
  "servers": {
    "otus-docs": {
      "type": "http",
      "url": "https://docs.otusanalytics.com/mcp"
    }
  }
}
```

### Windsurf

1. Open **Windsurf Settings** > **Cascade** and click **Manage MCPs**.
2. Select **View raw config** and add:

```json [mcp_config.json]
{
  "mcpServers": {
    "otus-docs": {
      "serverUrl": "https://docs.otusanalytics.com/mcp"
    }
  }
}
```

### Zed

Add a context server to your Zed settings:

```json [settings.json]
{
  "context_servers": {
    "otus-docs": {
      "url": "https://docs.otusanalytics.com/mcp"
    }
  }
}
```

### Other tools

Any MCP client that supports remote servers over HTTP works with the address above. If your tool only supports local (stdio) servers, use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

```bash
npx mcp-remote https://docs.otusanalytics.com/mcp
```

## Without MCP

If your assistant doesn't support MCP, you can still give it the docs:

- Add `.md` to the end of any docs URL to get the page as Markdown.
- Use [`/llms.txt`](https://docs.otusanalytics.com/llms.txt) for an index of every page, or [`/llms-full.txt`](https://docs.otusanalytics.com/llms-full.txt) for the complete docs in one file.
- Use **Copy page**, **Open in ChatGPT** or **Open in Claude** at the top of any page.

## Discovery

AI agents that support automatic discovery can find the server through its server card at [`/.well-known/mcp.json`](https://docs.otusanalytics.com/.well-known/mcp.json).

## Sitemap

See the full [sitemap](https://docs.otusanalytics.com/sitemap.md) for all pages.
