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

# Documentation MCP Server

> Integrate our MCP server with your agents to become productive in no time

export const IntegrationsCard1A = () => {
  return <>
      <style>{`
        .integrations-card-1a {
          display: flex;
          flex-direction: column;
          background-color: #f0f2f4;
          border: 1px solid rgba(0, 0, 0, 0.08);
          border-radius: 12px;
          padding: 1.25rem 1.5rem;
          gap: 0.25rem;
          color: #25253b;
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);
          transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;
          margin-top: 2rem;
        }

        .integrations-card-1a:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);
          border-color: rgba(0, 0, 0, 0.12);
        }

        .dark .integrations-card-1a {
          background-color: #25253b;
          color: #f6f8fa;
          border-color: rgba(255, 255, 255, 0.08);
          box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);
        }

        .dark .integrations-card-1a:hover {
          box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);
          border-color: rgba(255, 255, 255, 0.12);
        }

        .integrations-card-1a-avatar-row {
          display: flex;
          margin-left: 14px;
          flex-wrap: nowrap;
        }

        .integrations-card-1a-avatar {
          width: 44px;
          height: 44px;
          border-radius: 50%;
          border: 2px solid #f0f2f4;
          margin-left: -14px;
          object-fit: cover;
          box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);
          pointer-events: none;
          cursor: default;
        }

        .dark .integrations-card-1a-avatar {
          border-color: #25253b;
          box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
        }

        .integrations-card-1a h2 {
          margin: 0;
          line-height: 1.25;
          font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);
          font-weight: 700;
          letter-spacing: -0.025em;
          color: #111827;
        }

        .dark .integrations-card-1a h2 {
          color: #f9fafb;
        }

        .integrations-card-1a-subtitle {
          font-size: 0.9375rem;
          font-weight: 500;
          line-height: 1.5;
          color: #4b5563;
          margin: 0;
        }

        .dark .integrations-card-1a-subtitle {
          color: #d1d5db;
        }

        .integrations-card-1a p {
          margin: 0;
          line-height: 1.5;
          font-size: 0.875rem;
          color: #374151;
        }

        .dark .integrations-card-1a p {
          color: #d1d5db;
        }

        .integrations-card-1a a {
          color: #0500ff;
          text-decoration: none;
          font-weight: 500;
          transition: color 0.15s ease;
        }

        .integrations-card-1a a:hover {
          color: #0400cc;
        }

        .dark .integrations-card-1a a {
          color: #8280ff;
        }

        .dark .integrations-card-1a a:hover {
          color: #a19fff;
        }

        @media (max-width: 640px) {
          .integrations-card-1a-avatar {
            width: 38px;
            height: 38px;
            margin-left: -12px;
          }

          .integrations-card-1a-avatar-row {
            margin-left: 12px;
          }
        }

        @media (min-width: 1280px) {
          .integrations-card-1a p {
            font-size: 0.6875rem;
            line-height: 1.4;
            letter-spacing: -0.01em;
          }

          .integrations-card-1a h2 {
            font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);
          }

          .integrations-card-1a-subtitle {
            font-size: 0.75rem;
          }
        }
      `}</style>
      <div className="integrations-card-1a">
        <div className="integrations-card-1a-avatar-row">
          <img src="/images/integration-team/agustin.webp" alt="Agustin - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/amelia.webp" alt="Amelia - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/bernardita.webp" alt="Bernardita - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/borumy.webp" alt="Borumy - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/felipe.webp" alt="Felipe - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/gui.webp" alt="Gui - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/javiera.webp" alt="Javiera - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/linn.webp" alt="Linn - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/marcio.webp" alt="Marcio - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/mateus.webp" alt="Mateus - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/max.webp" alt="Max - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
          <img src="/images/integration-team/rodrigo.webp" alt="Rodrigo - Integrations Team Member" loading="lazy" className="integrations-card-1a-avatar" />
        </div>

        <h2>Need help with your Topsort integration?</h2>

        <p className="integrations-card-1a-subtitle">
          Talk to us, the integrations engineering team.
        </p>

        <p>
          Reach us via <strong>your dedicated messaging channel</strong> or at{" "}
          <a href="mailto:support@topsort.com">support@topsort.com</a>.
        </p>

        <p>
          If you're not a customer yet,{" "}
          <a href="https://www.topsort.com/book-a-demo">book a demo</a> with our
          sales team instead.
        </p>
      </div>
    </>;
};

The **Model Context Protocol (MCP)** is an open-source standard for connecting AI applications to external systems. Topsort provides an MCP server through Mintlify that gives AI assistants direct access to our complete API documentation, enabling them to provide accurate, up-to-date information about our APIs.

<Tip>
  Think of MCP like a USB-C port for AI applications. Just as USB-C provides a
  standardized way to connect devices, MCP provides a standardized way to
  connect AI applications to external data sources like our API documentation.
</Tip>

<Note>
  Looking for real-time analytics and campaign insights? Check out our [Analytics MCP Server](/api/mcp-analytics) for direct access to advertising metrics, benchmarks, and visualizations.
</Note>

## What You Can Do

By connecting to Topsort's MCP server, AI assistants can:

* **Access complete API documentation** - Query endpoint details, parameters, request/response schemas, and examples
* **Get accurate integration guidance** - Receive up-to-date code examples and implementation instructions
* **Troubleshoot faster** - Quickly reference error codes, rate limits, and authentication methods
* **Stay current** - Always access the latest API documentation without manual updates

## Quick Start

Our MCP server is available at:

```
https://docs.topsort.com/mcp
```

The MCP server is publicly accessible and doesn't require authentication. However, you'll need API keys to actually use the Topsort API in your applications.

## Integration Guides

<CardGroup cols={2}>
  <Card title="VS Code & GitHub Copilot" icon="microsoft" href="#vs-code-with-github-copilot">
    Use MCP with GitHub Copilot in Visual Studio Code
  </Card>

  <Card title="ChatGPT" icon="message" href="#chatgpt">
    Connect ChatGPT to access Topsort documentation
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="#claude-desktop">
    Configure Claude Desktop for local development
  </Card>

  <Card title="Other Clients" icon="puzzle-piece" href="#other-mcp-clients">
    Cursor, Windsurf, Continue, and more
  </Card>
</CardGroup>

## VS Code with GitHub Copilot

GitHub Copilot supports MCP servers in both the coding agent and the chat interface.

### Prerequisites

* **VS Code** version 1.95.0 or later
* **GitHub Copilot** extension installed and activated
* **GitHub Copilot Chat** extension installed

### Configuration

<Steps>
  <Step title="Open VS Code Settings">
    Press `Cmd+,` (Mac) or `Ctrl+,` (Windows/Linux) to open Settings.
  </Step>

  <Step title="Navigate to MCP Configuration">
    Search for "MCP" in the settings search bar, or navigate to **Extensions** > **GitHub Copilot** > **MCP**.
  </Step>

  <Step title="Add Topsort MCP Server">
    Click **Edit in settings.json** and add:

    ```json theme={null}
    {
      "github.copilot.chat.mcp.servers": {
        "topsort": {
          "type": "http",
          "url": "https://docs.topsort.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Reload VS Code">
    Press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux), type "Developer: Reload Window" and press Enter.
  </Step>
</Steps>

## ChatGPT

ChatGPT supports remote MCP servers for Plus and Team subscribers.

<Steps>
  <Step title="Open ChatGPT Settings">
    Navigate to [chat.openai.com](https://chat.openai.com) and click your
    profile icon, then select **Settings**.
  </Step>

  <Step title="Access Connections">
    Click on **Connections** or **Integrations** in the settings sidebar.
  </Step>

  <Step title="Add MCP Server">
    Click **Add Connection** and enter: - **Name**: `Topsort API Documentation`

    * **Server URL**: `https://docs.topsort.com/mcp` - **Transport Type**:
      `http`
  </Step>
</Steps>

## Claude Desktop

Claude Desktop provides comprehensive local MCP support.

### Prerequisites

* **Node.js** installed on your system (required for `mcp-remote`)

### Configuration

<Steps>
  <Step title="Open Claude Desktop Settings">
    * **macOS**: Click **Claude** in the menu bar → **Settings**
    * **Windows**: Click **File** → **Settings**
  </Step>

  <Step title="Navigate to Developer Tab">
    Click on the **Developer** tab in the left sidebar.
  </Step>

  <Step title="Edit MCP Configuration">
    Click **Edit Config** and add:

    ```json theme={null}
    {
      "mcpServers": {
        "topsort-docs": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://docs.topsort.com/mcp"
          ]
        }
      }
    }
    ```
  </Step>

  <Step title="Restart Claude Desktop">
    Save the configuration and restart Claude Desktop.
  </Step>
</Steps>

## Other MCP Clients

### Cursor

Add to your Cursor settings:

```json theme={null}
{
  "mcp": {
    "servers": {
      "topsort": {
        "type": "http",
        "url": "https://docs.topsort.com/mcp"
      }
    }
  }
}
```

### Windsurf Editor

Configure in `~/.codeium/windsurf/mcp_config.json`:

```json theme={null}
{
  "mcpServers": {
    "topsort-docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://docs.topsort.com/mcp"
      ]
    }
  }
}
```

<Note>
  Windsurf requires the `mcp-remote` package to connect to remote MCP servers. Ensure Node.js is installed on your system.
</Note>

### Continue

Add to `~/.continue/config.json`:

```json theme={null}
{
  "mcpServers": {
    "topsort": {
      "transport": {
        "type": "http",
        "url": "https://docs.topsort.com/mcp"
      }
    }
  }
}
```

### Cline

Configure in `~/Documents/Cline/MCP/config.json`:

```json theme={null}
{
  "topsort": {
    "type": "http",
    "url": "https://docs.topsort.com/mcp"
  }
}
```

## Troubleshooting

### Connection Issues

* Verify the URL is correct: `https://docs.topsort.com/mcp`
* Check your internet connection
* Restart your MCP client application
* Review client-specific logs for error messages

### Server Not Responding

* Verify the transport type is set to `http`
* Check if your firewall or VPN is blocking the connection
* Check [our status page](https://status.topsort.com) for any service disruptions

<Warning>
  While the MCP server itself doesn't require authentication, you'll still need
  valid API keys to actually use the Topsort API in your applications. Never
  share your API keys in conversations or commit them to version control.
</Warning>

## Learn More

* [Model Context Protocol Documentation](https://modelcontextprotocol.io)
* [MCP Client List](https://modelcontextprotocol.io/clients)
* [Topsort API Documentation](https://api.docs.topsort.com)

<IntegrationsCard1A />
