Ausca Offers API

openapi: 3.2.0
info:
  contact:
    name: Ausca
    url: https://ausca.com
  description: Transport-neutral paid invocations, keyless artifact ingress, and focused browser-session and receive-only inbox lease control.
  title: Ausca Offers API
  version: 1.3.1
  x-guidance: Start with https://ausca.com/SKILL.md, resolve an immutable offer before acting, and reuse the same invocation bytes and idempotency key after an uncertain response.
servers:
- url: https://ausca.com
security: []
tags:
- name: Offers
paths:
  /v1/offers:
    get:
      description: Search the current immutable Ausca offer catalog by free-text query. Returns stable offer identities and revision digests without creating product or payment state.
      operationId: SearchOffers
      parameters:
      - in: query
        name: q
        schema:
          $ref: '#/components/schemas/SearchQuery'
      - in: query
        name: limit
        schema:
          $ref: '#/components/schemas/SearchLimit'
      - description: Opaque continuation returned by the preceding page for the same query and catalog snapshot.
        in: query
        name: cursor
        schema:
          $ref: '#/components/schemas/CatalogCursor'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchOffersResult'
          description: Matching offers
        default:
          $ref: '#/components/responses/ErrorResponse'
      security: []
      summary: Search immutable offers
      x-ausca-mcp:
        destructive: false
        enabledByDefault: true
        idempotent: true
        inputSchema: '#/components/schemas/SearchOffersInput'
        name: ausca_search_offers
        openWorld: false
        readOnly: true
        resultSchema: '#/components/schemas/SearchOffersResult'
      tags:
      - Offers
  /v1/offers/{offer_id}:
    get:
      description: Resolve one active offer or an exact immutable revision, including the schema and revision digests required to construct a valid invocation envelope.
      operationId: GetOffer
      parameters:
      - $ref: '#/components/parameters/OfferID'
      - description: Optional immutable revision digest; absence resolves the active revision.
        in: query
        name: revision_digest
        schema:
          $ref: '#/components/schemas/Digest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetOfferResult'
          description: Resolved offer
        default:
          $ref: '#/components/responses/ErrorResponse'
      security: []
      summary: Resolve an active or pinned offer revision
      x-ausca-mcp:
        destructive: false
        enabledByDefault: true
        idempotent: true
        inputSchema: '#/components/schemas/GetOfferInput'
        name: ausca_get_offer
        openWorld: false
        readOnly: true
        resultSchema: '#/components/schemas/GetOfferResult'
      tags:
      - Offers
components:
  schemas:
    SearchOffersResult:
      additionalProperties: false
      properties:
        next_cursor:
          $ref: '#/components/schemas/CatalogCursor'
        offers:
          items:
            $ref: '#/components/schemas/OfferSummary'
          maxItems: 100
          type: array
        status:
          const: ok
      required:
      - status
      - offers
      type: object
    SearchLimit:
      default: 20
      maximum: 100
      minimum: 1
      type: integer
    CatalogCursor:
      description: Opaque, catalog-snapshot-bound continuation. Callers must not construct or modify it.
      maxLength: 512
      minLength: 1
      pattern: ^ausca:catalog-cursor:v1:[a-f0-9]{64}:[a-f0-9]{64}:[A-Za-z0-9_-]{2,171}$
      type: string
    SearchQuery:
      maxLength: 256
      minLength: 1
      pattern: ^[^\s\x00-\x1F\x7F](?:[^\x00-\x1F\x7F]*[^\s\x00-\x1F\x7F])?$
      type: string
    Digest:
      pattern: ^sha256:[a-f0-9]{64}$
      type: string
    Identifier:
      maxLength: 128
      minLength: 1
      pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
      type: string
    OfferSummary:
      additionalProperties: false
      properties:
        catalog_url:
          const: /catalog.json
          type: string
        description:
          maxLength: 2000
          type: string
        input_schema_digest:
          $ref: '#/components/schemas/Digest'
        input_schema_url:
          format: uri-reference
          type: string
        offer_id:
          $ref: '#/components/schemas/Identifier'
        offer_revision:
          $ref: '#/components/schemas/Identifier'
        offer_revision_digest:
          $ref: '#/components/schemas/Digest'
        output_schema_digest:
          $ref: '#/components/schemas/Digest'
        output_schema_url:
          format: uri-reference
          type: string
        route:
          additionalProperties: false
          properties:
            method:
              const: POST
            path:
              maxLength: 512
              minLength: 1
              type: string
          required:
          - method
          - path
          type: object
        title:
          maxLength: 80
          minLength: 1
          type: string
      required:
      - offer_id
      - offer_revision
      - offer_revision_digest
      - input_schema_digest
      - output_schema_digest
      - title
      - route
      - input_schema_url
      - output_schema_url
      - catalog_url
      type: object
    ErrorResult:
      additionalProperties: false
      properties:
        code:
          enum:
          - invalid_request
          - not_found
          - conflict
          - payment_required
          - unavailable
          - upstream_error
          - gone
          - rate_limited
          - attachment_blocked
          type: string
        inspect_url:
          description: Recovery status URL when payment settled but delivery failed.
          type: string
        invocation_id:
          $ref: '#/components/schemas/Identifier'
        message:
          maxLength: 512
          minLength: 1
          type: string
        status:
          const: error
      required:
      - status
      - code
      - message
      type: object
    GetOfferResult:
      additionalProperties: false
      properties:
        offer:
          $ref: '#/components/schemas/OfferSummary'
        status:
          const: ok
      required:
      - status
      - offer
      type: object
  parameters:
    OfferID:
      in: path
      name: offer_id
      required: true
      schema:
        $ref: '#/components/schemas/Identifier'
  responses:
    ErrorResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResult'
      description: Transport or infrastructure failure
  securitySchemes:
    LeaseCapability:
      bearerFormat: opaque
      description: Opaque expiry-bound authority for one Ausca resource lease. Never place it in JSON, query parameters, MCP tool arguments, logs, or receipts.
      scheme: bearer
      type: http
x-ausca-mcp-server:
  description: 'Agent infrastructure on demand: discover and control metered, keyless services with explicit pricing, bounded payment authority, and receipt-backed results.'
  icon:
    mimeType: image/svg+xml
    size: any
    src: https://ausca.com/favicon.svg
  instructions: 'Use search and get to resolve an immutable offer before acting. Paid tools take x402 v2 payment only in params._meta["x402/payment"], never in tool arguments: a call without it moves no money and returns the PaymentRequired as an isError result''s structuredContent; retry the same arguments with the signed PaymentPayload and read settlement evidence from result._meta["x402/payment-response"]. For an offer without a listed paid tool, follow the selected service SKILL.md and use its canonical HTTP invocation resource. Browser and inbox lifecycle tools take their lease bearer from the MCP HTTP request Authorization header, never from tool arguments.'
  name: ausca
  registry:
    description: Pay-per-call APIs and MCP services for agents, no accounts or keys, with verifiable receipts.
    name: com.ausca/agent-services
    package:
      argument: mcp
      identifier: ausca
      registryType: npm
      runtimeHint: npx
      version: 0.1.0
    version: 1.2.6
  title: Ausca