ApiMcp servers
List MCP servers
List all MCP servers with pagination, filtering, search, and sorting. Supports filtering by status, type, source, and credential mode.
Query Parameters
page?integer
Page number (1-indexed)
Default
1Range
1 <= valuepage_size?integer
Items per page
Default
20Range
1 <= value <= 100search?|
Text search on display_name and name
status?|
Comma-separated status filter (running, stopped, pending, error)
type?|
Comma-separated type filter (remote, npx, uvx, container)
source?|
Source filter (manual, catalog, generated)
credential_mode?|
Credential mode filter (none, managed, user_provided)
sort_by?string
Sort field (name, status, type, tool_count, updated_at, created_at)
Default
"updated_at"sort_order?string
Sort order (asc or desc)
Default
"desc"Response Body
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/servers"{
"items": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"name": "string",
"display_name": "string",
"description": "string",
"icon_url": "string",
"type": "remote",
"status": "pending",
"config": {},
"source": "manual",
"source_doc_url": "string",
"sync_schedule": "manual",
"credential_mode": "managed",
"last_synced_at": "2019-08-24T14:15:22Z",
"tool_sync_hash": "string",
"last_error": "string",
"enriched_error": {
"category": "package_not_found",
"raw_message": "string",
"user_message": "string",
"action_type": "fix_config",
"action_label": "string",
"action_url": "string",
"action_data": {},
"extracted_values": [
"string"
]
},
"portal_visible": false,
"portal_category": "string",
"portal_tags": [
"string"
],
"oauth_config": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"tool_count": 0,
"mcp_endpoint_url": "string"
}
],
"total": 0,
"page": 0,
"page_size": 0,
"status_counts": {
"running": 0,
"stopped": 0,
"pending": 0,
"error": 0
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}