curl -X POST https://api.mcprank.com/v1/search \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"query": "send emails and manage calendar",
"limit": 5
}'
{
"servers": [
{
"id": "google-workspace",
"name": "Google Workspace",
"description": "Access Gmail, Calendar, Drive, and other Google services",
"remote_url": "https://mcp.google.com/workspace",
"tools": [
{
"name": "send_email",
"description": "Send an email via Gmail",
"input_schema": {
"type": "object",
"properties": {
"to": { "type": "string" },
"subject": { "type": "string" },
"body": { "type": "string" }
},
"required": ["to", "subject", "body"]
}
},
{
"name": "create_calendar_event",
"description": "Create a new calendar event",
"input_schema": {
"type": "object",
"properties": {
"title": { "type": "string" },
"start_time": { "type": "string" },
"end_time": { "type": "string" }
},
"required": ["title", "start_time"]
}
}
],
"scores": {
"semantic": 0.92,
"popularity": 0.85
},
"final_score": 0.89
}
],
"metadata": {
"latency_ms": 45,
"cache_hit": false,
"total_candidates": 492,
"query_log_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
Search for MCP servers matching a query
curl -X POST https://api.mcprank.com/v1/search \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"query": "send emails and manage calendar",
"limit": 5
}'
{
"servers": [
{
"id": "google-workspace",
"name": "Google Workspace",
"description": "Access Gmail, Calendar, Drive, and other Google services",
"remote_url": "https://mcp.google.com/workspace",
"tools": [
{
"name": "send_email",
"description": "Send an email via Gmail",
"input_schema": {
"type": "object",
"properties": {
"to": { "type": "string" },
"subject": { "type": "string" },
"body": { "type": "string" }
},
"required": ["to", "subject", "body"]
}
},
{
"name": "create_calendar_event",
"description": "Create a new calendar event",
"input_schema": {
"type": "object",
"properties": {
"title": { "type": "string" },
"start_time": { "type": "string" },
"end_time": { "type": "string" }
},
"required": ["title", "start_time"]
}
}
],
"scores": {
"semantic": 0.92,
"popularity": 0.85
},
"final_score": 0.89
}
],
"metadata": {
"latency_ms": 45,
"cache_hit": false,
"total_candidates": 492,
"query_log_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
Show Server object
curl -X POST https://api.mcprank.com/v1/search \
-H "X-API-Key: your-api-key" \
-H "Content-Type: application/json" \
-d '{
"query": "send emails and manage calendar",
"limit": 5
}'
{
"servers": [
{
"id": "google-workspace",
"name": "Google Workspace",
"description": "Access Gmail, Calendar, Drive, and other Google services",
"remote_url": "https://mcp.google.com/workspace",
"tools": [
{
"name": "send_email",
"description": "Send an email via Gmail",
"input_schema": {
"type": "object",
"properties": {
"to": { "type": "string" },
"subject": { "type": "string" },
"body": { "type": "string" }
},
"required": ["to", "subject", "body"]
}
},
{
"name": "create_calendar_event",
"description": "Create a new calendar event",
"input_schema": {
"type": "object",
"properties": {
"title": { "type": "string" },
"start_time": { "type": "string" },
"end_time": { "type": "string" }
},
"required": ["title", "start_time"]
}
}
],
"scores": {
"semantic": 0.92,
"popularity": 0.85
},
"final_score": 0.89
}
],
"metadata": {
"latency_ms": 45,
"cache_hit": false,
"total_candidates": 492,
"query_log_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
| Status Code | Description |
|---|---|
| 400 | Invalid request (e.g., query too long) |
| 401 | Missing or invalid API key |
| 429 | Rate limit exceeded |
| 500 | Internal server error |