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 Server

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.

SSE MCP Endpoint

GET/POST /mcp/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 the MCP Hub for MCPs based on keywords	keywords (string): Search keywords apiKey (string): API key for authentication
get_mcp_info	Get detailed information about a specific MCP	mcp_id (string): MCP UUID apiKey (string): API key for authentication

Connection Example

SSE Connection (Recommended)

For browser-friendly applications:

GET https://mcp.aimcp.info/mcp/sse Authorization: Bearer YOUR_API_KEY

Integration with Claude or other AI Assistants

Example Claude API configuration:

import anthropic
import json

client = anthropic.Anthropic(api_key="your-anthropic-api-key")

response = client.messages.create(
    model="claude-3-opus-20240229",
    max_tokens=1000,
    messages=[
        {"role": "user", "content": "Search for MCP info about AI"}
    ],
    system="Use MCP tools to search for information.",
    mcpServers={
        "mcpHubWorker": {
            "url": "https://mcp.aimcp.info/mcp/sse",
            "transport": "sse",
            "apiKey": "YOUR_API_KEY"
        }
    }
)

Use in Cursor

Example Cursor configuration:

"mcpHubWorker": {
      "url": "https://mcp.aimcp.info/mcp/sse",
      "transport": "sse",
      "apiKey": "YOUR_API_KEY"
    },