The HTTP MCP Server provides a standardized way to search and discover Model Context Protocols (MCPs) through a modern HTTP interface. It offers JSON-RPC 2.0 endpoints for finding and retrieving detailed information about MCPs registered on MCP Hub.
The MCP Hub server implements the Model Context Protocol over HTTP, providing tools to search for MCPs and retrieve their details. This server only supports HTTP-based MCP connections, as the traditional stdio-based implementation has been deprecated.
The server provides two main tools:
You need an API key from MCP Hub to use the HTTP MCP server.
Note: API keys have a rate limit of 20 requests per hour.
Configure your MCP client to connect to the HTTP server:
{
"mcpServers": {
"mcp-hub": {
"url": "https://www.aimcp.info/api/open/mcp",
"transport": "sse",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
For clients supporting simplified configuration:
{
"mcpServers": {
"mcp-hub": {
"url": "https://www.aimcp.info/api/open/mcp",
"apiKey": "YOUR_API_KEY"
}
}
}
For Cursor IDE, add to your MCP configuration:
{
"mcpServers": {
"mcp-hub": {
"url": "https://www.aimcp.info/api/open/mcp",
"transport": "sse",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
All requests require authentication using a Bearer token:
Authorization: Bearer YOUR_API_KEY
You can test the server using curl:
# Initialize connection
curl -X POST https://www.aimcp.info/api/open/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "initialize"}'
# List available tools
curl -X POST https://www.aimcp.info/api/open/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'
# Search for MCPs
curl -X POST https://www.aimcp.info/api/open/mcp \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "search_mcp", "arguments": {"keywords": "blockchain", "limit": 5}}}'
The server implements these JSON-RPC 2.0 methods:
initialize: Establish connection and get server capabilitiestools/list: Retrieve available toolstools/call: Execute specific tools with argumentsTo search for MCPs using keywords:
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_mcp",
"arguments": {
"keywords": "blockchain",
"limit": 5
}
}
}
Example response:
{
"success": true,
"data": [
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"name": "Blockchain MCP",
"brief": "A Model Context Protocol for blockchain data analysis",
"clicks": 142
}
],
"count": 1,
"total_results": 1,
"keywords": "blockchain"
}
To retrieve detailed information about a specific MCP:
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "get_mcp_detail",
"arguments": {
"mcp_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
}
"0 tools enabled": Ensure your MCP client properly handles the initialize response and capabilities.tools.listChanged flag.
Authentication errors: Verify your API key is valid and included in the Authorization header.
Connection timeouts: Verify that the MCP Hub server is accessible.
CORS errors: Ensure your client includes proper headers and handles preflight OPTIONS requests.
2024-11-05To add this MCP server to Claude Code, run this command in your terminal:
claude mcp add-json "mcp-hub" '{"url":"https://www.aimcp.info/api/open/mcp","transport":"sse","headers":{"Authorization":"Bearer YOUR_API_KEY"}}'See the official Claude Code MCP documentation for more details.
There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.
If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.
To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".
When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:
{
"mcpServers": {
"mcp-hub": {
"url": "https://www.aimcp.info/api/open/mcp",
"transport": "sse",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.
Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.
The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.
You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.
To add this MCP server to Claude Desktop:
1. Find your configuration file:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.json2. Add this to your configuration file:
{
"mcpServers": {
"mcp-hub": {
"url": "https://www.aimcp.info/api/open/mcp",
"transport": "sse",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}3. Restart Claude Desktop for the changes to take effect