studiomeyer-io Validate Webmcp API

openapi: 3.2.0
info:
  title: StudioMeyer Public Validate Webmcp API
  version: 1.0.0
  description: Public website endpoints, no API key required. JSON bodies required for POST; quote accepts an empty object. Major versions use /api/v{major}; breaking changes receive a new major-version URL. Deprecations announce the replacement in documentation and response headers; a sunset date is published only when scheduled. The separate authenticated API Platform is documented at /api/openapi.
  contact:
    email: hello@studiomeyer.io
servers:
- url: https://studiomeyer.io
security: []
tags:
- name: Validate Webmcp
paths:
  /api/v1/validate-webmcp:
    get:
      summary: Validate a website's WebMCP and agents.json implementation against the spec
      operationId: get_validate_webmcp
      responses:
        '200':
          description: JSON response
          headers:
            RateLimit:
              description: Remaining requests and seconds to reset for the named policy (HTTP RateLimit draft).
              schema:
                type: string
            RateLimit-Policy:
              description: Named policy, request quota and window in seconds (HTTP RateLimit draft).
              schema:
                type: string
            X-RateLimit-Limit:
              description: Request quota for the policy.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Reset time as Unix epoch seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                properties:
                  agency:
                    type: string
                  apiVersion:
                    type: string
                  validation:
                    type: object
                    properties:
                      url:
                        type: string
                        format: uri
                      passed:
                        type: integer
                      errors:
                        type: integer
                      warnings:
                        type: integer
                      total:
                        type: integer
                      valid:
                        type: boolean
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            check:
                              type: string
                            valid:
                              type: boolean
                            detail:
                              type: string
                            severity:
                              type: string
                              enum:
                              - error
                              - warning
                              - info
                          required:
                          - check
                          - valid
                          - detail
                          - severity
                    required:
                    - url
                    - passed
                    - errors
                    - warnings
                    - total
                    - valid
                    - results
                  spec:
                    type: object
                    properties:
                      agentsJson:
                        type: string
                        format: uri
                      agentCard:
                        type: string
                        format: uri
                      webmcp:
                        type: string
                        format: uri
                    required:
                    - agentsJson
                    - agentCard
                    - webmcp
                required:
                - agency
                - apiVersion
                - validation
                - spec
        '400':
          description: Invalid request or validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '405':
          description: HTTP method not supported by this endpoint
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            Allow:
              description: Supported HTTP methods.
              schema:
                type: string
        '429':
          description: Rate limit exceeded; observe Retry-After and rate-limit headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              description: Remaining requests and seconds to reset for the named policy (HTTP RateLimit draft).
              schema:
                type: string
            RateLimit-Policy:
              description: Named policy, request quota and window in seconds (HTTP RateLimit draft).
              schema:
                type: string
            X-RateLimit-Limit:
              description: Request quota for the policy.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Reset time as Unix epoch seconds.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
          example: studiomeyer.io
      tags:
      - Validate Webmcp
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          const: false
        code:
          type: string
        message:
          type: string
        resolution:
          type: string
        error:
          type: string
        details:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
            required:
            - field
            - message
        retryAfterMs:
          type: number
        availableIndustries:
          type: array
          items:
            type: string
        example:
          type: string
          format: uri
      required:
      - success
      - code
      - message
      - resolution
      - error