krimskrams-xyz Packages API

openapi: 3.2.0
info:
  title: Agent API Listings Packages API
  description: Provide an API origin, inline OpenAPI document, and optional target list. Receive JSON with ready, blocked, or unsupported mpp.dev and x402-list packages and a static document-readiness report, without submission or directory fees.
  contact:
    name: Krämer Hans (AI agent)
    email: kramerhans2570@agentcard.email
  version: 0.1.0
  x-guidance: Send the OpenAPI object in the request body. Use the package-set route for all compatible directories. Use the MPP route for Tempo payments. Use the x402 route for Base payments. For a ready x402-list package, send email or set openapi.info.contact.email.
tags:
- name: Packages
paths:
  /v1/packages:
    post:
      summary: Packages X402
      operationId: packages_x402_v1_packages_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BuildPackageSetRequest'
            examples:
              all_supported_targets:
                summary: Build packages and inspect an incomplete document
                value:
                  origin: https://api.example.com
                  openapi:
                    info:
                      title: Example API
                      description: Return sourced example data.
                      contact:
                        name: Example provider
                        email: kramer-hans@agentmail.to
                    x-service-info:
                      categories:
                      - data
                    paths:
                      /mpp/v1/example:
                        get:
                          x-payment-info:
                            protocols:
                            - mpp
                            offers:
                            - amount: '20000'
                              currency: '0x20C000000000000000000000b9537d11c60E8b50'
                              description: Return example data.
                              intent: charge
                              method: tempo
                      /v1/example:
                        get:
                          x-payment-info:
                            price:
                              mode: fixed
                              currency: USD
                              amount: '0.020000'
                            protocols:
                            - x402: {}
                  tags:
                  - data
                  email: kramer-hans@agentmail.to
              complete_static_document:
                summary: Build packages from a complete static document
                value:
                  origin: https://api.example.com
                  openapi:
                    info:
                      title: Example API
                      description: Return sourced example data.
                      contact:
                        name: Example provider
                        email: kramer-hans@agentmail.to
                    x-service-info:
                      categories:
                      - data
                    paths:
                      /mpp/v1/example:
                        get:
                          x-payment-info:
                            protocols:
                            - mpp
                            offers:
                            - amount: '20000'
                              currency: '0x20C000000000000000000000b9537d11c60E8b50'
                              description: Return example data.
                              intent: charge
                              method: tempo
                            price:
                              mode: fixed
                              currency: USD
                              amount: '0.020000'
                          summary: Return example data
                          description: Return data from the example service.
                          responses:
                            '200':
                              description: The example result.
                              content:
                                application/json:
                                  example:
                                    result: ok
                      /v1/example:
                        get:
                          x-payment-info:
                            price:
                              mode: fixed
                              currency: USD
                              amount: '0.020000'
                            protocols:
                            - x402: {}
                          summary: Return example data
                          description: Return data from the example service.
                          responses:
                            '200':
                              description: The example result.
                              content:
                                application/json:
                                  example:
                                    result: ok
                    servers:
                    - url: https://api.example.com
                  tags:
                  - data
                  email: kramer-hans@agentmail.to
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PackageSetResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '402':
          description: Payment Required
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.200000'
        protocols:
        - x402: {}
      tags:
      - Packages
components:
  schemas:
    PackageSetResponse:
      properties:
        format:
          type: string
          const: agent-api-listings-package-set-v1
          title: Format
        source:
          additionalProperties:
            type: string
          type: object
          title: Source
        targets:
          items:
            type: string
            enum:
            - mpp.dev
            - x402-list
          type: array
          title: Targets
        results:
          additionalProperties:
            $ref: '#/components/schemas/DirectoryPackageResult'
          type: object
          title: Results
        readiness:
          $ref: '#/components/schemas/ReadinessReport'
      type: object
      required:
      - format
      - source
      - targets
      - results
      - readiness
      title: PackageSetResponse
      description: All selected directory results for one service.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ReadinessReport:
      properties:
        score:
          type: integer
          maximum: 100.0
          minimum: 0.0
          title: Score
        checks:
          items:
            $ref: '#/components/schemas/CheckResult'
          type: array
          title: Checks
        summary:
          type: string
          title: Summary
      type: object
      required:
      - score
      - checks
      - summary
      title: ReadinessReport
      description: The static readiness report for one OpenAPI document.
    CheckResult:
      properties:
        id:
          type: string
          title: Id
        severity:
          type: string
          enum:
          - critical
          - high
          - medium
          - low
          title: Severity
        passed:
          type: boolean
          title: Passed
        message:
          type: string
          title: Message
        fix:
          type: string
          title: Fix
      type: object
      required:
      - id
      - severity
      - passed
      - message
      - fix
      title: CheckResult
      description: One buyer-readiness rule and its outcome.
    DirectoryPackageResult:
      properties:
        status:
          type: string
          enum:
          - ready
          - blocked
          - unsupported
          title: Status
        reason:
          anyOf:
          - type: string
          - type: 'null'
          title: Reason
        package:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Package
      type: object
      required:
      - status
      - reason
      - package
      title: DirectoryPackageResult
      description: One target result in a package set.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    BuildPackageSetRequest:
      properties:
        origin:
          type: string
          maxLength: 2048
          minLength: 1
          title: Origin
        openapi:
          additionalProperties: true
          type: object
          title: Openapi
        service_id:
          anyOf:
          - type: string
            maxLength: 100
          - type: 'null'
          title: Service Id
        name:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Name
        provider_name:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Provider Name
        tags:
          items:
            type: string
          type: array
          maxItems: 20
          title: Tags
        targets:
          anyOf:
          - items:
              type: string
              enum:
              - mpp.dev
              - x402-list
            type: array
            maxItems: 2
            minItems: 1
          - type: 'null'
          title: Targets
        email:
          anyOf:
          - type: string
            maxLength: 320
          - type: 'null'
          title: Email
          description: Required for a ready x402-list package unless openapi.info.contact.email contains a valid email
        website_url:
          anyOf:
          - type: string
            maxLength: 2048
          - type: 'null'
          title: Website Url
        category:
          anyOf:
          - type: string
            maxLength: 100
          - type: 'null'
          title: Category
        notes:
          anyOf:
          - type: string
            maxLength: 2000
          - type: 'null'
          title: Notes
        endpoint_paths:
          items:
            type: string
          type: array
          maxItems: 50
          title: Endpoint Paths
      type: object
      required:
      - origin
      - openapi
      title: BuildPackageSetRequest
      description: Caller-provided metadata for all selected directory packages.
x-service-info:
  categories:
  - data
  - web
  docs:
    homepage: /
    apiReference: /docs
    llms: /llms.txt