API Documentation

Overview

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

Authorization: Bearer YOUR_API_KEY

Search API

Endpoint

GET /api/open/v1/search

Search for MCPs based on keywords.

Parameters

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

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

MCP API

MCP Hub provides REST API endpoints for searching and retrieving MCP information, as well as a Model Context Protocol (MCP) compatible server endpoint.

MCP Protocol Server

POST/GET /api/open/mcp

This endpoint provides a standard Model Context Protocol (MCP) server implementation following JSON-RPC 2.0 specification, supporting both HTTP POST and Server-Sent Events (SSE) for MCP search and detail retrieval functionality.

MCP Methods

Example: Initialize Connection

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize"
}

Example: Search MCPs

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_mcp",
    "arguments": {
      "keywords": "blockchain",
      "limit": 10
    }
  }
}

Example Response

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"success\": true, \"data\": [...], \"count\": 16}"
      }
    ]
  }
}

Example: Get MCP Details

POST /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tools/call",
  "params": {
    "name": "get_mcp_detail",
    "arguments": {
      "mcp_id": "your-mcp-uuid"
    }
  }
}

SSE Connection

GET /api/open/mcp
Authorization: Bearer YOUR_API_KEY
Accept: text/event-stream

Cursor IDE Integration

MCP Hub can be easily integrated with Cursor IDE through its MCP server configuration. This allows you to search and explore MCPs directly from within your development environment.

Configuration Setup

Add the following configuration to your Cursor MCP settings file (usually located at ~/.cursor/mcp.json):

{
  "mcpServers": {
    "mcp-hub": {
      "url": "https://www.aimcp.info/api/open/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "YOUR_API_KEY_HERE",
        "Content-Type": "application/json"
      },
      "capabilities": {
        "tools": true
      }
    }
  }
}

Usage in Cursor

Once configured, you can use the MCP Hub tools directly in your Cursor chat sessions:

Available Tools

The MCP Hub integration provides the following tools in Cursor:

Troubleshooting