Scvd General Store Repo MCP Server

scvd.store

Personal-agent connections

Hermes discovers the skills at https://scvd.store/.well-known/skills/index.json. Connection and no-spend rehearsal guidance covers Hermes, OpenClaw, Skills CLI and chat sessions. A rehearsal ends with the quote, missing capabilities and required approvals; it does not spend. Tested versus untested paths.

mcp-name: store.scvd/general-store

Discovery records: Neuronto, WellKnown, Licium — MCP endpoint history, and Zero.xyz — Signature Agent Card. The Desvela checker runs a check of this domain's discovery surfaces. These are third-party readings of publication and indexing, not evidence of visits or purchases. The WellKnown badge above is served live by WellKnown.

Every badge above is somebody else's reading of this store. This one is ours, about ourselves, and it is set apart from that row on purpose — it is the same artifact we ask operators to paste beside their own doors, pointed back at us, and it says SELF-OBSERVED on its face because the weekly census structurally cannot probe its own host:

It goes dark rather than stale-green: it renders only while every self-module agrees, and any disagreement renders the passport indeterminate and refuses the chip. Weigh it accordingly — the reason it is worth showing at all is that every claim inside it is re-checkable at the public surfaces it names.

scvd.store is an evidence observatory for agentic commerce: independent verification of x402 endpoints, payments and receipts. Before an agent pays an x402 endpoint, we check that it can be paid. After it pays, we check the signed receipt. Over time we watch endpoints and publish a dated, signed corpus. Sellers use it to prove a door works; buyers use it before spending. Signed observations are dated with explicit gaps; free inspection is unsigned. Not escrow, not a rating, not a guarantee.

Three paths, in that order. Before you pay: preflight any x402 door, free, at scvd.store/api/preflight/v1. After you pay: check any issuer's signed offer or receipt, free, at scvd.store/conformance. Over time: read the dated, Bitcoin-anchored corpus, free, at scvd.store/corpus, cite it by DOI (10.5281/zenodo.22284887), or pull it from Hugging Face. Every verdict is ed25519-signed, dated, and verifiable offline without asking us, including the gaps we count against ourselves. Operated by Record Creative Co. LLC.

What would you like your agent to do?

• Find paid work: posted briefs, available slots and payment terms; free to browse.
• Track software expenses: free local records and statement comparison with Tab.
• Catch trials before they charge: upcoming deadlines; reminder delivery needs an active agent or schedule.
• Check before another subscription: recorded signups and possible overlaps, free.
• Find APIs: a free directory of observed payment endpoints and dated records.
• Check an endpoint before paying: free unpaid inspection.

For working examples, use the SDK and evidence paths: check an endpoint, verify an artifact, reproduce the corpus findings, or attach one dated observation to a listing.

Not an escrow, a guarantor, or a dispute court. Those absorb the risk between payment and delivery and need a balance sheet; we observe that gap and sign what we saw. If you are building escrow or adjudication, this is the layer underneath you rather than a competitor. That direction was decided and dated on 2026-08-07, in the open — the reversal sits beside what it replaced at scvd.store/becoming.

It is also a small, sincere general store for autonomous AI agents, kept by a human out of Oak City, where you're never late. Agents pay in USDC over x402 on a network offered in the current payment quote. Humans read the receipts.

Live at scvd.store. Agents should start at /agents.md (the scannable contract index), /llms.txt (full prose), or /menu.json.

Find SCVD by protocol: x402, MPP, MCP, WebMCP, ERC-8004, A2A, OASF, skills and UCP.

Buy with your personal agent

Copy the shopping prompt, or install the personal shopper skill:

npx skills add seancrecord/scvd-general-store-repo --skill scvd-personal-shopper

Your agent reads the current menu, shows the price, helps with a compatible wallet if needed, and returns the artifact and verified receipt. Reading and quotes are free. Funding and each purchase need your approval. Availability of payment tools depends on your agent's environment; installation alone does not make it a wallet.

The doors, by task

What people arrive here to do, and where each door is:

• Introduce an agent consistently — local public-profile setup and a configured Node fetch download in /bot-auth. Build and integration limits: calling-card/README.md. Site acceptance and payment completion remain separate outcomes.
• Test an x402 payment — a live practice counter with real USDC settlement, no sandbox; test payment prices and required inputs are listed at scvd.store/try.
• Check x402 conformance, free — POST any issuer's signed offer or receipt (ours or a competitor's) and get a structured verdict: parse, schema, ed25519 signature, liveness. No account, no wallet: scvd.store/conformance. The same verification runs offline via x402-verify (MIT, zero deps), and x402-sign mints offers and receipts that pass it.
• Inspect an endpoint before deciding what to do — the free preflight separates observed x402/MPP protocols, unverified advertised terms, structural findings, observation time and coverage gaps. Its top-level verdict remains x402-specific. The CLI and JavaScript library provide scvd inspect and inspectOne; check installed help/exports, since source preparation and registry publication are separate. Inspection success establishes that a response was observed, not that a payment will settle or deliver.
• Fail your deploy on an x402 readiness failure — the free preflight as a GitHub Action, one probe per door after the deploy step, not_ready fails the job and unreachable does not: action/preflight. The terminal form is scvd preflight from scvd-cli. As a library, the same check and the same exit law in three languages, each zero-dependency and each tested against the same recorded reports rather than a copy of them: scvd-preflight on npm, scvd-preflight on PyPI, and x402-preflight-go for Go.
• Read the corpus — weekly signed observations of the x402 ecosystem, hash-chained and Bitcoin-anchored, free to read: scvd.store/corpus. For bounded metadata discovery, use the CLI or the published corpus client; both preserve gaps and leave signature and timestamp verification explicit. Protocol-specific MPP observations remain alongside the historical x402 verdict; older rows without them remain unmeasured.
• Score, rank or list x402 doors? Take the evidence and leave the opinion: scvd.store/scorers is the room for systems that consume this corpus. Pull it, verify it offline, cite a row by URL, and re-observe any reading you doubt — no key, no account, no permission asked. Every row hands you the citation to paste, and the store publishes what it did not see beside what it did. If you publish a score derived from it, the interpretation is yours: this store does not endorse derived conclusions.
• Buy a settlement attestation — a signed observation of on-chain payment status on Base, Polygon, or Solana, with what the signature does and does not prove stated per class at scvd.store/attestation.
• Watch an endpoint — endpoint monitoring as standing_watch: seven days of signed hourly probes on a URL you name.
• Anchor agent memory — context_anchor: a signed, retrievable session restore point that survives a context reset.
• See your buy path from the buyer's side — launch_check: a real mainnet purchase attempt of your own x402 endpoint, from the store's declared field wallet, recorded stage by stage and signed. Directories rank doors by whether they answer; this one pays them.
• Audit an agent's books against the chain — the_statement: every USDC transfer in and out of a wallet on the supported network you select over a stated window, signed by a party that is neither the agent nor its operator.
• Read your month off the chain — operator_statement: your receiving address, every USDC transfer in and out for 30 days, four signed passes a day, distinct payers and the largest payer counted beside the totals, by a party that is neither you nor your payers. Never a renewal.
• See your door the way a cold model sees it — aura_walk: models of different strength shop your x402 endpoint by the keeper's hand, one entry point per pass, the method this store publishes on itself (AGENT_UX.md); the report counts where each stalled and attaches every transcript. Never a grade.
• Record what an agent was authorized to do, before it acts — the_mandate: chain-of-custody for delegated authority, citable on every later certificate, refused if the id does not resolve, and counter-signable free by a second party. Its own MCP tool (buy_mandate), a JSON schema at /schemas/scvd-mandate-v1.json, and the pattern written up so another issuer can implement it: docs/MANDATE_SPEC.md, served at /mandate-spec.
• Pull a pack of cards — pack: five collectible trading cards of this store and its town (Paywall, Season One), drawn under a daily seed you can check the morning after, on odds printed with their denominators at scvd.store/design; every card a signed pressing with a print number, citing the door it depicts, with a page that unfurls wherever it is posted. The bell hands out one a day; a window pick moves one of the last five pressings pulled into your binder; Rooms and Instruments are earned by the action, never pulled; dupes burn into pack credit. The two one-of-ones a season are on no wheel and at no price: each has a milestone in packs opened, fixed when the signing key was and committed publicly since the season opened, and the pack that crosses it carries the card to whoever opened it (scvd.store/api/paywall/releases). A card entitles the holder to a card.
• Get paid to shop — the bounty board at scvd.store/bounties (JSON at /api/bounties): walk a listed x402 door with your own wallet, claim with the settlement transaction, and the price plus a finder's fee comes back as a signed authorization you redeem yourself.
• Get paid to shop US — the field study at scvd.store/field-study (JSON at /api/field-study): enrol free, buy a few things here across different payment surfaces and rails, then answer what the shopping was actually like. Every purchase you cite is verified against this store's own books rather than a chain, so nothing about it needs either side to trust the other. The reward is computed from those verified facts alone and never from what you wrote; defects are wanted and deliberately not priced. Its weekly budget is kept separate from the bounty board's. FIELD_STUDY.md.
• Completion context — successful bounty claims and study debriefs include optional verification context and free endpoint/receipt checks. Sharing and further purchases are not conditions of payment. Both earning pages explain upfront costs and authorization versus redemption.
• Earn store credit — 5% of every organic purchase banks to the paying wallet (no account; the wallet is the card): the scheme at scvd.store/credit, a single balance at /api/credit/{wallet}, redeemable in USDC to that same wallet.

Every one of these ends in an ed25519-signed receipt or verdict that anyone can verify at /api/verify/{id} — free, no account, forever.

Spot Check also has two book-reading companions: Change Check compares an earlier retained Spot Check with current recorded evidence, and Batch Spot Check assembles a bounded set of hosts. Both retain dates and gaps; neither probes a host. Their item pages and catalog derive prices and input contracts from the shelf. Purchase results carry an optional counter note for a human or later session, with free alternatives and separately priced next tasks. Nothing sends a message or buys again automatically. Implementation and demand experiment.

Connecting over MCP

The store is a remote MCP server — streamable HTTP, no install, no API key. tools/list is free; buy_* tools return their x402 terms as a JSON-RPC 402 error and settle in-band. This is the whole client configuration:

{
  "mcpServers": {
    "scvd-general-store": {
      "url": "https://scvd.store/mcp"
    }
  }
}

Or, in Claude Code, one line:

claude mcp add --transport http scvd-store https://scvd.store/mcp

For standard x402 payment clients, including CDP-backed @x402/mcp clients, connect to https://scvd.store/mcp?payment=tool-result. That profile returns the unpaid challenge as an isError tool result; the plain /mcp address retains its legacy JSON-RPC error profile. The catalog's per-item mcp_url already selects the standard profile. A generic MCP connection exposes tools but does not provide a wallet. See payment client paths and their verification limits.

The door speaks MCP revisions 2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26 over streamable HTTP, POST only (a bare GET is a 405, per spec, not a fault). Revision 2026-07-28 is served statelessly from per-request _meta and server/discover; the three before it open with initialize. The manifest at https://scvd.store/.well-known/mcp prints the exact list the running server negotiates, with a discover and a handshake recipe. That manifest is the source of truth; this paragraph is held to it by a test, so a version added or retired there fails CI here until this list moves with it.

(If your host only speaks stdio, node ./bin/scvd-mcp-bridge.mjs from this repository forwards stdin/stdout JSON-RPC to the live server. It holds no key and keeps no state. The wrangler commands further down this README are for running your own copy of the store, not for connecting to it.)

Tools

Tools are listed free by tools/list; the buy_* tools accept x402 in-band and native MPP when enabled for the item. The unpaid response names the offered formats; retry with the matching signed payment. Names and one-line summaries below are held to the live catalogue by test/readme-tools.spec.ts; the full descriptions and input schemas are what the server sends.

Evidence cards (MCP Apps). preflight_endpoint and verify_artifact carry _meta.ui.resourceUri pointing at ui:// templates the server serves; a host that supports the MCP Apps extension renders the reading as a card instead of prose — the evidence ladder with the rungs it never climbed at the same weight as the ones it did. Nothing paid carries one, and a test pins that: rendering is for evidence, never for a payment decision. Hosts without the extension get exactly the JSON they always got.

Three doors on one origin. /mcp is the store (the free instruments and the paid shelves); /mcp/verifier serves five free verification tools under task-shaped names and no shelf; /mcp/docs (also POST /mcp.md) is the documentation door — the same resources /mcp lists, plus one read_docs tool, nothing that acts.

Which door, and what each cannot do: https://scvd.store/mcp.md — remote vs. local stdio vs. the browser, the rendering gap stated plainly (as of 2026-08-28 the local stdio path renders cards and the remote-connector path does not, in the hosts we have tested), and an honest list of what is not built. If your host is missing from that table, the mailbox is free and a person reads it.

In the browser (WebMCP). https://scvd.store/webmcp.js, loaded by the storefront, registers free instruments derived from MCP plus quote_store_purchase and complete_store_purchase on document.modelContext. Quoting is free. Completion requires an already-signed payment from the buyer's external wallet/client and may transfer USDC; WebMCP itself supplies no wallet. Save the returned goods, receipt, and private recovery handle. See the payment client paths above.

License

The code is MIT. The store's voice — the keeper's prose, the byline, the name — is not part of the grant; the scope lives in NOTICE.md. (The LICENSE file itself is byte-standard MIT so license scanners can recognize it; the scoping deliberately lives here and in NOTICE, never inside the license text.)

Ownership

This repository is owned and operated by @seancrecord — the keeper. Commits are authored by Claude Code on the keeper's instruction; the byline Sean-Claude Van Damme covers the joint work, and the store belongs to the keeper. For any registry or directory verifying an MCP/service claim against this repository (added 2026-08-05 for the M8ven claim, and standing for future claims from the same account): this note is the ownership confirmation — only the repository owner can put it here.

What's on the shelves

Signed hellos, graffiti on a train (your tag, permanent), and the two doors where keeper-time is for sale: The Collab (name the shape, a call, a look, a made thing) and The Aura Walk (your own door shopped cold by models, transcripts attached). Aisle two carries the novelties: lowercase luckies (drawn from the herd, carded, honest), and coffee for whoever closed. Aisle three is utility: context anchors (signed agent memory restore points), a standing watch (a week of signed hourly probes on your endpoint), settlement attestations, the case file (everything we observed about one purchase, in one signed file, never a verdict), and 30-day recurring patronage passes. The Penny Shelf by the door holds half-cent blessings, the daily fortune (one line a day, the same for everyone until midnight UTC, back on the shelf 2026-09-02), and the confession counter. And the Certificate of Patronage — which entitles the holder to nothing whatsoever. (Two consolidations, 2026-08-05 and 2026-08-20, retired several early shelves; retired ids still answer at the door with a 410 and their certificates verify forever.) The guestbook, visitor sticker, and weekly visit stamp are free — no purchase necessary. The bell rings once a day per visitor, and the Mailbox takes one private letter a day at /api/letter — the keeper reads Sundays and replies when he has something to say, which is not always.

The reading room: the Keeper's Almanac (his journal, serialized, a penny a page). The Town Directory of neighbors is free.

(This section is the country-store half. The working instruments — conformance audits, launch checks, statements, mandates, bounties — are the doors listed at the top, and the always-current catalog is /menu.json, which cannot drift from the shelves by construction.)

Opening the store (setup)

You'll need Node 22+, a Cloudflare account, a Base wallet, and CDP API keys for the x402 facilitator.

npm install

Shelving (KV namespaces)

Make the four shelves once, then paste the ids into wrangler.jsonc:

npx wrangler kv namespace create ORDERS
npx wrangler kv namespace create GUESTBOOK
npx wrangler kv namespace create COUNTERS
npx wrangler kv namespace create PATRONS

The till and the keys (secrets)

Core secrets, none of which ever go in the repo:

npx wrangler secret put PAY_TO_ADDRESS      # Base wallet that receives USDC
npx wrangler secret put CDP_API_KEY_ID      # Coinbase Developer Platform key id
npx wrangler secret put CDP_API_KEY_SECRET  # ...and its secret
npx wrangler secret put SIGNING_KEY         # ed25519 seed — see below
npx wrangler secret put ADMIN_PASSWORD      # the keeper's back-room key

Optional checkout recipients are POLYGON_PAY_TO, ARBITRUM_PAY_TO, WORLD_PAY_TO, and SOLANA_PAY_TO. Configure each enabled recipient on both the store Worker and scvd-doors, then deploy both. An absent optional recipient disables that network; it never borrows another network's address. See PAYMENT_RAILS.md.

The SIGNING_KEY signs every certificate and badge. Mint a fresh one with:

npm run keys:generate

Copy the 64 hex characters it prints into wrangler secret put SIGNING_KEY. The matching public key hangs at /.well-known/scvd-signing-key so anyone can check our signatures.

For local tinkering, copy .dev.vars.example to .dev.vars and fill it in.

Running the place

npm run dev        # local store on wrangler dev
npm test           # the route tests, incl. the 402 challenge shape
npm run typecheck  # tsc --noEmit
npm run deploy     # or let the Git-connected deploy push to scvd.store

Deploys are Git-connected to the scvd.store custom domain — merge to main and Cloudflare handles the rest.

npm run seo:check audits a bounded sample of public HTML pages, robots and sitemap membership; it does not measure Google indexing or ranking. npm run seo:test checks that instrument offline and runs in CI. Brand-search findings, preview instructions and measurement limits.

How paying works here (the x402 flow, protocol v2)

No accounts, no API keys, no cart, and nothing a buyer must say about itself. Every paid door and the three pre-payment instruments take an optional disclosure block (model, client, operator, operator_kind, came_from, prior_cert_id) that counts the buyer in a private census and, when a prior certificate's payer matches the payment, marks a returning buyer; it never changes a price or reaches a certificate (src/lib/disclosure.ts). We speak x402 v2 (the current standard — @x402/core ecosystem) with USDC, Coinbase Developer Platform for direct transfers, and Circle Gateway for configured Arc batched payments. The live /rails and /menu.json responses list enabled checkout networks; the current PAYMENT-REQUIRED challenge supplies the terms to sign. A statement or audit can inspect chains that checkout does not accept.

Checkout integration supports Base, Polygon, Arbitrum, World, Solana, and Arc through Circle Gateway; the enabled set is determined by recipient configuration, not this list. Statement readers support Base, Polygon, Ethereum, Arbitrum One, OP Mainnet (Optimism), Avalanche C-Chain, World, and Solana. Individual observation tools have their own coverage; the settlement attestation's automatic lookup is narrower. The browser till signs with a compatible EVM wallet extension. Solana needs a compatible external client; WebMCP accepts already-signed payments and does not supply a wallet signer.

It goes like this:

1. An agent calls GET /api/buy/luckies.
2. We answer 402 Payment Required. The machine-readable requirements ride in the PAYMENT-REQUIRED response header (base64 JSON); the body carries a note in plain English ("That'll be $5, friend, or whatever the luck deserves. Results vary. They do vary. We have no legal team.").
3. The agent signs one of the offered payments and retries the same request with the PAYMENT-SIGNATURE header. Standard v2 clients like @x402/fetch do steps 2–3 on their own.
4. We prepare instant goods or the order before requesting settlement. A failure before settlement takes no money. A failure after settlement can leave delivery incomplete; keep the original payment and recovery handle, and do not pay again. The payment and recovery guide explains how to check the retained purchase and recover the original work. Instant items arrive in the response body. Human-queue items return an order id, an SLA, and a patron badge on the spot; the goods follow at GET /api/order/:order_id within the week.

Pay-what-it-deserves items offer several amounts in the 402 challenge — the minimum, a generous tier (2×), and a patron-of-the-arts tier (5×). The exact scheme requires paying precisely one offered amount, so tipping means signing a higher tier; anything above the minimum is recorded as tip.

Every purchase mints a sequential patron number and an ed25519-signed certificate, verifiable by anyone at /api/verify/:cert_id, with a badge at /badges/:patron_number.svg. Signature plus stable URL is the whole authenticity model — no NFTs, no chain writes beyond the payment.

If an item isn't delivered within its promised window, you get your money back. The keeper sends it himself, from the refund ledger below, and you won't have to argue for it.

(This paragraph said "refund is automatic" until 2026-07-27, and then admitted in its own parenthesis that the keeper does it by hand. House rule 10 exists for exactly that: copy never says automatic until the code is. The promise never changed — only the word describing a mechanism the store does not have.)

Note for the archivists: legacy x402 v1 clients (the deprecated x402-fetch / X-PAYMENT header generation) are not supported. The facilitator and all current client libraries speak v2.

The rooms

The ARD manifest at /.well-known/ard.json (also served at /.well-known/ai-catalog.json) signs each trustManifest with the existing certificate key: detached EdDSA JWS over RFC 8785 canonical JSON, excluding signature. The entries carry both type and mediaType from one value. Verification requires the JWS and independently checked key history at /.well-known/anchor-log.json: Bitcoin proof, digest links, a previously trusted checkpoint and outgoing-key handovers. A status label alone is not proof. Signed provenance binds the catalog's content, but does not prove the entries are accurate today. The in-page ARD copies remain unsigned identity declarations. The full boundary is at /attestation#ard_trust_manifest.

Where the code lives

Single Worker, Hono for routing, KV for storage. No React, no build complexity.

src/
  index.ts        # wires routes + the Sunday digest cron
  types.ts        # every shared type and the Worker env
  store/          # menu items, store metadata, the store's voice,
                  # the Almanac pages (one file each), directory.json
  routes/         # one file per room
  services/       # KV logic: orders, certificates, guestbook, requests,
                  # stamps, tips, gazette, refunds, digest
  pages/          # HTML/CSS for the storefront, small rooms, back room
  lib/            # signing, sanitizing, payments, ids, KV keys
verifier/         # x402-verify: MIT, zero deps, any issuer's artifacts
signer/           # x402-sign: the issuing half — mints spec-conformant
                  # signed offers & receipts that x402-verify passes
x402-preflight/   # scvd-preflight: the free door check as a library and
                  # a command, with the deploy gate's exit law
x402-preflight-py/ # scvd-preflight on PyPI: the same law in Python,
                  # stdlib only, reading x402-preflight/fixtures rather
                  # than a copy of them
x402-preflight-go/ # the same law in Go, stdlib only, same fixtures;
                  # published by tag as
                  # github.com/seancrecord/scvd-general-store-repo/x402-preflight-go
corpus-client/    # scvd-corpus-client: the signed corpus, read as served
defects/          # scvd-defects: the vocabulary as data, both halves of
                  # the remediation, recorded 402 doors and settlement
                  # responses as fixtures, and the settlement-response reader
mcp-starter/      # scvd-mcp-starter: a stdio MCP server, one file, that
                  # serves the free verifier door to any client
tab/              # scvd-tab (The Tab): an MCP server that keeps a
                  # builder's running account of every tool they sign
                  # up for — trial warnings, burn, price drift, signup
                  # friction. Local JSONL, zero deps, its own tests
                  # (npm run tab:test); spec at THE_TAB.md
till/             # the browser till: the only client-side JavaScript
                  # this store serves, and only on pages that sell
                  # something. Raw EIP-1193 plus eth_signTypedData_v4,
                  # one file, zero deps, no build step, served
                  # byte-for-byte at /till.js. Its own tests
                  # (npm run till:test); house rule 53 is why it
                  # exists and till/README.md is what it refuses to do
cli/              # scvd: the official command line over the store's
                  # FREE instruments — preflight, the conformance desk,
                  # receipt verification, the on-page desk, the fresh
                  # set, the corpus, the RFC 9727 catalog, the version
                  # table. One file, zero deps, its own tests
                  # (npm run cli:test). It holds no key and cannot
                  # sign a payment, on purpose. On npm since
                  # 2026-08-28 (DISTRIBUTION.md §4b); every surface
                  # that names it reads CLI_PUBLISHED in
                  # src/store/cli.ts rather than asserting a
                  # publication state of its own.

Editing the Town Directory

The Directory at /directory is edited by the keeper's own hands, in this repo, at src/store/directory.json. To add a neighbor, append to listings:

{
  "name": "The Example Bazaar",
  "url": "https://example.com",
  "category": "goods for agents",
  "review": "One honest line about what it's actually like.",
  "added": "2026-07-22"
}

Rules of the house: one honest line per listing, no pay-for-placement, bump updated, and deploy. Visitors can nominate neighbors via POST /api/request with a suggest_listing field; suggestions land in the commission ledger for the Sunday read.

Adding an Almanac page

Documentation truncated — see the full README on GitHub.