---
title: "Connect MCP client"
method: POST
path: "/ai/mcpClients/connect"
tags: ["AI - MCP"]
---

# Connect MCP client

`POST /ai/mcpClients/connect`

Connect to an MCP client

## Request body

- object — Request body schema.
  - `mcpClient` union, required — MCP client connection details.
    - object
      - `kind` 'custom', required
      - `name` string, required
      - `url` string, required
      - `authentication` object, nullable, required
        - `issuedAt` string, required
        - `accessToken` string, required
        - `expiresIn` number
        - `refreshToken` string
        - `scope` string
        - `tokenType` string
        - `clientId` string
        - `clientSecret` string
      - `disabledToolSlugs` string[], required
    - object
      - `kind` 'connector', required
      - `name` string, required
      - `connectorUuid` string, required
      - `integrationSlug` string, required
      - `disabledToolSlugs` string[], required

## Response `200`

Successful response

- object
  - `outcome` 'connected', required — Connection outcome.
  - `tools` object[], required — Available tools from the MCP server.
    - `slug` string, required — Tool slug identifier.
    - `description` string — Tool description.
    - `config` object, required — Tool configuration.
      - `jsonSchema` unknown, required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/getcargo/apis/cargo-api.md) · [All operations](https://skmtc.net/getcargo/apis/cargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getcargo/cargo-api/revisions/1d5a19e01d83/schema)