Compozy Symbol
ALPHA
DocsInstallGetting StartedFeaturesPricing
CoreCLI ReferenceSchema DefinitionAPI Reference

MCPs

Model Context Protocol server endpoints

Model Context Protocol server endpoints

List MCP servers

List MCP server configurations with cursor pagination.

GET
/mcps

Query Parameters

project?string

Project override

limit?integer

Page size (max 500)

cursor?string

Opaque pagination cursor

q?string

Filter by MCP ID prefix

Response Body

curl -X GET "https://loading/api/v0/mcps?project=string&limit=0&cursor=string&q=string"
{
  "data": {
    "mcps": [
      {
        "args": [
          "string"
        ],
        "command": "string",
        "env": {
          "property1": "string",
          "property2": "string"
        },
        "etag": "abc123",
        "headers": {
          "property1": "string",
          "property2": "string"
        },
        "id": "string",
        "max_sessions": 0,
        "proto": "string",
        "resource": "string",
        "start_timeout": -9223372036854776000,
        "transport": "string",
        "url": "string"
      }
    ],
    "page": {
      "limit": 50,
      "next_cursor": "v2:after:tool-001",
      "prev_cursor": "v2:before:tool-000",
      "total": 2
    }
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Get MCP server

Retrieve an MCP server configuration by ID.

GET
/mcps/{mcp_id}

Path Parameters

mcp_idstring

MCP ID

Query Parameters

project?string

Project override

Response Body

curl -X GET "https://loading/api/v0/mcps/string?project=string"
{
  "data": {
    "args": [
      "string"
    ],
    "command": "string",
    "env": {
      "property1": "string",
      "property2": "string"
    },
    "headers": {
      "property1": "string",
      "property2": "string"
    },
    "id": "string",
    "max_sessions": 0,
    "proto": "string",
    "resource": "string",
    "start_timeout": -9223372036854776000,
    "transport": "string",
    "url": "string"
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Create or update MCP server

Create an MCP server when absent or update an existing one using strong ETag concurrency.

PUT
/mcps/{mcp_id}

Path Parameters

mcp_idstring

MCP ID

Query Parameters

project?string

Project override

Header Parameters

If-Match?string

Strong ETag for optimistic concurrency

Request Body

MCP configuration payload

Empty Object

Response Body

curl -X PUT "https://loading/api/v0/mcps/string?project=string" \
  -H "If-Match: string" \
  -H "Content-Type: application/json" \
  -d '{}'
{
  "data": {
    "args": [
      "string"
    ],
    "command": "string",
    "env": {
      "property1": "string",
      "property2": "string"
    },
    "headers": {
      "property1": "string",
      "property2": "string"
    },
    "id": "string",
    "max_sessions": 0,
    "proto": "string",
    "resource": "string",
    "start_timeout": -9223372036854776000,
    "transport": "string",
    "url": "string"
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "data": {
    "args": [
      "string"
    ],
    "command": "string",
    "env": {
      "property1": "string",
      "property2": "string"
    },
    "headers": {
      "property1": "string",
      "property2": "string"
    },
    "id": "string",
    "max_sessions": 0,
    "proto": "string",
    "resource": "string",
    "start_timeout": -9223372036854776000,
    "transport": "string",
    "url": "string"
  },
  "error": {
    "code": "string",
    "details": "string",
    "message": "string"
  },
  "message": "string",
  "status": 0
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Delete MCP server

Delete an MCP server configuration. Returns conflict when referenced.

DELETE
/mcps/{mcp_id}

Path Parameters

mcp_idstring

MCP ID

Query Parameters

project?string

Project override

Response Body

curl -X DELETE "https://loading/api/v0/mcps/string?project=string"
"string"
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}
{
  "code": "invalid_cursor",
  "detail": "Invalid cursor parameter",
  "instance": "/api/v0/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Schemas

Schema management endpoints

Memories

Memory configuration endpoints