samedaydesk-com Distribution API

openapi: 3.2.0
info:
  title: SameDayDesk machine commerce gateway Distribution API
  version: 1.23.55
  description: Deterministic agent APIs for web and company intelligence, repository security, agent-work economics, machine-service discoverability, payment preflight and settlement proof, wallet context, and Morpho decision evidence. Pay per call through Base x402, with a Circle Gateway Nanopayments path for gasless batched USDC.
  contact:
    email: contact@samedaydesk.com
    url: https://samedaydesk.com
  x-guidance: Choose the narrowest route that answers the task. Supply required query parameters, inspect the currently advertised HTTP 402 offers, enforce your own price and network policy, then retry the identical method, path, and query with one supported payment credential. Treat runtime payment challenges as authoritative.
servers:
- url: https://agents.samedaydesk.com
tags:
- name: Distribution
paths:
  /.well-known/glama.json:
    get:
      summary: Project-owned Glama connector maintainer verification
      responses:
        '200':
          description: Glama connector verification
      operationId: getGlamaVerification
      tags:
      - Distribution
      security: []
  /.well-known/x402-verification.json:
    get:
      summary: Public server-ownership proof for the x402.jobs resource registry
      responses:
        '200':
          description: x402.jobs ownership verification
      operationId: getX402JobsVerification
      tags:
      - Distribution
      security: []
  /distribution/agent-discoverability-audit:
    get:
      summary: Audit one x402 or MPP service across ten public machine-discovery views.
      parameters:
      - name: origin
        in: query
        required: true
        description: Public HTTPS origin of the machine service, with no path or query.
        schema:
          type: string
          format: uri
          example: https://agents.samedaydesk.com
      - name: intent
        in: query
        required: true
        description: Brand-blind capability description used as the registry query.
        schema:
          type: string
          minLength: 20
          maxLength: 500
          example: extract a public web page into structured JSON metadata headings links and JSON-LD
      - name: route
        in: query
        required: false
        description: Expected exact path whose presence should be checked.
        schema:
          type: string
          pattern: ^/[^?#]*$
          example: /extract
      - name: method
        in: query
        required: false
        description: Exact seller method for the optional Coinbase materialization audit. runtimeUrl remains GET-only.
        schema:
          type: string
          enum:
          - GET
          - POST
          default: GET
      - name: runtimeUrl
        in: query
        required: false
        description: Optional exact same-origin HTTPS GET URL whose unpaid x402 or MPP offer supplies the runtime price reference. Requires route and an exactly matching pathname. Uses pinned public DNS, reads headers only, follows no redirect, and sends no credential or payment.
        schema:
          type: string
          format: uri
          maxLength: 2048
          example: https://agents.samedaydesk.com/extract?url=https%3A%2F%2Fexample.com
      - name: payTo
        in: query
        required: false
        description: Optional EVM settlement address used to identify aliased service origins.
        schema:
          type: string
          pattern: ^0x[0-9a-fA-F]{40}$
      - name: expectedPriceUsd
        in: query
        required: false
        description: Optional exact route price expected by the caller, with at most six fractional digits. Requires route. A coherent runtimeUrl offer takes precedence and any caller-to-runtime drift is reported.
        schema:
          type: number
          minimum: 0
          maximum: 1000000
          multipleOf: 1.0e-06
          example: 0.005
      - name: surfaceAudit
        in: query
        required: false
        description: Set true to inspect the target's public Agent Card, ERC-8004 registration document, and action catalog for the expected route after payment. Uses pinned public DNS, no redirects, a five-second timeout, and a 512-KiB cap per document.
        schema:
          type: boolean
          default: false
      - name: materializationAudit
        in: query
        required: false
        description: Set true with route and method to distinguish Coinbase seller ineligibility from provider acceptance without exact-resource Bazaar materialization. Uses no credential, signature, or payment; Coinbase may make one unpaid request to the seller using the requested method.
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: brand-blind point-in-time discovery ranks, coverage, route presence, runtime-derived or caller-labeled catalog-price drift, optional owned-surface coverage, optional Coinbase materialization state, and method limits
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  product:
                    type: string
                    const: samedaydesk-agent-discoverability-audit
                  version:
                    type: string
                  generatedAt:
                    type: string
                  input:
                    type: object
                  summary:
                    type: object
                  sources:
                    type: object
                  runtimeOfferAudit:
                    type: object
                  findings:
                    type: array
                  nextActions:
                    type: array
                  method:
                    type: string
                  safety:
                    type: object
                  boundary:
                    type: string
                required:
                - ok
                - product
                - version
                - generatedAt
                - input
                - summary
                - sources
                - runtimeOfferAudit
                - findings
                - nextActions
                - method
                - safety
                - boundary
              example:
                ok: true
                product: samedaydesk-agent-discoverability-audit
                version: 1.13.0
                generatedAt: '2026-08-09T00:00:00.000Z'
                input:
                  origin: https://agents.samedaydesk.com
                  intent: extract a public web page into structured JSON metadata headings links and JSON-LD
                  route: /extract
                  runtimeUrl: https://agents.samedaydesk.com/extract?url=https%3A%2F%2Fexample.com
                  expectedPriceUsd: 0.005
                  expectedPriceAtomic: '5000'
                summary:
                  sourceCount: 10
                  availableSourceCount: 10
                  targetFoundSourceCount: 4
                  expectedRouteFoundSourceCount: 4
                  sourceFamilyCount: 9
                  targetFoundSourceFamilyCount: 4
                  priceReference:
                    basis: live_unsigned_offer
                    amountAtomic: '5000'
                    amountUsd: 0.005
                    protocols:
                    - mpp
                    - x402
                  matchedPriceSourceCount: 3
                  driftedPriceSourceCount: 1
                  identityObservationSourceCount: 10
                  identityConflictSourceCount: 1
                  identityConflictSources:
                  - agent402-router
                sources:
                  coinbase-bazaar:
                    status: ok
                    targetFound: true
                    bestTargetRank: 9
                    priceObservation:
                      status: matched
                      expectedPriceAtomic: '5000'
                      observedPricesAtomic:
                      - '5000'
                    identityObservation:
                      schemaVersion: agent-payment-policy.listing-identity-report.v1
                      decision: canonical
                      status: canonical
                      exactRouteRecordCount: 1
                      canonicalRecordCount: 1
                      canonicalOriginMatched: true
                      aliasCandidateCount: 0
                      aliasOrigins: []
                      identityBasis: agent-payment-policy@0.8.0
                      ownershipProven: false
                      evidenceBoundary: An observed record uses the caller-supplied canonical origin. This does not prove marketplace ownership or control.
                runtimeOfferAudit:
                  requested: true
                  status: ok
                  decision: parseable_offer
                  protocols:
                  - mpp
                  - x402
                  offerCount: 2
                findings:
                - code: target_not_top_three
                  source: coinbase-bazaar
                nextActions:
                - action: clarify_semantic_description
                  evidence: target ranked below three competitors
                method: Brand-blind point-in-time catalog query with registry-native ordering.
                safety:
                  credentialsUsed: false
                  paymentSentToCatalogs: false
                  targetOriginFetched: false
                boundary: Point-in-time discovery evidence; not buyer demand, conversion, reliability, or future-rank proof.
        '400':
          description: invalid or branded input, charged nothing
        '402':
          description: payment required (x402, $0.05 USDC base)
      operationId: auditAgentDiscoverability
      tags:
      - Distribution
      x-payment-info:
        operation:
          id: distribution_agent-discoverability-audit
          price: '50000'
          billingBasis: per-call
          supportedRails:
          - x402
        price:
          amount: '0.05'
          currency: USD
          mode: fixed
        protocols:
        - x402:
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            network: eip155:8453
            scheme: exact
  /distribution/agent-surface-budget-audit:
    get:
      summary: Measure one public service's free MCP tools/list, OpenAPI, or both before an…
      parameters:
      - name: origin
        in: query
        required: true
        description: Credential-free public HTTPS service origin on port 443, with no path or query.
        schema:
          type: string
          format: uri
          example: https://agents.samedaydesk.com
      - name: surfaceMode
        in: query
        required: false
        description: Audit MCP only, OpenAPI only, or both declared surfaces. Unselected surfaces are not fetched or judged.
        schema:
          type: string
          enum:
          - mcp
          - openapi
          - both
          default: both
      - name: mcpPath
        in: query
        required: false
        description: Exact root-relative MCP streamable-HTTP path.
        schema:
          type: string
          pattern: ^/[^/?#{}][^?#{}]*$
          default: /mcp
      - name: openApiPath
        in: query
        required: false
        description: Exact root-relative OpenAPI JSON path.
        schema:
          type: string
          pattern: ^/[^/?#{}][^?#{}]*$
          default: /openapi.json
      - name: mcpBudgetBytes
        in: query
        required: false
        description: Maximum preferred raw MCP tools/list response size in bytes.
        schema:
          type: integer
          minimum: 8192
          maximum: 1000000
          default: 65536
      - name: openApiBudgetBytes
        in: query
        required: false
        description: Maximum preferred raw OpenAPI document size in bytes.
        schema:
          type: integer
          minimum: 32768
          maximum: 1000000
          default: 524288
      responses:
        '200':
          description: bounded MCP and OpenAPI surface measurements, budget decisions, and repair actions
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                properties:
                  ok:
                    type: boolean
                  product:
                    type: string
                    const: samedaydesk-agent-surface-budget-audit
                  version:
                    type: string
                    const: 1.2.0
                  checkedAt:
                    type: string
                    format: date-time
                  decision:
                    type: string
                    enum:
                    - within_budget
                    - optimize
                    - surface_incomplete
                  request:
                    type: object
                  mcp:
                    type: object
                  openapi:
                    type: object
                  actions:
                    type: array
                    items:
                      type: string
                  boundary:
                    type: object
                required:
                - ok
                - product
                - version
                - checkedAt
                - decision
                - request
                - mcp
                - openapi
                - actions
                - boundary
              example:
                ok: true
                product: samedaydesk-agent-surface-budget-audit
                version: 1.2.0
                checkedAt: '2026-08-12T15:00:00.000Z'
                decision: optimize
                request:
                  origin: https://agents.samedaydesk.com
                  surfaceMode: both
                  mcpPath: /mcp
                  openApiPath: /openapi.json
                  mcpBudgetBytes: 65536
                  openApiBudgetBytes: 524288
                mcp:
                  requested: true
                  available: true
                  bytes: 90000
                  byteDerivedTokenEstimate: 22500
                  budgetBytes: 65536
                  withinBudget: false
                  protocolVersion: '2025-11-25'
                  server:
                    name: example
                    version: 1.0.0
                  toolCount: 20
                  pageCount: 1
                  selectionBytes: 87000
                  missingTitleCount: 0
                  missingDescriptionCount: 0
                  missingInputSchemaCount: 0
                  missingOutputSchemaCount: 20
                  heaviestTools: []
                openapi:
                  requested: true
                  available: true
                  bytes: 300000
                  byteDerivedTokenEstimate: 75000
                  budgetBytes: 524288
                  withinBudget: true
                  operationCount: 25
                  missingOperationIdCount: 0
                  heaviestOperations: []
                actions:
                - Add progressive MCP tool discovery or split the server into task-focused tool sets so clients do not ingest the full catalog every turn.
                boundary:
                  credentialsUsed: false
                  toolsCalled: false
                  targetPaymentSigned: false
                  targetPaymentSent: false
                  redirectsFollowed: false
                  responseBodiesReturned: false
                  schemasRetained: false
                  sessionIdentifiersReturned: false
                  tokenEstimateMethod: ceil(UTF-8 bytes / 4); comparative estimate, not tokenizer billing
        '400':
          description: invalid public origin, path, or byte budget, charged nothing
        '402':
          description: payment required (x402, $0.01 USDC base)
      x-payment-info:
        operation:
          id: distribution_agent-surface-budget-audit
          price: '10000'
          billingBasis: per-call
          supportedRails:
          - x402
        price:
          amount: '0.01'
          currency: USD
          mode: fixed
        protocols:
        - x402:
            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
            network: eip155:8453
            scheme: exact
      operationId: auditAgentSurfaceBudget
      tags:
      - Distribution
x-service-info:
  categories:
  - agentic-payments
  - machine-commerce
  - data
  - defi
  docs:
    extractionTrial: https://agents.samedaydesk.com/.well-known/extraction-trial
    apiReference: https://agents.samedaydesk.com/openapi.json
    homepage: https://agents.samedaydesk.com
    llms: https://agents.samedaydesk.com/llms.txt
    buyerPolicyReference: https://github.com/epistemedeus/agent-payment-policy
    purchaseEvidence: https://agents.samedaydesk.com/.well-known/agent-payment-evidence.json
    callerResultClient: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/descriptor.json
    callerResultArchive: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/samedaydesk-caller-result-0.1.2.tar.gz
  callerResultClient:
    schema: samedaydesk.caller-result-client.v1
    name: samedaydesk-caller-result
    version: 0.1.2
    license: MIT
    optional: true
    charged: false
    paymentRequired: false
    npmPublished: false
    nodeMinimum: 22.12.0
    archiveUrl: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/samedaydesk-caller-result-0.1.2.tar.gz
    sha256: df8cf4e24d437a0d49779cd2fee87b8145c6c8cb171a0b9f68b1c1a2195c322c
    descriptorUrl: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.2/descriptor.json
    sourceUrl: https://github.com/epistemedeus/x402-url-extractor/tree/f8b939c5dc7a66d59b2b2d6358f3158dfa56d542/caller-result-client
    sdk:
      '@modelcontextprotocol/sdk': 1.30.0
      '@x402/mcp': 2.16.0
    install:
    - mkdir samedaydesk-caller-result
    - tar -xzf samedaydesk-caller-result-0.1.2.tar.gz -C samedaydesk-caller-result
    - cd samedaydesk-caller-result
    - npm ci --ignore-scripts
    modules:
      mcp:
        exportName: bindPaidMcpCallerResult
        specifier: ./src/mcp-caller-result.mjs
        packageExport: samedaydesk-caller-result/mcp
      http:
        exportNames:
        - bindCallerResultFeedback
        - reportCallerResult
        specifier: ./src/http-caller-result.mjs
        packageExport: samedaydesk-caller-result/http
      recovery:
        exportNames:
        - startPaidMcpResult
        - resumePaidMcpResult
        specifier: ./src/mcp-recovery.mjs
        packageExport: samedaydesk-caller-result/recovery
        bin: bin/recover-mcp.mjs
      continuation:
        exportNames:
        - discoverHttpNextActions
        - discoverSdkNextActions
        - retrieveEntitledHttp
        specifier: ./src/continuation.mjs
        packageExport: samedaydesk-caller-result/continuation
    feedback:
      optional: true
      charged: false
      usefulness: unknown
      dispositions:
      - useful
      - not_useful
      http:
        method: POST
        path: /commerce/caller-result-feedback
        header: x-samedaydesk-caller-result-feedback
        schema: samedaydesk.caller-result-feedback.v1
      mcp:
        tool: report_caller_result
        method: tools/call
        metaKey: samedaydesk/mcp-caller-result
        schema: samedaydesk.caller-result-feedback.mcp.v1
        wrapperOmitsMeta: true
    feedbackArchive:
      version: 0.1.0
      archiveUrl: https://neomorphic.io/downloads/samedaydesk-caller-result/0.1.0/samedaydesk-caller-result-0.1.0.tar.gz
      sha256: 3c134598697aadb038a98bfee4ad6e82472df34d3fa325e19507a33ed5dc974b
      containsRecovery: false
      relativePath: caller-result-client/export/public/bytes/samedaydesk-caller-result/0.1.0/samedaydesk-caller-result-0.1.0.tar.gz
    nextAction: Download the current archive, verify sha256, unpack with the install lines, and import bindPaidMcpCallerResult. Optional recovery of an already authorized paid result imports startPaidMcpResult and resumePaidMcpResult from samedaydesk-caller-result/recovery, or runs node bin/recover-mcp.mjs in a second process. The 0.1.0 archive is feedback only. Report useful or not_useful only when you choose. Skipping the statement leaves the purchase.