mcp-servers

Changed on

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

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

Request body

namestring required
slugstring
apiUidsNanoid[]
versionUidstring required
pinCurrentOperationsboolean
defaultHeadersboolean
channelMode'single' | 'multi'

Example request

{
  "slug": "acme-api",
  "apiUids": [
    "UakgbKJ5m9gl0JDMbcJqL"
  ]
}

Response

Default Response

Example response

{
  "server": {
    "id": "42",
    "name": "Acme API",
    "slug": "acme-api",
    "uid": "UakgbKJ5m9gl0JDMbcJqL",
    "namespace": "acme",
    "domain": "docs.example.com",
    "channelMode": "single",
    "createdAt": "2025-01-01T00:00:00.000Z",
    "updatedAt": "2025-01-01T00:00:00.000Z"
  },
  "installation": {
    "id": "42",
    "mcpServerId": "42",
    "name": "Acme API",
    "slug": "acme-api",
    "accessGroups": [
      "UakgbKJ5m9gl0JDMbcJqL"
    ],
    "loginPortalUid": "LakgbKJ5m9gl0JDMbcJqL",
    "mcpVersion": "1.2.0",
    "piiRedactionEnabled": true,
    "credentialRedactionEnabled": true,
    "policy": "automatic"
  }
}

Changes

  • c6181fd5d792Revision changes
    • breaking

      removed the required property / from the response with the status

    • warning

      removed the request property

    • warning

      removed the optional property / from the response with the status

    • info

      added the required property / to the response with the status

  • 31d9832a717bRevision changes
    • breaking

      the response property / became optional for the status

    • breaking

      removed 'propertyNames' constraint from the / response property for the status

    • breaking

      removed the required property / from the response with the status

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status