Create an MCP server

Create an MCP server over one or more API document versions. The response carries the server and its first installation.

OAuth scopes

platform:write

Body

required

application/json

name
Type: string
min length:
1
max length:
100
required
projectUids
Type: array of string
slug
Type:
min length:
1
max length:
60
versionUids
Type: array of string

Responses

application/json
application/json
application/json
application/json
application/json
application/json
application/json

post/v1/mcp/servers

curl https://access.scalar.com/v1/mcp/servers \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "name": "Acme MCP",
  "slug": "acme-mcp",
  "versionUids": [
    "VakgbKJ5m9gl0JDMbcJqL"
  ],
  "projectUids": [
    "PakgbKJ5m9gl0JDMbcJqL"
  ]
}'

Show Schema

{
  "server": {
    "id": "42",
    "name": "Acme API",
    "slug": "acme-api",
    "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
  }
}

Default Response

List all MCP servers

Get an MCP server

The API company.