find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/scalar:scalar-mcp-servers-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Scalar MCP Servers API
  version: 0.1.0
  contact:
    name: Marc from Scalar
    url: https://scalar.com
    email: support@scalar.com
  description: 'Operations tagged mcp-servers across 2 of this provider''s published API definitions: scalar-openapi.json, scalar-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.scalar.com/core
security:
- BearerAuth: []
tags:
- name: mcp-servers
paths:
  /v1/mcp-servers:
    post:
      tags:
      - mcp-servers
      description: 'Create an MCP server: its identity record in core, then its versions and environments in the agent'
      operationId: postV1McpServers
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  server:
                    $ref: '#/components/schemas/mcp-server'
                  installation:
                    $ref: '#/components/schemas/mcp-installation'
                required:
                - server
                - installation
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400'
        '401':
          description: No auth
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404'
        '422':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422'
        '500':
          description: Uncaught error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 100
                slug:
                  $ref: '#/components/schemas/slug'
                apiUids:
                  type: array
                  items:
                    $ref: '#/components/schemas/nanoid'
                versionUids:
                  type: array
                  items:
                    type: string
                projectUids:
                  type: array
                  items:
                    type: string
                documentTracking:
                  type: array
                  items:
                    type: object
                    properties:
                      versionUid:
                        type: string
                      trackMode:
                        type: string
                        enum:
                        - pinned
                        - track-latest
                        - track-current
                    required:
                    - versionUid
                    - trackMode
                    additionalProperties: false
                docsProjectTracking:
                  type: array
                  items:
                    type: object
                    properties:
                      projectUid:
                        type: string
                      trackMode:
                        type: string
                        enum:
                        - pinned
                        - track-active-publish
                    required:
                    - projectUid
                    - trackMode
                    additionalProperties: false
                toolMode:
                  type: string
                  enum:
                  - generic
                  - curated
                  - both
              required:
              - name
              additionalProperties: false
        required: true
      summary: Post V1Mcp servers
      x-summary-source: derived
    servers:
    - url: https://api.scalar.com/core
  /v1/mcp-servers/instant:
    post:
      tags:
      - mcp-servers
      description: Create an MCP server with one linked API document and an installation in one call
      operationId: postV1McpServersInstant
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  server:
                    $ref: '#/components/schemas/mcp-server'
                  installation:
                    $ref: '#/components/schemas/mcp-installation'
                required:
                - server
                - installation
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400'
        '401':
          description: No auth
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404'
        '422':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422'
        '500':
          description: Uncaught error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 100
                slug:
                  $ref: '#/components/schemas/slug'
                apiUids:
                  type: array
                  items:
                    $ref: '#/components/schemas/nanoid'
                versionUid:
                  type: string
                installationName:
                  type: string
                  minLength: 1
                  maxLength: 100
                installationSlug:
                  $ref: '#/components/schemas/slug'
                documentAuth:
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties: {}
                toolMode:
                  type: string
                  enum:
                  - generic
                  - curated
                  - both
              required:
              - name
              - versionUid
              - installationName
              - documentAuth
              additionalProperties: false
        required: true
      summary: Post V1Mcp servers instant
      x-summary-source: derived
    servers:
    - url: https://api.scalar.com/core
  /v1/mcp-servers/{uid}:
    patch:
      tags:
      - mcp-servers
      description: 'Rename an MCP server or change its slug: the identity record first, then the agent row'
      operationId: patchV1McpServersUid
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/mcp-server'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400'
        '401':
          description: No auth
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404'
        '422':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422'
        '500':
          description: Uncaught error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 100
                slug:
                  $ref: '#/components/schemas/slug'
              additionalProperties: false
        required: true
      parameters:
      - schema:
          $ref: '#/components/schemas/nanoid'
        in: path
        name: uid
        required: true
      summary: Patch V1Mcp servers uid
      x-summary-source: derived
    delete:
      tags:
      - mcp-servers
      description: Delete an MCP server by UID
      operationId: deleteV1McpServersUid
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: 'null'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400'
        '401':
          description: No auth
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404'
        '422':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422'
        '500':
          description: Uncaught error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500'
      parameters:
      - schema:
          $ref: '#/components/schemas/nanoid'
        in: path
        name: uid
        required: true
      summary: Delete V1Mcp servers uid
      x-summary-source: derived
    servers:
    - url: https://api.scalar.com/core
  /v1/mcp-servers/{uid}/domain:
    put:
      tags:
      - mcp-servers
      description: Claim a custom domain for an MCP server
      operationId: putV1McpServersUidDomain
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    anyOf:
                    - type: string
                    - type: 'null'
                required:
                - domain
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400'
        '401':
          description: No auth
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404'
        '422':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422'
        '500':
          description: Uncaught error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                domain:
                  type: string
                  minLength: 1
                  maxLength: 253
              required:
              - domain
              additionalProperties: false
        required: true
      parameters:
      - schema:
          $ref: '#/components/schemas/nanoid'
        in: path
        name: uid
        required: true
      summary: Put V1Mcp servers uid domain
      x-summary-source: derived
    delete:
      tags:
      - mcp-servers
      description: Release the custom domain of an MCP server
      operationId: deleteV1McpServersUidDomain
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  domain:
                    anyOf:
                    - type: string
                    - type: 'null'
                required:
                - domain
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400'
        '401':
          description: No auth
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404'
        '422':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422'
        '500':
          description: Uncaught error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500'
      parameters:
      - schema:
          $ref: '#/components/schemas/nanoid'
        in: path
        name: uid
        required: true
      summary: Delete V1Mcp servers uid domain
      x-summary-source: derived
    servers:
    - url: https://api.scalar.com/core
  /v1/mcp-servers/{uid}/domain/check:
    post:
      tags:
      - mcp-servers
      description: Check the DNS record and certificate of an MCP custom domain
      operationId: postV1McpServersUidDomainCheck
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                    - pending
                    - misconfigured
                    - issuing
                    - active
                    - failed
                  expected:
                    type: object
                    properties:
                      type:
                        type: string
                        const: CNAME
                      target:
                        type: string
                    required:
                    - type
                    - target
                    additionalProperties: false
                  found:
                    type: array
                    items:
                      type: string
                  hostname:
                    anyOf:
                    - type: object
                      properties:
                        status:
                          type: string
                        sslStatus:
                          type: string
                      required:
                      - status
                      - sslStatus
                      additionalProperties: false
                    - type: 'null'
                required:
                - status
                - expected
                - found
                - hostname
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/400'
        '401':
          description: No auth
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/401'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/403'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/404'
        '422':
          description: Invalid payload
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/422'
        '500':
          description: Uncaught error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/500'
      parameters:
      - schema:
          $ref: '#/components/schemas/nanoid'
        in: path
        name: uid
        required: true
      summary: Post V1Mcp servers uid domain check
      x-summary-source: derived
    servers:
    - url: https://api.scalar.com/core
components:
  schemas:
    namespace:
      type: string
      minLength: 2
      maxLength: 50
      pattern: ^[a-zA-Z0-9-_]+$
      examples:
      - acme
    slug:
      type: string
      minLength: 1
      maxLength: 60
      pattern: ^[a-z](?:[a-z0-9-]*[a-z0-9])?$
      examples:
      - acme-api
    mcp-server:
      type: object
      properties:
        id:
          type: string
          examples:
          - '42'
        teamUid:
          type: string
        name:
          type: string
          examples:
          - Acme API
        slug:
          $ref: '#/components/schemas/slug'
        uid:
          type: string
          examples:
          - UakgbKJ5m9gl0JDMbcJqL
        namespace:
          $ref: '#/components/schemas/namespace'
        autoAddOperations:
          default: false
          examples:
          - true
          type: boolean
        domain:
          default: null
          examples:
          - docs.example.com
          anyOf:
          - type: string
          - type: 'null'
        createdAt:
          type: string
          examples:
          - '2025-01-01T00:00:00.000Z'
        updatedAt:
          type: string
          examples:
          - '2025-01-01T00:00:00.000Z'
      required:
      - id
      - teamUid
      - name
      - slug
      - uid
      - namespace
      - autoAddOperations
      - domain
      - createdAt
      - updatedAt
      additionalProperties: false
    mcp-installation:
      type: object
      properties:
        id:
          type: string
          examples:
          - '42'
        mcpServerId:
          type: string
          examples:
          - '42'
        name:
          type: string
          examples:
          - Acme API
        slug:
          $ref: '#/components/schemas/slug'
        documentAuth:
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
        isPrivate:
          type: boolean
          examples:
          - false
        accessGroups:
          default: []
          examples:
          - - UakgbKJ5m9gl0JDMbcJqL
          type: array
          items:
            type: string
        loginPortalUid:
          default: null
          examples:
          - LakgbKJ5m9gl0JDMbcJqL
          anyOf:
          - type: string
          - type: 'null'
        authConfig:
          default: {}
          type: object
          propertyNames:
            type: string
          additionalProperties:
            type: object
            properties:
              mode:
                default: global
                type: string
                enum:
                - global
                - passthrough
                - identity
                - oauth
              passthrough:
                default: []
                maxItems: 20
                type: array
                items:
                  type: object
                  properties:
                    in:
                      type: string
                      enum:
                      - header
                      - query
                    name:
                      type: string
                      minLength: 1
                      maxLength: 128
                      pattern: ^[A-Za-z0-9!#$%&'*+\-.^_`|~]+$
                  required:
                  - in
                  - name
                  additionalProperties: false
              oauth:
                type: object
                properties:
                  authorizationServer:
                    type: string
                    format: uri
                  scopes:
                    default: []
                    maxItems: 50
                    type: array
                    items:
                      type: string
                      minLength: 1
                      maxLength: 200
                      pattern: ^[\x21\x23-\x5B\x5D-\x7E]+$
                required:
                - authorizationServer
                - scopes
                additionalProperties: false
            required:
            - mode
            - passthrough
            additionalProperties: false
        mcpVersion:
          default: null
          examples:
          - 1.2.0
          anyOf:
          - type: string
          - type: 'null'
        piiRedactionEnabled:
          default: false
          examples:
          - true
          type: boolean
        credentialRedactionEnabled:
          default: false
          examples:
          - true
          type: boolean
      required:
      - id
      - mcpServerId
      - name
      - slug
      - documentAuth
      - isPrivate
      - accessGroups
      - loginPortalUid
      - authConfig
      - mcpVersion
      - piiRedactionEnabled
      - credentialRedactionEnabled
      additionalProperties: false
    '401':
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
      - message
      - code
      examples:
      - message: Invalid authentication token.
        code: unauthorized
    '422':
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
      - message
      - code
      examples:
      - message: The request body contains invalid values.
        code: invalid-payload
    '404':
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
      - message
      - code
      examples:
      - message: Resource not found.
        code: not-found
    '403':
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
      - message
      - code
      examples:
      - message: You do not have permission to access this resource.
        code: forbidden
    '500':
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
      - message
      - code
      examples:
      - message: An unexpected error occurred.
        code: unknown
    nanoid:
      type: string
      minLength: 5
      examples:
      - UakgbKJ5m9gl0JDMbcJqL
    '400':
      type: object
      properties:
        message:
          type: string
        code:
          type: string
      required:
      - message
      - code
      examples:
      - message: Invalid request parameters.
        code: bad-request
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
x-refined-from:
- scalar-openapi.json
- scalar-openapi.json