Skip to main content
GET
/
api
/
mcp-servers
List MCP servers
curl --request GET \
  --url http://localhost:8080/api/mcp-servers \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-API-SECRET: <api-key>'
{
  "message": "MCP servers retrieved successfully",
  "status": "success",
  "error": null,
  "data": [
    {
      "id": "mcp_016e64b3-7782-45ca-87be-3fc343b8242e",
      "organization_id": "org_2zC2v0GqxbrfKq1rKazb3gFcPEq",
      "url": "https://test-mcp-server.example.com",
      "name": "Test MCP Server",
      "approval_policy": "auto_approve_all",
      "transport": "WebSocket",
      "description": "Test server for API validation",
      "request_headers": {},
      "is_creator": true,
      "role": "admin",
      "created_at": 1751401457880,
      "updated_at": 1751401457880,
      "tool_approval_hashes": [],
      "dependent_agents": [],
      "config": {
        "tool_approval_hashes": [],
        "approval_policy": "auto_approve_all",
        "name": "Test MCP Server",
        "request_headers": {},
        "description": "Test server for API validation",
        "transport": "WebSocket",
        "url": "https://test-mcp-server.example.com"
      },
      "access_info": {
        "role": "admin",
        "creator_email": null,
        "creator_name": null,
        "is_creator": true
      },
      "metadata": {
        "owner_user_id": null,
        "created_at": 1751401457880
      }
    }
  ]
}

Authorizations

X-API-KEY
string
header
required

API Key for MCP server and external service authentication

X-API-SECRET
string
header
required

API Secret for MCP server and external service authentication

Query Parameters

page
integer<int32>
default:0

Page number (0-based)

Required range: x >= 0
Example:

0

limit
integer<int32>
default:20

Items per page (1-100, 0 = all)

Required range: 0 <= x <= 100
Example:

20

sort
string
default:created_at

Sort field: name, url, created_at, updated_at

Example:

"created_at"

order
string
default:desc

Sort order: asc, desc

Example:

"desc"

Search in name, URL, description

approval_policy
string

Filter by approval policy

transport
string

Filter by transport type (SSE, WebSocket, HTTP)

Response

MCP servers retrieved successfully

message
string
status
string
error
string | null
data
object[]