API Documentation

Integrate with MCP Hub using our REST API. Access data programmatically with your API key.

Authentication

Get your API key from [your account](/dashboard/api-keys) and use it to authenticate your requests.

View Authentication

Endpoints

Use our REST API endpoints to search and explore MCP data programmatically.

View Endpoints

Examples

Learn how to use our API with code examples and documentation.

See Examples

Overview

Our API provides programmatic access to search and explore MCP data. You can use it to integrate MCP information into your applications.

Authentication

All API endpoints require an API key. You can obtain your API key from the API Keys page.

API Key Usage

Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

The API has a rate limit of 20 requests per hour. If you exceed this limit, you'll receive a 401 Unauthorized response.

Search API

Endpoint

GET /api/open/v1/search

Search for MCPs based on keywords.

Parameters

Parameter	Type	Required	Description
keywords	string	Yes	The search terms to look for

Example Request

GET /api/open/v1/search?keywords=blockchain
Authorization: Bearer YOUR_API_KEY

Example Response

{
  "data": [
    {
      "name": "Blockchain Project",
      "brief": "A decentralized blockchain solution",
      "website_url": "https://example.com"
    }
  ],
  "count": 1
}

Error Responses

Status	Description
400	Missing required parameters
401	Invalid API key or rate limit exceeded
500	Server error

MCP API

MCP Hub provides a Model Context Protocol (MCP) compatible API endpoint that allows AI assistants and tools to search for MCPs and retrieve MCP information directly.

HTTP MCP Endpoint

GET/POST /api/open/v1/streamable

This endpoint implements the Model Context Protocol over HTTP, enabling AI assistants to search and access MCP data programmatically.

SSE MCP Endpoint

GET/POST /api/open/v1/sse

This endpoint implements the Model Context Protocol using Server-Sent Events (SSE), providing a more browser-friendly alternative that works well with modern web applications. SSE maintains a single persistent connection for receiving server messages and uses separate HTTP requests for client-to-server messages.

Authentication

The MCP API requires authentication with a valid API key. You can obtain your API key from the API Keys page.

API Key Usage

Include your API key in the Authorization header for all requests:

Authorization: Bearer YOUR_API_KEY

Note: API keys have a rate limit of 20 requests per hour. Exceeding this limit will result in 401 Unauthorized responses.

Available Tools

Tool Name	Description	Parameters
search_mcp_hub	Search for MCPs on the MCP Hub	keywords (string): Search keywords
get_mcp_info	Get detailed information about a specific MCP	id (string): MCP UUID

Connection Example

1. First, establish a connection to get a session ID:

GET /api/open/v1/streamable Authorization: Bearer YOUR_API_KEY

Response:

{
  "success": true,
  "sessionId": "194830ab-eb0b-4d17-a574-af96705276c2",
  "message": "Connection established. Use this sessionId for subsequent calls."
}

2. Call a tool with the session ID and API key:

POST /api/open/v1/streamable?sessionId=194830ab-eb0b-4d17-a574-af96705276c2
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "jsonrpc": "2.0",
  "method": "callTool",
  "params": {
    "name": "search_mcp_hub",
    "arguments": {
      "keywords": "example"
    }
  },
  "id": "call-1"
}