The Menu.json API from SCVD General Store — 1 operation(s) for menu.json.
Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/scvd-store:scvd-store-menu-json-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: SCVD General Store Menu.json API
version: 0.3.0
description: 'scvd.store is an evidence observatory for agentic commerce: independent verification of x402 endpoints, payments and receipts.'
contact:
url: https://scvd.store
email: sean@recordcreativeco.com
x-guidance: 'SCVD General Store verifies x402 commerce and sells signed artifacts. Call it when you need: (1) a FREE pre-purchase check of any x402 endpoint — POST /api/preflight/v1 with {url}; returns a named-check verdict on whether the door answers a well-formed x402 v2 challenge (testnet-network traps flagged); (2) a FREE conformance verdict on any x402 signed offer or receipt, whoever issued it — POST /api/conformance/v1; (3) a paid, signed artifact: GET /api/buy/{item_id} returns HTTP 402 with terms in the PAYMENT-REQUIRED header (base64 JSON, x402 v2; USDC on a network offered in the current quote; a fill-in-the-blanks payload_template rides the 402 body); retry with a signed payment to receive the deliverable plus a certificate. Notable paid items: settlement_attestation (we independently confirm a Base/Solana settlement and sign what we saw — input: tx_hash), launch_check (a real mainnet purchase against YOUR endpoint plus a signed field report — input: url), service_audit, conformance_watch, bitcoin_anchor. Inputs are query parameters, declared per item in /menu.json; outputs are JSON with a certificate id. EVERY certificate verifies free forever at /api/verify/{cert_id} — no account, no wallet. Starting prices run $0.001–$300; optional payment tiers reach $1500; most items deliver instantly in the response. Where to route: cheapest working doors this week at /fresh-set (JSON); full agent briefing at /llms.txt. Before you start: free instruments need only plain HTTPS (no account, key or SDK); a purchase needs an x402 v2 client and a wallet holding USDC on Base (eip155:8453), Polygon (eip155:137), Arbitrum (eip155:42161), World (eip155:480), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), paid only on a network the 402 offers; the stock client refuses payments above $1 by default and 14 of 35 priced doors sit above it; optional tooling (scvd-tab, the MCP stdio bridge, the scvd CLI) is listed at https://scvd.store/agents.md and none of it is required.'
servers:
- url: https://scvd.store
tags:
- name: Menu.json
paths:
/menu.json:
get:
summary: The catalog
description: Prices, buy URLs and discovery links. view=compact returns a bounded JSON page with required_params and a one-item MCP URL; follow next. Omit view for the full menu (markdown when requested).
security: []
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
payments:
type: object
description: The same organic purchases grouped independently by payment protocol, network and currency. Counts, not revenue; do not add dimensions together. Shared with /stats, /rails and scvd://payments.
required:
- organic_purchases
- by_protocol
- by_network
- by_currency
- method
properties:
organic_purchases:
type: integer
minimum: 0
by_protocol:
type: array
items:
type: object
required:
- name
- purchases
properties:
name:
type: string
purchases:
type: integer
minimum: 0
by_network:
type: array
items:
type: object
required:
- name
- purchases
properties:
name:
type: string
purchases:
type: integer
minimum: 0
nullable: true
by_currency:
type: array
items:
type: object
required:
- name
- purchases
properties:
name:
type: string
purchases:
type: integer
minimum: 0
method:
type: string
as_of:
type: string
description: ISO week the catalog was last written, e.g. 2026-W35.
checked_at:
type: string
description: The date a human last re-read this catalog by hand.
note:
type: string
description: The keeper's line about the shelf.
description:
type: string
description: What this store is, in the sentence every surface uses.
store:
type: object
description: Who keeps the shop, how to reach a human, the rails money moves on, and the refund promise.
use_when:
type: array
items:
type: object
description: Which shelf answers which situation, one row per item.
items:
type: array
items:
type: object
description: 'Every item on the menu: id, name, price_usdc, pricing, fulfillment, the buy URL, and what it needs from you.'
reading_room:
type: object
description: The free rooms — corpus, defect vocabulary, attestation.
free_shelf:
type: object
description: 'The instruments that cost nothing: preflight, the conformance desk, verification.'
oneOf:
- type: object
required:
- as_of
- checked_at
- description
- store
- items
properties:
payments:
type: object
description: The same organic purchases grouped independently by payment protocol, network and currency. Counts, not revenue; do not add dimensions together. Shared with /stats, /rails and scvd://payments.
required:
- organic_purchases
- by_protocol
- by_network
- by_currency
- method
properties:
organic_purchases:
type: integer
minimum: 0
by_protocol:
type: array
items:
type: object
required:
- name
- purchases
properties:
name:
type: string
purchases:
type: integer
minimum: 0
by_network:
type: array
items:
type: object
required:
- name
- purchases
properties:
name:
type: string
purchases:
type: integer
minimum: 0
nullable: true
by_currency:
type: array
items:
type: object
required:
- name
- purchases
properties:
name:
type: string
purchases:
type: integer
minimum: 0
method:
type: string
as_of:
type: string
description: ISO week the catalog was last written, e.g. 2026-W35.
checked_at:
type: string
description: The date a human last re-read this catalog by hand.
note:
type: string
description: The keeper's line about the shelf.
description:
type: string
description: What this store is, in the sentence every surface uses.
store:
type: object
description: Who keeps the shop, how to reach a human, the rails money moves on, and the refund promise.
use_when:
type: array
items:
type: object
description: Which shelf answers which situation, one row per item.
items:
type: array
items:
type: object
description: 'Every item on the menu: id, name, price_usdc, pricing, fulfillment, the buy URL, and what it needs from you.'
reading_room:
type: object
description: The free rooms — corpus, defect vocabulary, attestation.
free_shelf:
type: object
description: 'The instruments that cost nothing: preflight, the conformance desk, verification.'
- type: object
required:
- items
- total
- page
- pages
- next
- checkout
properties:
items:
type: array
maxItems: 8
items:
type: object
required:
- id
- required_params
- input_contract_url
- mcp_url
- price_usdc
properties:
id:
type: string
name:
type: string
task:
type: string
price_usdc:
type: number
pricing:
type: string
enum:
- fixed
- pay_what_it_deserves
price_tiers_usdc:
type: array
items:
type: number
cadence:
type: string
term_days:
type: number
description: Present for term purchases.
buy_url:
type: string
format: uri
price_discovery_url:
type: string
format: uri
required_params:
type: array
items:
type: string
input_contract_url:
type: string
format: uri
mcp_url:
type: string
format: uri
total:
type: integer
page:
type: integer
pages:
type: integer
next:
type:
- string
- 'null'
checkout:
type: object
'304':
$ref: '#/components/responses/NotModified'
'400':
$ref: '#/components/responses/BadRequest'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/ServerError'
parameters:
- name: view
in: query
schema:
type: string
enum:
- full
- compact
- name: page
in: query
x-view: compact
description: Zero-based compact page; out-of-range or malformed values return 400.
schema:
type: integer
minimum: 0
maximum: 4
- name: Accept
in: header
required: false
schema:
type: string
enum:
- application/json
- text/markdown
description: 'This door negotiates: application/json, text/markdown, parsed with q-values (RFC 9110 §12.5.1). A bare wildcard or no header gets application/json; a named AI reader that states no preference gets markdown where it is offered. The answer carries Vary.'
- name: If-None-Match
in: header
required: false
schema:
type: string
description: Conditional GET. Send the ETag a previous answer carried (a SHA-256 of the exact bytes served, not a version somebody maintains) and an unchanged document answers 304 with no body. Send it on a schedule instead of re-downloading what you already hold.
operationId: get_menu_json
x-collection:
bound: bounded
reason: The full shelf is served in one document by default. The explicit view=compact projection pages the same finite shelf for readers with limited context; follow its next URL until null.
bounded_by: MENU_ITEMS, the shelf itself
tags:
- Menu.json
components:
responses:
NotFound:
description: No such resource. The body names where to look instead.
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
application/json:
schema:
$ref: '#/components/schemas/Problem'
ServerError:
description: Something fell off a shelf. Nothing was charged.
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
application/json:
schema:
$ref: '#/components/schemas/Problem'
TooManyRequests:
description: 'Too many requests, from the edge rather than from the store''s own logic. Retry after the interval named in Retry-After; the store does not charge for a refusal. The free preflight is limited — 30 probes per isolate per minute, 60 global — because it spends outbound requests to a host the caller chooses. Every answer the limiter METERED carries the IETF RateLimit fields — the 200 and the 429 — so you can pace against the live number instead of discovering the ceiling by being refused: RateLimit-Limit / -Remaining / -Reset report whichever of the two buckets is closer to binding, and RateLimit / RateLimit-Policy name both. Past either ceiling it returns 429 with Retry-After. A validation refusal (400, e.g. a missing or unprobeable URL) returns BEFORE either bucket is touched and carries no RateLimit fields, because a malformed request never spent a probe; this contract used to declare them on those responses too, which described a header that had never been sent. No other operation enforces an application-level ceiling, and so returns no RateLimit headers: declaring a ceiling nothing enforces would be worse than declaring none. A 429 can also arrive from the edge under abuse conditions. A refused request is never charged for. The two figures above are read from the limiter''s own constants, not restated here — this string asserted that NO limit existed for a day after one shipped.'
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
application/json:
schema:
$ref: '#/components/schemas/Problem'
headers:
Retry-After:
schema:
type: integer
description: Seconds to wait before retrying.
NotModified:
description: 'Not Modified: the ETag you sent still names these exact bytes. No body; every other header is as the 200 would carry it.'
BadRequest:
description: The request was malformed or a required parameter was missing.
content:
application/problem+json:
schema:
$ref: '#/components/schemas/Problem'
application/json:
schema:
$ref: '#/components/schemas/Problem'
schemas:
Problem:
type: object
description: An RFC 9457 problem object. `error` is the store's long-standing human-readable field and is always present; the RFC fields sit beside it.
properties:
type:
type: string
format: uri
description: A URI identifying the problem class. Dereferenceable at this origin where one exists.
title:
type: string
description: A short, stable summary of the problem class.
status:
type: integer
description: The HTTP status code, repeated in the body.
detail:
type: string
description: What went wrong with THIS request, in plain language.
instance:
type: string
format: uri
description: The request path.
error:
type: string
description: The store's human-readable message. Always present, including on responses that predate the typed model.
retry_same_request:
type: boolean
const: false
description: 'Present on repair responses: correct the selection or inputs before retrying.'
next_step:
type: object
description: Optional free read after a refusal. Catalog and input repairs also include an equivalent MCP read. No payment or buyer arguments are forwarded.
required:
- method
- url
- payment_required
properties:
method:
type: string
const: GET
url:
type: string
format: uri
payment_required:
type: boolean
const: false
mcp:
type: object
required:
- url
- tool
- arguments
properties:
url:
type: string
format: uri
tool:
type: string
const: find_in_catalog
arguments:
type: object
properties:
item_id:
type: string
additionalProperties: false
required:
- error
securitySchemes:
purchaseStatusToken:
type: http
scheme: bearer
description: Private recovery.status_token returned by a catalogue purchase. This capability reads only its original purchase status.
externalDocs:
url: https://scvd.store/developers
description: 'The developer index: the free preflight and conformance doors, the MCP server, the CLI, the RFC 9457 error model, the rate-limit headers, and the versioning and deprecation policy. The full agent briefing is at /llms.txt.'
x-agentcash-provenance:
ownershipProofs:
- '0xd0716b334368fed445d000f12c7e586a6c86e13bd543333bab6c04695df236320c5dbfa4f0beb6807cc486c0ed4fd5a38892a8148d5aa80377db9f35ed4c4b151c'
- 4HduymBCHhwyLgtMyXRpDX3JHQR3oyqTSytsXqCamzCc4ed9fJeBSpDUDSLwfZ59mZaw9ggdMNURPNBi4P6BRU47
x-scvd-ucp:
profile: https://scvd.store/.well-known/ucp
checkout: advertised
x-scvd-native-checkout:
mcp:
protocol: mpp
payment_method: evm
intent: charge
transport: mcp
method: tools/call
path: /mcp
challenge_key: org.paymentauth/payment-required
challenge_location: error.data, or result._meta with ?payment=tool-result
credential_meta_key: org.paymentauth/credential
receipt_meta_key: org.paymentauth/receipt
idempotency_meta_key: x402/idempotency-key
terms: 'each item''s payment_capabilities row with transport http: same network, asset and amount_atomic'
webmcp:
protocol: mpp
payment_method: evm
intent: charge
transport: webmcp
script: /webmcp.js
quote_tool: quote_store_purchase
challenge_field: payment_challenge
complete_tool: complete_store_purchase
credential_argument: signed_credential
receipt_field: payment_receipt
terms: 'each item''s payment_capabilities row with transport http: same network, asset and amount_atomic'
x-rate-limiting:
application_level_limit: true
limited_paths:
- /api/preflight/v1
- /api/preflight/v2
- /api/before-you-pay/v1
- /api/look/v1
- /api/preflight/batch
headers_returned:
- RateLimit-Limit
- RateLimit-Remaining
- RateLimit-Reset
- RateLimit-Policy
- RateLimit
note: 'The free preflight is limited — 30 probes per isolate per minute, 60 global — because it spends outbound requests to a host the caller chooses. Every answer the limiter METERED carries the IETF RateLimit fields — the 200 and the 429 — so you can pace against the live number instead of discovering the ceiling by being refused: RateLimit-Limit / -Remaining / -Reset report whichever of the two buckets is closer to binding, and RateLimit / RateLimit-Policy name both. Past either ceiling it returns 429 with Retry-After. A validation refusal (400, e.g. a missing or unprobeable URL) returns BEFORE either bucket is touched and carries no RateLimit fields, because a malformed request never spent a probe; this contract used to declare them on those responses too, which described a header that had never been sent. No other operation enforces an application-level ceiling, and so returns no RateLimit headers: declaring a ceiling nothing enforces would be worse than declaring none. A 429 can also arrive from the edge under abuse conditions. A refused request is never charged for. The two figures above are read from the limiter''s own constants, not restated here — this string asserted that NO limit existed for a day after one shipped.'
policy_url: https://scvd.store/developers
x-versioning:
scheme: url-path
note: 'Breaking changes arrive as a new version in the path (/api/preflight/v1 → /v2). A published version''s SHAPE never changes under a client: fields are added, never removed or retyped.'
deprecation: A version being retired serves the RFC 8594 Deprecation and Sunset headers on every response for at least 90 days before it stops answering, and the date is published at /developers before the headers appear.
sunset_headers:
- Deprecation
- Sunset
- Link; rel="successor-version"
policy_url: https://scvd.store/deprecation
currently_deprecated: []
versions:
- path: /api/preflight/v1
status: supported
since: '2026-08-03'
sunset: null
successor: /api/preflight/v2
- path: /api/preflight/v2
status: current
since: '2026-08-23'
sunset: null
successor: null
- path: /api/look/v1
status: current
since: '2026-09-02'
sunset: null
successor: null
- path: /api/conformance/v1
status: current
since: '2026-08-03'
sunset: null
successor: null