Skip to main content
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.
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.

​
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://api.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

VS Code & GitHub Copilot

Use MCP with GitHub Copilot in Visual Studio Code

ChatGPT

Connect ChatGPT to access Topsort documentation

Claude Desktop

Configure Claude Desktop for local development

Other Clients

Cursor, Windsurf, Continue, and more

​
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

1

Open VS Code Settings

Press Cmd+, (Mac) or Ctrl+, (Windows/Linux) to open Settings.
2

Navigate to MCP Configuration

Search for “MCP” in the settings search bar, or navigate to Extensions > GitHub Copilot > MCP.
3

Add Topsort MCP Server

Click Edit in settings.json and add:
{
  "github.copilot.chat.mcp.servers": {
    "topsort": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp"
    }
  }
}
4

Reload VS Code

Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux), type “Developer: Reload Window” and press Enter.

​
ChatGPT

ChatGPT supports remote MCP servers for Plus and Team subscribers.
1

Open ChatGPT Settings

Navigate to chat.openai.com and click your profile icon, then select Settings.
2

Access Connections

Click on Connections or Integrations in the settings sidebar.
3

Add MCP Server

Click Add Connection and enter: - Name: Topsort API Documentation
  • Server URL: https://api.docs.topsort.com/mcp - Transport Type: http

​
Claude Desktop

Claude Desktop provides comprehensive local MCP support.
1

Open Claude Desktop Settings

  • macOS: Click Claude in the menu bar → Settings
  • Windows: Click File → Settings
2

Navigate to Developer Tab

Click on the Developer tab in the left sidebar.
3

Edit MCP Configuration

Click Edit Config and add:
{
  "mcpServers": {
    "topsort-api": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp",
      "description": "Topsort API Documentation"
    }
  }
}
4

Restart Claude Desktop

Save the configuration and restart Claude Desktop.

​
Other MCP Clients

​
Cursor

Add to your Cursor settings: 
{
  "mcp": {
    "servers": {
      "topsort": {
        "type": "http",
        "url": "https://api.docs.topsort.com/mcp"
      }
    }
  }
}

​
Windsurf Editor

Configure in ~/.windsurf/mcp.json: 
{
  "servers": {
    "topsort": {
      "type": "http",
      "url": "https://api.docs.topsort.com/mcp"
    }
  }
}

​
Continue

Add to ~/.continue/config.json: 
{
  "mcpServers": {
    "topsort": {
      "transport": {
        "type": "http",
        "url": "https://api.docs.topsort.com/mcp"
      }
    }
  }
}

​
Cline

Configure in ~/Documents/Cline/MCP/config.json: 
{
  "topsort": {
    "type": "http",
    "url": "https://api.docs.topsort.com/mcp"
  }
}

​
Troubleshooting

​
Connection Issues

  • Verify the URL is correct: https://api.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 for any service disruptions
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.

​
Learn More