ydb-qdrant-tech MCP API

openapi: 3.2.0
info:
  title: Ydb Qdrant Tech MCP API
  version: 1.0.0
  description: 'Operations tagged MCP across 2 of this provider''s published API definitions: gravity-ai-openapi.json, pets-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://gravity-ai.ydb-qdrant.tech
- url: https://pets.ydb-qdrant.tech
tags:
- name: MCP
  description: Streamable HTTP MCP transport.
paths:
  /mcp:
    get:
      operationId: rejectMcpGet
      tags:
      - MCP
      summary: Reject unsupported MCP method
      responses:
        '405':
          description: Method not allowed.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
    post:
      operationId: callMcpServer
      tags:
      - MCP
      summary: Call the Gravity AI UI MCP server
      parameters:
      - $ref: '#/components/parameters/ApiVersionHeader'
      description: 'Streamable HTTP MCP endpoint. Send JSON-RPC requests with Accept: application/json, text/event-stream.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      responses:
        '200':
          description: JSON-RPC response.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
        '403':
          description: Forbidden origin.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
        '500':
          description: Internal MCP server error.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
    delete:
      operationId: rejectMcpDelete
      tags:
      - MCP
      summary: Reject unsupported MCP method
      responses:
        '405':
          description: Method not allowed.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/mcp:
    post:
      operationId: callWellKnownMcpServer
      tags:
      - MCP
      summary: Call the Gravity AI UI MCP server
      parameters:
      - $ref: '#/components/parameters/ApiVersionHeader'
      description: 'Streamable HTTP MCP endpoint. Send JSON-RPC requests with Accept: application/json, text/event-stream.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      responses:
        '200':
          description: JSON-RPC response.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
        '403':
          description: Forbidden origin.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
        '500':
          description: Internal MCP server error.
          headers:
            RateLimit-Limit:
              schema:
                type: integer
              description: Documented request budget for agent clients.
            RateLimit-Remaining:
              schema:
                type: integer
              description: Remaining requests in the current window when enforced.
            RateLimit-Reset:
              schema:
                type: integer
              description: Seconds until the current window resets when enforced.
            API-Version:
              schema:
                type: string
                enum:
                - '1'
              description: Current public API version.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
    get:
      operationId: getWellKnownMcpServerCard
      tags:
      - MCP
      summary: Fetch the Gravity AI UI MCP server card
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServerCard'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /.well-known/mcp.json:
    get:
      operationId: getMcpWellKnownDocument
      tags:
      - MCP
      summary: Fetch MCP well-known compatibility metadata
      responses:
        '200':
          description: JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpWellKnownDocument'
    servers:
    - url: https://gravity-ai.ydb-qdrant.tech
  /mcp.md:
    get:
      operationId: getMcpMarkdown
      tags:
      - MCP
      summary: Get markdown MCP server guide
      security: []
      responses:
        '200':
          description: Successful text response.
          content:
            text/markdown:
              schema:
                type: string
    servers:
    - url: https://pets.ydb-qdrant.tech
  /.well-known/oauth-protected-resource/mcp:
    get:
      operationId: getMcpOAuthProtectedResourceMetadata
      tags:
      - MCP
      summary: Get OAuth Protected Resource metadata for the MCP endpoint
      description: Machine-readable public access metadata for /mcp. OAuth 2.0 is not supported and authorization_servers is intentionally omitted.
      security: []
      responses:
        '200':
          description: Successful JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthProtectedResourceMetadata'
    servers:
    - url: https://pets.ydb-qdrant.tech
  /server.json:
    get:
      operationId: getMcpRegistryServer
      tags:
      - MCP
      summary: Get MCP Registry server metadata
      security: []
      responses:
        '200':
          description: Successful JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpRegistryServer'
    servers:
    - url: https://pets.ydb-qdrant.tech
  /.well-known/mcp/server.json:
    get:
      operationId: getWellKnownMcpRegistryServer
      tags:
      - MCP
      summary: Get well-known MCP Registry server metadata
      security: []
      responses:
        '200':
          description: Successful JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpRegistryServer'
    servers:
    - url: https://pets.ydb-qdrant.tech
  /.well-known/mcp/server-card.json:
    get:
      operationId: getMcpServerCard
      tags:
      - MCP
      summary: Get Codex Pets MCP server card
      security: []
      responses:
        '200':
          description: Successful JSON response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/McpServerCard_2'
    servers:
    - url: https://pets.ydb-qdrant.tech
  /api/pet-generations:
    post:
      operationId: generatePet
      tags:
      - MCP
      summary: Start an anonymous server-paid pet generation
      description: 'Same quota and queue as generate_pet. Requires the same-origin browser Origin header. With PET_GENERATION_REVIEW_FLOW_ENABLED, new multipart website tasks stop at awaiting_confirmation after the base image; POST /api/pet-generations/{id}/confirm queues animations without another daily attempt. JSON and MCP admissions remain automatic regardless of the flag; existing jobs retain their saved policy. Multipart text line endings are normalized to LF before length validation and request identity, while retries retain compatibility with older multipart fingerprints. Multipart accepts one static PNG/JPEG/WebP referenceImage up to 5 MiB and 25 million pixels, with optional prompt describing appearance changes; total body limit 6 MiB. Image bytes participate in idempotency. The normalized reference is private and never included in the public package. Twelve image stages, each with at most one delayed retry after a retryable provider failure, plus one text/vision request for editable card metadata; successful stages are never repeated and metadata is not retried. Private results expire24hours after acceptance. Experimental generation: animations and gaze directions may contain visual errors or look too similar. Review the preview before submitting your pet to moderation. Accepted tasks count toward the limit even if the result is unsuitable. A failed image stage may be retried once after a delay, which can incur an additional provider charge.'
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
              - prompt
              - requestId
              properties:
                prompt:
                  type: string
                  minLength: 1
                  maxLength: 2000
                displayName:
                  type: string
                  minLength: 1
                  maxLength: 80
                requestId:
                  type: string
                  format: uuid
          multipart/form-data:
            schema:
              type: object
              additionalProperties: false
              required:
              - requestId
              properties:
                requestId:
                  type: string
                  format: uuid
                prompt:
                  type: string
                  maxLength: 2000
                displayName:
                  type: string
                  minLength: 1
                  maxLength: 80
                referenceImage:
                  type: string
                  format: binary
              anyOf:
              - required:
                - referenceImage
              - required:
                - prompt
                properties:
                  prompt:
                    type: string
                    minLength: 1
      responses:
        '202':
          description: Accepted or existing idempotent task with generationId,status,progress and private preview URL.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '400':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '413':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    servers:
    - url: https://pets.ydb-qdrant.tech
  /api/pet-generations/{id}:
    get:
      operationId: getPetGeneration
      tags:
      - MCP
      summary: Read an unlisted generation by its private ID
      security: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[a-f0-9]{64}$
      responses:
        '200':
          description: Generation status (queued, generating, awaiting_confirmation, processing, completed or failed), optional reviewBase/baseConfirmed/baseUrl, canContinue, optional continuation and safe assemblyIssues, canReviseAnimations, optional animationRevision (sourceGenerationId, selectedStates, corrections, acceptedAt, beforeSpritesheetUrl), optional accepted animationPrompt (private; never in gallery assets), completedSteps/totalSteps image progress, optional metadata (displayName,description,tags,revision,editable,automaticState,edited), expiry, completed preview/package URLs (ZIP omitted for an unaccepted animation revision) and optional submission receipt (petId,slug,submittedAt). Failed jobs include error.code, a safe message and hint, and automaticRetry=false. No raw provider diagnostics are exposed. A failed job is a successful status read, not an instruction to start another paid generation.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
        '404':
          description: Resource not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '410':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    servers:
    - url: https://pets.ydb-qdrant.tech
  /api/pet-generations/{id}/files/{file}:
    get:
      operationId: getPetGenerationFile
      tags:
      - MCP
      summary: Download an unlisted completed generation before expiry
      security: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
          pattern: ^[a-f0-9]{64}$
      - name: file
        in: path
        required: true
        schema:
          type: string
          enum:
          - pet.json
          - spritesheet.webp
          - pet.zip
      responses:
        '200':
          description: Private generated asset; Cache-Control:no-store; no counters mutated.
        '404':
          description: Resource not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '410':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '503':
          description: Request failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    servers:
    - url: https://pets.ydb-qdrant.tech
components:
  parameters:
    ApiVersionHeader:
      name: API-Version
      in: header
      required: false
      schema:
        type: string
        enum:
        - '1'
        default: '1'
      description: 'Optional API version selector. The current public API version is 1 and responses echo API-Version: 1.'
  schemas:
    JsonRpcResponse:
      type: object
      required:
      - jsonrpc
      properties:
        jsonrpc:
          type: string
          const: '2.0'
        id:
          type:
          - string
          - number
          - 'null'
        result: {}
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: integer
            message:
              type: string
    McpServerCard:
      type: object
      additionalProperties: false
      required:
      - name
      - title
      - description
      - version
      - websiteUrl
      - serverUrl
      - transport
      - tools
      properties:
        name:
          type: string
        title:
          type: string
        description:
          type: string
        version:
          type: string
        websiteUrl:
          type: string
          format: uri
        serverUrl:
          type: string
          format: uri
        transport:
          type: string
          const: streamable-http
        tools:
          type: array
          items:
            type: object
            additionalProperties: false
            required:
            - name
            - title
            - description
            - readOnly
            properties:
              name:
                type: string
              title:
                type: string
              description:
                type: string
              readOnly:
                type: boolean
    McpWellKnownDocument:
      type: object
      required:
      - name
      - title
      - description
      - version
      - websiteUrl
      - serverUrl
      - serverCard
      - openapi
      - transport
      - tools
      - servers
      properties:
        name:
          type: string
        title:
          type: string
        description:
          type: string
        version:
          type: string
        websiteUrl:
          type: string
          format: uri
        serverUrl:
          type: string
          format: uri
        serverCard:
          type: string
          format: uri
        openapi:
          type: string
          format: uri
        transport:
          type: string
          const: streamable-http
        tools:
          type: array
          items:
            type: object
        servers:
          type: array
          items:
            type: object
    JsonRpcRequest:
      type: object
      required:
      - jsonrpc
      - method
      properties:
        jsonrpc:
          type: string
          const: '2.0'
        id:
          type:
          - string
          - number
          - 'null'
        method:
          type: string
        params:
          type: object
    McpRegistryServer:
      type: object
      additionalProperties: true
    JsonRpcResponse_2:
      type: object
      additionalProperties: true
    McpServerCard_2:
      type: object
      additionalProperties: true
    JsonRpcErrorResponse:
      type: object
      required:
      - jsonrpc
      - error
      - id
      properties:
        jsonrpc:
          type: string
          const: '2.0'
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: integer
            message:
              type: string
          additionalProperties: true
        id:
          oneOf:
          - type: string
          - type: number
          - type: 'null'
      additionalProperties: true
    OAuthProtectedResourceMetadata:
      type: object
      required:
      - resource
      - resource_name
      - resource_documentation
      - resource_policy_uri
      - resource_tos_uri
      - oauth_unsupported
      - scopes_supported
      - bearer_methods_supported
      properties:
        resource:
          type: string
          format: uri
        resource_name:
          type: string
        resource_documentation:
          type: string
          format: uri
        resource_policy_uri:
          type: string
          format: uri
        resource_tos_uri:
          type: string
          format: uri
        oauth_unsupported:
          type: boolean
          const: true
        scopes_supported:
          type: array
          items:
            type: string
          maxItems: 0
        bearer_methods_supported:
          type: array
          items:
            type: string
          maxItems: 0
      additionalProperties: true
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
        message:
          type: string
        hint:
          type: string
        field:
          type: string
      required:
      - error
      - code
      - message
      additionalProperties: true
    JsonRpcRequest_2:
      type: object
      additionalProperties: true
  securitySchemes:
    OAuth2Metadata:
      type: oauth2
      description: Discovery metadata is published for agent compatibility. Token issuance is disabled in the current public demo.
      flows:
        authorizationCode:
          authorizationUrl: https://gravity-ai.ydb-qdrant.tech/oauth/authorize
          tokenUrl: https://gravity-ai.ydb-qdrant.tech/oauth/token
          scopes:
            interface:generate: Generate and refine interfaces.
            interface:read: Read public gallery interfaces.
    AppSessionCookie:
      type: apiKey
      in: cookie
      name: codex_pets_session
      description: Optional app-session cookie used by browser account flows. Public read endpoints do not require it.
    ProxyBasic:
      type: http
      scheme: basic
      description: Deployment mode for trusted reverse proxies. Public agent endpoints are designed to be readable without credentials.
x-refined-from:
- gravity-ai-openapi.json
- pets-openapi.json