---
title: "POST /v1/mcp-servers/instant"
method: POST
path: "/v1/mcp-servers/instant"
tags: ["mcp-servers"]
---

# POST /v1/mcp-servers/instant

`POST /v1/mcp-servers/instant`

## Request

- Base URL: `https://api.scalar.com/core`
- URL: `https://api.scalar.com/core/v1/mcp-servers/instant`
- Auth: HTTP bearer

Create an MCP server with one linked API document and its production environment in one call

## Request body

- object
  - `name` string, required
  - `slug` string
  - `apiUids` Nanoid[]
  - `versionUid` string, required
  - `expose` object
    - `enabled` boolean
    - `toolMode` 'direct' | 'generic'
  - `pinCurrentOperations` boolean
  - `defaultHeaders` boolean
  - `channelMode` 'single' | 'multi'

## Response `200`

Default Response

- object
  - `server` McpServer, required
    - `id` string, required
    - `teamUid` string, required
    - `name` string, required
    - `slug` string, required
    - `uid` string, required
    - `namespace` string, required
    - `domain` string, nullable, required
    - `channelMode` 'single' | 'multi', required
    - `channels` union[], required
      - union
        - object
          - `kind` 'api', required
          - `documentUid` string, required
        - object
          - `kind` 'docs', required
          - `projectUid` string, required
    - `docsProjectId` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required
  - `installation` McpInstallation, required
    - `id` string, required
    - `mcpServerId` string, required
    - `name` string, required
    - `slug` string, required
    - `isPrivate` boolean, required
    - `accessGroups` string[], required
    - `loginPortalUid` string, nullable, required
    - `mcpVersion` string, nullable, required
    - `piiRedactionEnabled` boolean, required
    - `credentialRedactionEnabled` boolean, required
    - `activeBuildId` string, nullable, required
    - `policy` 'automatic' | 'manual', required

## Other responses

- `400`: Bad request
- `401`: No auth
- `403`: Forbidden
- `404`: Not found
- `422`: Invalid payload
- `500`: Uncaught error

## Changes

- **2026-10-14** `c6181fd5d792`: 1 breaking, 2 warning, 1 info
  - removed the required property `installation/authConfig` from the response with the `200` status
  - removed the request property `documentAuth`
  - removed the optional property `installation/documentAuth` from the response with the `200` status
  - added the required property `server/docsProjectId` to the response with the `200` status
- **2026-10-13** `31d9832a717b`: 3 breaking, 3 warning, 8 info
  - the response property `installation/documentAuth` became optional for the status `200`
  - removed 'propertyNames' constraint from the `installation/documentAuth` response property for the status `200`
  - removed the required property `server/autoAddOperations` from the response with the `200` status
  - removed the request property `installationName`
  - …10 more
- **2026-10-08** `c674bcfb8f21`: 1 info
  - added the optional property `installation/authConfig/additionalProperties/secret` to the response with the `200` status
- **2026-10-06** `9c01d824a93f`: 1 info
  - the request property `installationName` became optional
- **2026-10-03** `5e4c47d6805b`: 1 warning, 1 info
  - added the new `oauth` enum value to the `installation/authConfig/additionalProperties/mode` response property for the response status `200`
  - added the optional property `installation/authConfig/additionalProperties/oauth` to the response with the `200` status

[Operation history](https://skmtc.dev/scalar/apis/core/changes/v1/mcp-servers/instant/post.md)

---

[API](https://skmtc.dev/scalar/apis/core.md) - [All operations](https://skmtc.dev/scalar/apis/core/llms.txt) - [OpenAPI document](https://skmtc.dev/scalar/apis/core/revisions/b3aa8493faa8?raw)