Mcps

get

Retrieves available MCP options.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves all available MCP options.

application/json

typestring · enumRequiredPossible values:

401

Unauthorized.

application/json

get/api/v1/mcps/options

GET /api/v1/mcps/options HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

[
  {
    "type": "composio-airtable"
  }
]

get

Retrieves available MCP tool options for a toolkit.

Path parameters

toolkitstring · enumRequiredPossible values:

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves MCP tool options for the given toolkit.

application/json

401

Unauthorized.

application/json

get/api/v1/mcps/tool-options/{toolkit}

GET /api/v1/mcps/tool-options/{toolkit} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "tools": [
    {
      "description": "text",
      "inputParameters": {
        "properties": {
          "ANY_ADDITIONAL_PROPERTY": {
            "description": "text",
            "enum": [],
            "examples": [],
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "text"
        ],
        "type": "object"
      },
      "name": "text",
      "outputParameters": {
        "properties": {
          "ANY_ADDITIONAL_PROPERTY": {
            "description": "text",
            "enum": [],
            "examples": [],
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "text"
        ],
        "type": "object"
      }
    }
  ]
}

get

Retrieves multiple MCPs.

Query parameters

agentIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

or

string · uuidOptional

A UUID v4 string that identifies an entity.

connectionIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

or

string · uuidOptional

A UUID v4 string that identifies an entity.

joinsany ofOptionalDefault: []

or

string · enumOptionalPossible values:

pageNumbernumber · min: 1Optional

The page number.

Default: 1

pageSizenumber · min: 1 · max: 100Optional

The page size.

Default: 10

searchstring · min: 1Optional

Search term to filter MCPs by name or description.

versionIdsany ofOptionalDefault: []

string · uuid[]Optional

A UUID v4 string that identifies an entity.

or

string · uuidOptional

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves all MCPs for the workspace.

application/json

or

401

Unauthorized.

application/json

get/api/v1/mcps

GET /api/v1/mcps HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

[
  {
    "createdAt": "2026-01-01T00:00:00.000Z",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "isRemoved": true,
    "referenceId": "123e4567-e89b-12d3-a456-426614174000",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "versionId": "123e4567-e89b-12d3-a456-426614174000",
    "connectionId": "123e4567-e89b-12d3-a456-426614174000",
    "description": "text",
    "detail": {
      "tools": [
        "text"
      ],
      "type": "composio-airtable"
    },
    "name": "text",
    "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
    "agentMcps": [
      {
        "createdAt": "2026-01-01T00:00:00.000Z",
        "updatedAt": "2026-01-01T00:00:00.000Z",
        "agentId": "123e4567-e89b-12d3-a456-426614174000",
        "mcpId": "123e4567-e89b-12d3-a456-426614174000",
        "agent": {
          "createdAt": "2026-01-01T00:00:00.000Z",
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "isRemoved": true,
          "referenceId": "123e4567-e89b-12d3-a456-426614174000",
          "updatedAt": "2026-01-01T00:00:00.000Z",
          "versionId": "123e4567-e89b-12d3-a456-426614174000",
          "codeRuntime": true,
          "internalName": "text",
          "iterations": 1,
          "lastExecutedAt": "2026-01-01T00:00:00.000Z",
          "llm": "claude-haiku-4-5",
          "llmProviderId": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "picture": "text",
          "planning": true,
          "prompt": "text",
          "reasoningMode": "low",
          "role": "text",
          "superIdentityId": "123e4567-e89b-12d3-a456-426614174000",
          "temperature": 1,
          "timezone": "Africa/Cairo",
          "toolCount": 1,
          "voiceId": "123e4567-e89b-12d3-a456-426614174000",
          "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
        }
      }
    ]
  }
]

post

Creates a new MCP.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

connectionIdstring · uuid · nullableRequired

The id of the connection the MCP will be used through.

descriptionstring · min: 3 · max: 250 · nullableRequired

The internal description of the MCP.

detailone ofRequired

namestring · min: 3 · max: 50Required

The display name of the MCP.

Responses

200

The MCP was created.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

connectionIdstring · uuid · nullableRequired

The id of the connection the MCP will be used through.

descriptionstring · min: 3 · max: 250 · nullableRequired

The internal description of the MCP.

detailone ofRequired

namestring · min: 3 · max: 50Required

The display name of the MCP.

workspaceIdstring · uuidRequired

The workspace ID that owns the MCP.

400

Connection type is not compatible with MCP type.

application/json

401

Unauthorized.

application/json

404

Connection not found.

application/json

post/api/v1/mcps

POST /api/v1/mcps HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 145

{
  "connectionId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "tools": [
      "text"
    ],
    "type": "composio-airtable"
  },
  "name": "text"
}

{
  "createdAt": "2026-01-01T00:00:00.000Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "connectionId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "tools": [
      "text"
    ],
    "type": "composio-airtable"
  },
  "name": "text",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
}

get

Retrieves an MCP.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

Retrieves an MCP.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

connectionIdstring · uuid · nullableRequired

The id of the connection the MCP will be used through.

descriptionstring · min: 3 · max: 250 · nullableRequired

The internal description of the MCP.

detailone ofRequired

namestring · min: 3 · max: 50Required

The display name of the MCP.

workspaceIdstring · uuidRequired

The workspace ID that owns the MCP.

401

Unauthorized.

application/json

404

MCP not found.

application/json

get/api/v1/mcps/{id}

GET /api/v1/mcps/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "createdAt": "2026-01-01T00:00:00.000Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "connectionId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "tools": [
      "text"
    ],
    "type": "composio-airtable"
  },
  "name": "text",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
}

delete

Removes an MCP.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Responses

200

The MCP was removed.

application/json

messagestringRequired

An informative message for a call that has no effective result to be returned.

401

Unauthorized.

application/json

404

MCP not found.

application/json

delete/api/v1/mcps/{id}

DELETE /api/v1/mcps/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Accept: */*

{
  "message": "text"
}

patch

Updates an MCP.

Path parameters

idstring · uuidRequired

A UUID v4 string that identifies an entity.

Header parameters

authorizationstringRequired

The API key to use for authentication. Can be created in the api keys section on the workspace settings page.

Body

connectionIdstring · uuid · nullableOptional

The id of the connection the MCP will be used through.

descriptionstring · min: 3 · max: 250 · nullableOptional

The internal description of the MCP.

detailany ofOptional

namestring · min: 3 · max: 50Optional

The display name of the MCP.

Responses

200

The MCP was updated.

application/json

createdAtstring · date-timeRequired

idstring · uuidRequired

A UUID v4 string that identifies an entity.

isRemovedbooleanRequired

referenceIdstring · uuid · nullableRequired

The ID of the original entity in production.

updatedAtstring · date-timeRequired

versionIdstring · uuidRequired

A UUID v4 string that identifies an entity.

connectionIdstring · uuid · nullableRequired

The id of the connection the MCP will be used through.

descriptionstring · min: 3 · max: 250 · nullableRequired

The internal description of the MCP.

detailone ofRequired

namestring · min: 3 · max: 50Required

The display name of the MCP.

workspaceIdstring · uuidRequired

The workspace ID that owns the MCP.

400

Connection type is not compatible with MCP type.

application/json

401

Unauthorized.

application/json

404

MCP or connection not found.

application/json

patch/api/v1/mcps/{id}

PATCH /api/v1/mcps/{id} HTTP/1.1
Host: api.endless.zaia.app
authorization: text
Content-Type: application/json
Accept: */*
Content-Length: 145

{
  "connectionId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "tools": [
      "text"
    ],
    "type": "composio-airtable"
  },
  "name": "text"
}

{
  "createdAt": "2026-01-01T00:00:00.000Z",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "isRemoved": true,
  "referenceId": "123e4567-e89b-12d3-a456-426614174000",
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "versionId": "123e4567-e89b-12d3-a456-426614174000",
  "connectionId": "123e4567-e89b-12d3-a456-426614174000",
  "description": "text",
  "detail": {
    "tools": [
      "text"
    ],
    "type": "composio-airtable"
  },
  "name": "text",
  "workspaceId": "123e4567-e89b-12d3-a456-426614174000"
}