MintMCP API

openapi: 3.1.0
info:
  title: MintMCP API
  version: '2026-10-18'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-18: 11 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; MintMCP has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 6
    documentation: 5
    pages-with-code: 7
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-18'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.mintmcp.com/docs/admin-api
  - https://www.mintmcp.com/docs/agent-identities
  - https://www.mintmcp.com/docs/m2m-tokens
  - https://www.mintmcp.com/docs/llm-gateway-user-setup
  - https://www.mintmcp.com/docs/hosted-private-npm-packages
  - https://www.mintmcp.com/docs/gateway-customization
  - https://www.mintmcp.com/docs/private-networks
servers:
- url: https://app.mintmcp.com
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://www.mintmcp.com/docs/hosted-private-npm-packages
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -fsSL '<credentialUrl>' | docker login <registryHost> -u <username> --password-stdin docker push <imageRef> \n Piping the\
          \ credential URL into docker login keeps the registry password out of your shell history and the chat. \n Call deploy_pushed_image with\
          \ the finalizeToken and a config for the new connector. For a stdio server, set the transport to stdio and the command to the package's\
          \ executa"
  /api/admin/v1/mcp-activity/summary:
    get:
      operationId: get_api_admin_v1_mcp_activity_summary
      tags:
      - Api
      summary: GET /api/admin/v1/mcp-activity/summary
      x-source: https://www.mintmcp.com/docs/admin-api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAdminV1McpActivitySummaryResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Python TypeScript curl -G https://app.mintmcp.com/api/admin/v1/mcp-activity/summary \ -H "Authorization: Bearer $MINTMCP_ADMIN_API_KEY"
          \ --data-urlencode "start=2026-09-01T00:00:00Z" \ --data-urlencode "end=2026-10-01T00:00:00Z" resp = requests . get ( "https://app.mintmcp.com/api/admin/v1/mcp-activity/summary"
          , headers = { "Authorization" : f"Bearer {API_KEY} " } , params = { "start" : "20'
  /api/admin/v1/mcp-activity/users:
    get:
      operationId: get_api_admin_v1_mcp_activity_users
      tags:
      - Api
      summary: GET /api/admin/v1/mcp-activity/users
      x-source: https://www.mintmcp.com/docs/admin-api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAdminV1McpActivityUsersResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Python TypeScript curl -G https://app.mintmcp.com/api/admin/v1/mcp-activity/users \ -H "Authorization: Bearer $MINTMCP_ADMIN_API_KEY"
          \ --data-urlencode "start=2026-09-01T00:00:00Z" \ --data-urlencode "end=2026-10-01T00:00:00Z" \ --data-urlencode "limit=100" resp =
          requests . get ( "https://app.mintmcp.com/api/admin/v1/mcp-activity/users" , headers = { "Authorization" : f"Bearer {API_KEY} " }'
  /api/admin/v1/organizations/me:
    get:
      operationId: get_api_admin_v1_organizations_me
      tags:
      - Api
      summary: GET /api/admin/v1/organizations/me
      x-source: https://www.mintmcp.com/docs/admin-api
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAdminV1OrganizationsMeResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl Python TypeScript curl https://app.mintmcp.com/api/admin/v1/organizations/me \ -H "Authorization: Bearer $MINTMCP_ADMIN_API_KEY"
          import os import requests API_KEY = os . environ [ "MINTMCP_ADMIN_API_KEY" ] resp = requests . get ( "https://app.mintmcp.com/api/admin/v1/organizations/me"
          , headers = { "Authorization" : f"Bearer {API_KEY} " } , ) resp . raise_for_status ( ) print ( resp . json ( '
  /livez:
    get:
      operationId: get_livez
      tags:
      - Livez
      summary: GET /livez
      x-source: https://www.mintmcp.com/docs/private-networks
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --fail http://127.0.0.1:8080/livez curl --fail http://127.0.0.1:8080/readyz \n Then open the network in Mintive and confirm\
          \ that the replica is Ready , its runtime is Connected , its heartbeat is recent, and it has acknowledged the current configuration.\
          \ \n After a Kubernetes replica is Ready, remove the temporary Secret: \n kubectl --namespace mintmcp delete secret \\ mintmcp-private-network-age"
  /o/org_01EXAMPLE/registry/v0.1/servers:
    get:
      operationId: get_o_org_01EXAMPLE_registry_v0_1_servers
      tags:
      - O
      summary: Paginated list of the user's accessible servers; supports limit (default 50, max 100), cursor, and search
      description: Example endpoint showing the full URL for retrieving the server list for organization org_01EXAMPLE.
      x-source: https://www.mintmcp.com/docs/gateway-customization
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of servers to return (default 50, max 100)
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor
      - name: search
        in: query
        required: false
        schema:
          type: string
        description: Search term to filter servers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /readyz:
    get:
      operationId: get_readyz
      tags:
      - Readyz
      summary: Health check endpoint
      x-source: https://www.mintmcp.com/docs/private-networks
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /releases/mintive-cli:
    get:
      operationId: get_releases_mintive_cli
      tags:
      - Releases
      summary: GET /releases/mintive-cli
      x-source: https://www.mintmcp.com/docs/llm-gateway-user-setup
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -fsSL https://downloads.mintmcp.com/releases/mintive-cli | sh \n The installer supports common Linux distributions, macOS,\
          \ and Windows. It sets up local binaries, primarily the mintive CLI, that configure your local harnesses to talk to the gateway. \n\
          \ On first run, the installer also prompts for your policy configuration: which harnesses to configure, and whether to use OAuth or\
          \ API keys for a"
  /servers:
    get:
      operationId: get_servers
      tags:
      - Servers
      summary: Paginated list of the user's accessible servers; supports limit (default 50, max 100), cursor, and search
      description: Paginated list of the user's accessible servers.
      x-source: https://www.mintmcp.com/docs/gateway-customization
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
        description: Maximum number of servers to return (default 50, max 100)
      - name: cursor
        in: query
        required: false
        schema:
          type: string
        description: Pagination cursor
      - name: search
        in: query
        required: false
        schema:
          type: string
        description: Search term to filter servers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /servers/{servername}/versions:
    get:
      operationId: get_servers_servername_versions
      tags:
      - Servers
      summary: Single-element version list for one server, or 404
      description: Single-element version list for one server, or 404.
      x-source: https://www.mintmcp.com/docs/gateway-customization
      parameters:
      - name: servername
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /servers/{servername}/versions/{version}:
    get:
      operationId: get_servers_servername_versions_version
      tags:
      - Servers
      summary: One server entry; latest is supported, and every entry has exactly one version, 1.0.0
      description: One server entry; latest is supported, and every entry has exactly one version, 1.0.0.
      x-source: https://www.mintmcp.com/docs/gateway-customization
      parameters:
      - name: servername
        in: path
        required: true
        schema:
          type: string
      - name: version
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiAdminV1McpActivitySummaryResponse:
      type: object
      properties:
        window:
          type: object
          properties:
            start:
              type: string
              format: date-time
            end:
              type: string
              format: date-time
        totals:
          type: object
          properties:
            calls:
              type: integer
            successfulCalls:
              type: integer
            failedCalls:
              type: integer
            activeActors:
              type: integer
            averageResponseTimeMs:
              type: number
        timeline:
          type: object
          properties:
            bucketMinutes:
              type: integer
            buckets:
              type: array
              items:
                type: object
                properties:
                  start:
                    type: string
                    format: date-time
                  calls:
                    type: integer
        vmcps:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              deleted:
                type: boolean
              calls:
                type: integer
              successfulCalls:
                type: integer
              activeActors:
                type: integer
              averageResponseTimeMs:
                type: integer
              connectors:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                    calls:
                      type: integer
                    successfulCalls:
                      type: integer
                    activeActors:
                      type: integer
                    averageResponseTimeMs:
                      type: integer
        connectors:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              calls:
                type: integer
              successfulCalls:
                type: integer
              activeActors:
                type: integer
              averageResponseTimeMs:
                type: integer
        topTools:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              connectorId:
                type: string
              connectorName:
                type: string
              calls:
                type: integer
    GetApiAdminV1McpActivityUsersResponse:
      type: object
      properties:
        window:
          type: object
          properties:
            start:
              type: string
              format: date-time
            end:
              type: string
              format: date-time
        users:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              name:
                type: string
              email:
                type: string
              role:
                type: string
              status:
                type: string
              lastActive:
                type: string
                format: date-time
              calls:
                type: integer
              vmcpsUsed:
                type: integer
              toolsUsed:
                type: integer
              topTools:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    calls:
                      type: integer
              topVmcps:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    name:
                      type: string
                    calls:
                      type: integer
        nextCursor:
          type: string
    GetApiAdminV1OrganizationsMeResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Livez
- name: O
- name: Readyz
- name: Releases
- name: Servers