---
title: "Create MCP server"
method: POST
path: "/ai/mcpServers"
tags: ["AI - MCP"]
---

# Create MCP server

`POST /ai/mcpServers`

Create a new MCP server

## Request body

- object — Request body schema.
  - `name` string, required — MCP server name.
  - `description` string — MCP server description.
  - `actions` union[], required — Actions exposed by the MCP server.
    - union
      - object
        - `name` string, nullable, required
        - `slug` string, required
        - `description` string, nullable, required
        - `isBulkAllowed` boolean, required
        - `config` object, required
        - `kind` 'tool', required
        - `toolUuid` string, nullable, required
        - `templateSlug` string, nullable, required
        - `waitUntilFinished` boolean, required
      - object
        - `name` string, nullable, required
        - `slug` string, required
        - `description` string, nullable, required
        - `isBulkAllowed` boolean, required
        - `config` object, required
        - `kind` 'agent', required
        - `agentUuid` string, nullable, required
        - `templateSlug` string, nullable, required
        - `waitUntilFinished` boolean, required
      - object
        - `name` string, nullable, required
        - `slug` string, required
        - `description` string, nullable, required
        - `isBulkAllowed` boolean, required
        - `config` object, required
        - `kind` 'connector', required
        - `integrationSlug` string, required
        - `connectorUuid` string, nullable, required
        - `actionSlug` string, required
  - `resources` union[], required — Resources exposed by the MCP server.
    - union
      - object
        - `kind` 'model', required
        - `name` string, nullable, required
        - `slug` string, required
        - `description` string, nullable, required
        - `integrationSlug` string, nullable, required
        - `modelUuid` string, nullable, required
        - `filter` object, nullable, required
          - `conjonction` 'or' | 'and', required
          - `groups` unknown[], required
            - unknown
        - `selectedColumnSlugs` string[], nullable, required
        - `limit` number, nullable, required
        - `prompt` string, nullable, required
        - `isReadOnly` boolean, required
      - object
        - `kind` 'file', required
        - `name` string, nullable, required
        - `slug` string, required
        - `description` string, nullable, required
        - `items` union[], required
          - union
            - object
              - …
            - object
              - …
        - `prompt` string, nullable, required
  - `folderUuid` string, uuid — Folder identifier for the MCP server.

## Response `200`

Successful response

- object
  - `mcpServer` object, required — Created MCP server details.
    - `uuid` string, required
    - `workspaceUuid` string, required
    - `userUuid` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `actions` union[], required
      - union
        - object
          - `name` string, nullable, required
          - `slug` string, required
          - `description` string, nullable, required
          - `isBulkAllowed` boolean, required
          - `config` object, required
          - `kind` 'tool', required
          - `toolUuid` string, nullable, required
          - `templateSlug` string, nullable, required
          - `waitUntilFinished` boolean, required
        - object
          - `name` string, nullable, required
          - `slug` string, required
          - `description` string, nullable, required
          - `isBulkAllowed` boolean, required
          - `config` object, required
          - `kind` 'agent', required
          - `agentUuid` string, nullable, required
          - `templateSlug` string, nullable, required
          - `waitUntilFinished` boolean, required
        - object
          - `name` string, nullable, required
          - `slug` string, required
          - `description` string, nullable, required
          - `isBulkAllowed` boolean, required
          - `config` object, required
          - `kind` 'connector', required
          - `integrationSlug` string, required
          - `connectorUuid` string, nullable, required
          - `actionSlug` string, required
    - `resources` union[], required
      - union
        - object
          - `kind` 'model', required
          - `name` string, nullable, required
          - `slug` string, required
          - `description` string, nullable, required
          - `integrationSlug` string, nullable, required
          - `modelUuid` string, nullable, required
          - `filter` object, nullable, required
            - `conjonction` 'or' | 'and', required
            - `groups` unknown[], required
              - …
          - `selectedColumnSlugs` string[], nullable, required
          - `limit` number, nullable, required
          - `prompt` string, nullable, required
          - `isReadOnly` boolean, required
        - object
          - `kind` 'file', required
          - `name` string, nullable, required
          - `slug` string, required
          - `description` string, nullable, required
          - `items` union[], required
            - union
              - …
          - `prompt` string, nullable, required
    - `folderUuid` string, nullable, required
    - `templateSlug` string, nullable, required
    - `isReadOnly` boolean, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `deletedAt` string, nullable, 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)