{"name":"SCVD General Store — developer documentation","description":"Developer documentation for scvd.store: the OpenAPI 3.1 contract, the free preflight and conformance endpoints, the MCP server, the x402 payment flow, the typed error model, rate-limit headers and the versioning policy. No account or API key exists to obtain.","authentication":"None. No account or API key exists. Paid endpoints take a signed x402 v2 payment per request.","openapi":"https://scvd.store/openapi.json","guide":"https://scvd.store/llms.txt","manual":"https://scvd.store/agents.md","mcp":"https://scvd.store/.well-known/mcp","cli":{"npm":"scvd-tab","install":"npm i -g scvd-tab","bin":["scvd-tab","scvd-tab-pager"],"license":"MIT","registry":"https://www.npmjs.com/package/scvd-tab","note":"Works against any x402 store, not only this one."},"sections":[{"heading":"Start here","entries":[{"href":"https://scvd.store/llms.txt","label":"/llms.txt","what":"The full briefing: what this store is, what it sells, and what it refuses to claim. Read this before writing any code against it."},{"href":"https://scvd.store/agents.md","label":"/agents.md","what":"The operational manual — the x402 purchase flow step by step, for an agent executing rather than evaluating."},{"href":"https://scvd.store/openapi.json","label":"/openapi.json","what":"OpenAPI 3.1 for every endpoint: unique operationIds, typed parameters, typed error responses, and the x402 terms on every paid operation."}]},{"heading":"Free, no payment, no account","entries":[{"href":"https://scvd.store/api/preflight/v1","label":"POST /api/preflight/v1","what":"Check whether any x402 endpoint answers a well-formed payment challenge. Send {\"url\": \"...\"}; get back a named-check verdict. The published criteria are at the same path over GET."},{"href":"https://scvd.store/api/conformance/v1","label":"POST /api/conformance/v1","what":"A conformance verdict on any x402 signed offer or receipt, whoever issued it."},{"href":"https://scvd.store/fresh-set","label":"GET /fresh-set","what":"This week's x402 doors that answered a conformant challenge, with rails and cheapest ask per host. Routing data, CC BY 4.0."},{"href":"https://scvd.store/okf/index.md","label":"GET /okf/index.md","what":"The same evidence as an Open Knowledge Format v0.2 bundle — markdown concepts with YAML frontmatter, cross-linked, machine-confirmed and dated."},{"href":"https://scvd.store/corpus.json","label":"GET /corpus.json","what":"The weekly signed census of the public x402 web, as a dataset."},{"href":"https://scvd.store/api/verify/{id}","label":"GET /api/verify/{id}","what":"Verify anything this store ever signed. No account, no wallet, free forever — including artifacts you did not buy."}]},{"heading":"Connect over MCP","entries":[{"href":"https://scvd.store/.well-known/mcp","label":"/.well-known/mcp","what":"Where the MCP server is and what it serves."},{"href":"https://scvd.store/mcp","label":"POST /mcp","what":"Streamable HTTP MCP. tools/list is free; buy_* tools are x402-paid. 5 resources are readable without payment."}]},{"heading":"On the command line","entries":[{"href":"https://www.npmjs.com/package/scvd-tab","label":"npm i -g scvd-tab","what":"The tab: a local, append-only ledger of what your agent spent and what it got, with a pooled corpus you can contribute to. Two binaries — `scvd-tab` and `scvd-tab-pager`. MIT, zero required config, and it works against any x402 store, not only this one."}]}],"conventions":[{"q":"Authentication","a":"There is none, and there is nothing to sign up for. Free shelves are open to anyone. Paid endpoints answer HTTP 402 with x402 v2 terms in the PAYMENT-REQUIRED header (base64 JSON); you sign one of the offered accepts and retry with the payment. Payment is per request and settles wallet-to-wallet — this store never holds your funds, issues a key, or keeps an account."},{"q":"Errors","a":"4xx and 5xx return an RFC 9457 problem object (application/problem+json): type, title, status, detail, instance. The store's long-standing human-readable `error` field rides beside them and is always present, so nothing that reads it breaks."},{"q":"Rate limits","a":"There is no application-level rate limit, and so no RateLimit-Limit/-Remaining/-Reset headers — a ceiling nothing enforces is worse than no ceiling, because you would throttle against a fiction. A 429 can still arrive from the edge in front of the store under abuse conditions, and it carries Retry-After. A refused request is never charged for. If a limiter is ever added it will announce itself in those headers and be documented here first."},{"q":"Versioning and deprecation","a":"Breaking changes arrive as a new version in the URL path (/api/preflight/v1 → /v2). Within a published version, fields are added and never removed or retyped. A version being retired serves RFC 8594 Deprecation and Sunset headers on every response for at least 90 days first, and the date is published here before the headers appear. Nothing is deprecated today."},{"q":"Content negotiation","a":"Send Accept: text/markdown and the agent-facing surfaces answer in markdown, including https://scvd.store/ itself. Responses carry Vary: Accept so a cache keeps the variants apart. Accept is parsed by q-value, not substring-matched."}],"contact":"sean@recordcreativeco.com"}