Skip to main content
GET
/
api
/
mcp-servers
curl -X GET "https://api.zudu.ai/api/mcp-servers?page=0&limit=20&sort=created_at&order=desc&search=production" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \
{
  "message": "MCP servers retrieved successfully",
  "status": "success",
  "error": null,
  "data": {
    "servers": [
      {
        "id": "mcp_abc123...",
        "organization_id": "org_1234567890",
        "server_url": "https://example.com/mcp-server",
        "server_name": "Production MCP Server",
        "approval_policy": "auto_approve_all",
        "transport": "SSE",
        "description": "Production environment server",
        "created_at": 1705320000000,
        "updated_at": 1705320000000
      }
    ],
    "total_count": 25,
    "page": 0,
    "limit": 20,
    "total_pages": 2,
    "has_next": true,
    "has_previous": false,
    "filters": {
      "search": "production"
    }
}
Retrieve a paginated list of MCP servers for your organization with advanced filtering, searching, and sorting capabilities.
curl -X GET "https://api.zudu.ai/api/mcp-servers?page=0&limit=20&sort=created_at&order=desc&search=production" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \
{
  "message": "MCP servers retrieved successfully",
  "status": "success",
  "error": null,
  "data": {
    "servers": [
      {
        "id": "mcp_abc123...",
        "organization_id": "org_1234567890",
        "server_url": "https://example.com/mcp-server",
        "server_name": "Production MCP Server",
        "approval_policy": "auto_approve_all",
        "transport": "SSE",
        "description": "Production environment server",
        "created_at": 1705320000000,
        "updated_at": 1705320000000
      }
    ],
    "total_count": 25,
    "page": 0,
    "limit": 20,
    "total_pages": 2,
    "has_next": true,
    "has_previous": false,
    "filters": {
      "search": "production"
    }
}

Headers

X-API-KEY
string
required
Your API key (format: sk_...)
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

Query Parameters

page
number
Page number (0-based indexing)
  • Default: 0
  • Minimum: 0
Example: 0 (first page)
limit
number
Number of items per page
  • Default: 20
  • Minimum: 0
  • Maximum: 100
  • Special: Set to 0 to retrieve all records (no pagination)
Example: 20 or 0 for all records
sort
string
Field to sort byOptions:
  • name - Sort by server name
  • created_at - Sort by creation date (default)
  • updated_at - Sort by last update date
Default: created_at
order
string
Sort orderOptions:
  • asc - Ascending order
  • desc - Descending order (default)
Default: desc
Search term to filter serversSearches across:
  • Server name
  • Server URL
  • Description
Example: "production" or "https://example.com"
approval_policy
string
Filter by approval policyOptions:
  • auto_approve_all
  • require_approval_all
  • require_approval_per_tool
Example: "auto_approve_all"
transport
string
Filter by transport typeOptions:
  • SSE
  • STREAMABLE_HTTP
Example: "SSE"

Response Fields

servers
array
Array of MCP server objects
total_count
number
Total number of servers matching the filters
page
number
Current page number (0-based)
limit
number
Number of items per page (or 0 if all records were requested)
total_pages
number
Total number of pages available
has_next
boolean
Whether there is a next page available
has_previous
boolean
Whether there is a previous page available
filters
object
Applied filter parameters (only included if filters were used)

Error Responses

error
string
Bad Request - Invalid query parameters
{
  "message": "Invalid sort field",
  "status": "error",
  "error": "Sort field must be one of: name, created_at, updated_at"
}
error
string
Unauthorized - Missing or invalid API key/secret

Notes

  • Use limit=0 to retrieve all servers without pagination
  • Search is case-insensitive and searches across name, URL, and description
  • Multiple filters can be combined (e.g., ?approval_policy=auto_approve_all&transport=SSE)
  • Results are scoped to your organization automatically
  • Default sorting is by creation date (newest first)