API Reference

Complete reference for MCPHub APIs, authentication, and integration endpoints.

🔑 Authentication

API Keys

MCPHub uses API keys for authentication. Get your API key from the Settings page.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.mcphub.com/api/v3/mcp-servers

🌐 Base URLs

Production API

https://api.mcphub.com

MCP Server Hosting

https://api.mcphub.com/slug/{server-slug}

Path-Based Auth

https://api.mcphub.com/auth/{api-key}/{server-slug}

📡 Core Endpoints

MCP Servers

GET/api/v3/mcp-servers

Get list of all MCP servers

Parameters
page - Page number (default: 1)
limit - Items per page (default: 20)
tag - Filter by tag
search - Search query
GET/api/v3/mcp-server/detail/{id}

Get detailed information about a specific MCP server

Response
{
  "id": "author/server-name",
  "name": "Server Name", 
  "description": "Server description",
  "onlineServerUrl": "https://api.mcphub.com/slug/...",
  "tools": ["tool1", "tool2"],
  "resources": ["resource1", "resource2"],
  "prompts": ["prompt1", "prompt2"]
}

User Management

POST/api/v3/user/api-keys

Create a new API key

Request Body
{
  "name": "My API Key",
  "description": "Description (optional)",
  "env": "transient"
}
GET/api/v3/user/api-keys

List all API keys for the authenticated user

📝 Response Format

All API responses follow a consistent format:

{
  "code": 0,           // 0 = success, non-zero = error
  "message": "Success", // Human-readable message
  "data": {...}        // Response data (varies by endpoint)
}

⚠️ Rate Limits

API Requests

1000 requests per hour per API key

MCP Server Calls

Based on your account tier and available credits

Need Help?

Check out our Integration Guide for detailed examples, or visit our FAQ for common questions.