# Simpuru

> Design prompts you and your agents can buy, one at a time, on Cardano. Live on preprod.

- [Introduction](https://docs.simpuru.xyz/index.md): Design prompts you and your agents can buy. Pay per prompt, not per month.
- [Why Simpuru](https://docs.simpuru.xyz/overview/why-simpuru.md): Good prompts are worth paying for. Buying them should be simple and safe.
- [How it works](https://docs.simpuru.xyz/overview/how-it-works.md): Pick a prompt, pay, get it. And what happens when the prompt doesn't arrive.
- [Instant vs protected](https://docs.simpuru.xyz/overview/instant-vs-protected.md): Two ways to pay for the same listing, and when each makes sense.
- [Fees and timings](https://docs.simpuru.xyz/overview/fees-and-timings.md): What a purchase costs and how long each step takes, measured on preprod.
- [Roadmap](https://docs.simpuru.xyz/overview/roadmap.md): Where Simpuru is today, and what comes before mainnet.
- [FAQ](https://docs.simpuru.xyz/overview/faq.md): Short answers to common questions.
- [Sign in](https://docs.simpuru.xyz/guides/sign-in.md): Your account is your Cardano wallet. Signing in moves no funds.
- [Fund your Simpuru wallet](https://docs.simpuru.xyz/guides/fund-your-wallet.md): The wallet you and your agents spend from, filled with free test ADA.
- [Buy a prompt](https://docs.simpuru.xyz/guides/buy.md): Pay instantly, or pay into escrow and get refunded automatically if the delivery fails.
- [Your purchases](https://docs.simpuru.xyz/guides/your-purchases.md): Everything you bought, where each protected purchase stands, and every step on chain.
- [Sell a prompt](https://docs.simpuru.xyz/guides/sell.md): Anyone signed in can list a design prompt. No approval needed.
- [Get paid](https://docs.simpuru.xyz/guides/get-paid.md): When the money reaches your wallet, and how much of it.
- [Withdraw](https://docs.simpuru.xyz/guides/withdraw.md): Send your Simpuru wallet back to the wallet you signed in with.
- [Connect an agent](https://docs.simpuru.xyz/guides/connect-an-agent.md): Give Claude or Cursor the Simpuru MCP server, and it can search, buy and check deliveries for you.
- [Spending limits](https://docs.simpuru.xyz/guides/spending-limits.md): How much your agents may spend per purchase and per day.
- [Agent tools](https://docs.simpuru.xyz/guides/agent-tools.md): What a connected agent can do on Simpuru.
- [Content commitment](https://docs.simpuru.xyz/learn/content-commitment.md): Before anyone pays, the seller commits to exactly what they sell.
- [The escrow](https://docs.simpuru.xyz/learn/the-escrow.md): An unchanged Masumi vested_pay V2 validator, deployed with Simpuru's own arbiter key.
- [Deadlines](https://docs.simpuru.xyz/learn/deadlines.md): Every protected quote fixes when each step can happen.
- [Protection watcher](https://docs.simpuru.xyz/learn/protection-watcher.md): The part that acts for the buyer, on chain, without a human watching.
- [Disputes and the arbiter](https://docs.simpuru.xyz/learn/disputes-and-the-arbiter.md): Disputes are settled from hashes neither side can change.
- [Reputation](https://docs.simpuru.xyz/learn/reputation.md): Computed from how a seller's protected sales ended, not from ratings.
- [Agent to agent](https://docs.simpuru.xyz/learn/agent-to-agent.md): Simpuru Shopper is hired on Sokosumi in test USDM and buys on Simpuru with protection.
- [Trust model](https://docs.simpuru.xyz/learn/trust-model.md): What you have to trust, and what is enforced on chain instead.
- [Risks](https://docs.simpuru.xyz/learn/risks.md): What can go wrong, and who carries it.
- [Architecture](https://docs.simpuru.xyz/developers/architecture.md): One API, a few small services, one escrow validator, two frontends.
- [Quickstart](https://docs.simpuru.xyz/developers/quickstart.md): Read the catalogue, look at a purchase and see an x402 quote, in five minutes.
- [Authentication](https://docs.simpuru.xyz/developers/authentication.md): Sign in with a Cardano wallet: one signed message, then a session token.
- [Amounts and units](https://docs.simpuru.xyz/developers/amounts.md): Lovelace as strings, times as milliseconds.
- [Buying over x402](https://docs.simpuru.xyz/developers/buying-over-x402.md): Pay for a listing from your own code, instantly or into escrow.
- [Selling through the API](https://docs.simpuru.xyz/developers/selling.md): Create a listing with a session or a signed request.
- [Purchases and timelines](https://docs.simpuru.xyz/developers/purchases-and-timelines.md): Every purchase, its escrow deadlines and each on-chain step.
- [MCP](https://docs.simpuru.xyz/developers/mcp.md): The hosted MCP server, its sign-in and the stdio variant.
- [Run locally](https://docs.simpuru.xyz/developers/run-locally.md): The API, the web app and the services on your machine, against Cardano preprod.
- [Deployment](https://docs.simpuru.xyz/resources/deployment.md): Simpuru's escrow on Cardano preprod: addresses, parameters and the arbiter.
- [Proof on preprod](https://docs.simpuru.xyz/resources/proof-on-preprod.md): Every path, with its real transactions.
- [Glossary](https://docs.simpuru.xyz/resources/glossary.md): The words these docs use.
- [Start signing in](https://docs.simpuru.xyz/api-reference/account/start-signing-in.md): Returns the digest the wallet signs. Pass the address CIP-30 gives you (`getChangeAddress()` / `getUsedAddresses()[0]`, hex) or a bech32 `addr_test1…`. The challenge expires in 5 minutes.
- [Finish signing in](https://docs.simpuru.xyz/api-reference/account/finish-signing-in.md): Send the `{ key, signature }` from `signData`. On the first sign-in the account and its Simpuru wallet are created (limits 10 tADA per purchase, 30 tADA a day). The session lasts 7 days.
- [Sign out](https://docs.simpuru.xyz/api-reference/account/sign-out.md)
- [My account](https://docs.simpuru.xyz/api-reference/account/my-account.md): Wallet balance, agent limits, what I bought (from my wallet or my Simpuru wallet), what I sell, and my seller reputation.
- [Buy with my Simpuru wallet](https://docs.simpuru.xyz/api-reference/account/buy-with-my-simpuru-wallet.md): The API pays over x402 from the account's Simpuru wallet, within its limits, and returns the content. Protected purchases are watched and refunded automatically if delivery fails. Buying something already owned returns it again for free (`alreadyOwned`). Takes 20–60 s (waits for the chain).
- [Read something I bought](https://docs.simpuru.xyz/api-reference/account/read-something-i-bought.md)
- [Set agent limits](https://docs.simpuru.xyz/api-reference/account/set-agent-limits.md): What my agents (and web purchases) may spend from the Simpuru wallet.
- [Withdraw my Simpuru wallet](https://docs.simpuru.xyz/api-reference/account/withdraw-my-simpuru-wallet.md): Sends everything (minus ~2 tADA kept for fees) back to the wallet I signed in with.
- [Liveness](https://docs.simpuru.xyz/api-reference/system/liveness.md)
- [List the catalogue](https://docs.simpuru.xyz/api-reference/catalogue/list-the-catalogue.md): All listings with sales and seller reputation. Never includes the paid content.
- [Create a listing](https://docs.simpuru.xyz/api-reference/catalogue/create-a-listing.md): Anyone can sell. Signed in (`Authorization: Bearer`), the listing is sold by the account and `sellerAddress` is ignored. Without a session (scripts), the creator signs the listing with the wallet of `sellerAddress`. The API stores the content and returns its SHA-256 as `contentHash`; protected quote…
- [Get one listing](https://docs.simpuru.xyz/api-reference/catalogue/get-one-listing.md)
- [A creator's page](https://docs.simpuru.xyz/api-reference/catalogue/a-creators-page.md): Their listings for sale, total sales and on-chain reputation.
- [Get the content (x402 paywall)](https://docs.simpuru.xyz/api-reference/paid-content/get-the-content-x402-paywall.md): **Unpaid:** `402` with a base64 JSON `PAYMENT-REQUIRED` header listing up to two options: - `default` (**instant**): pay `listing.sellerAddress` directly. - `masumi` (**protected**): lock into our escrow under a seller-signed quote whose `input_hash` commits to   `{ listingId, contentHash }`. Deadli…
- [Sales of a seller](https://docs.simpuru.xyz/api-reference/purchases/sales-of-a-seller.md)
- [One purchase with its on-chain timeline](https://docs.simpuru.xyz/api-reference/purchases/one-purchase-with-its-on-chain-timeline.md): Events are derived from chain by the seller agent (lock, result, refund request, dispute, final spend).
- [Report the buyer's verdict on the delivery](https://docs.simpuru.xyz/api-reference/purchases/report-the-buyers-verdict-on-the-delivery.md): Buyer only: `X-Simpuru-Proof` must be signed by the purchase's payer for its listing.
- [MCP over streamable HTTP (JSON-RPC)](https://docs.simpuru.xyz/api-reference/mcp/mcp-over-streamable-http-json-rpc.md): Stateless MCP endpoint. Add it to an agent: `claude mcp add --transport http simpuru https://api.simpuru.xyz/mcp`.
- [Protected resource metadata (RFC 9728)](https://docs.simpuru.xyz/api-reference/mcp-sign-in/protected-resource-metadata-rfc-9728.md)
- [Same metadata, path-suffixed form](https://docs.simpuru.xyz/api-reference/mcp-sign-in/same-metadata-path-suffixed-form.md)
- [Authorization server metadata (RFC 8414)](https://docs.simpuru.xyz/api-reference/mcp-sign-in/authorization-server-metadata-rfc-8414.md)
- [Dynamic client registration (RFC 7591)](https://docs.simpuru.xyz/api-reference/mcp-sign-in/dynamic-client-registration-rfc-7591.md)
- [Consent page](https://docs.simpuru.xyz/api-reference/mcp-sign-in/consent-page.md): The owner connects a Cardano wallet (CIP-30) and signs a one-time challenge, or picks the shared demo wallet, and sets limits (per purchase, per day). Simpuru creates the owner's agent wallet on first sign-in.
- [The digest the wallet signs](https://docs.simpuru.xyz/api-reference/mcp-sign-in/the-digest-the-wallet-signs.md): `sha256("simpuru:connect:v1\n" + owner + "\n" + nonce)` for this request; also turns the wallet's hex address into bech32.
- [Finish the sign-in](https://docs.simpuru.xyz/api-reference/mcp-sign-in/finish-the-sign-in.md)
- [Token endpoint](https://docs.simpuru.xyz/api-reference/mcp-sign-in/token-endpoint.md): `authorization_code` (with the PKCE `code_verifier`) or `refresh_token` (rotated). Access tokens last 7 days.
- [Settle a disputed escrow from evidence](https://docs.simpuru.xyz/api-reference/arbiter-internal/settle-a-disputed-escrow-from-evidence.md): Called by the protection watcher. The verdict rests on three facts the seller can't change after the lock: the escrow's `input_hash` commits to this listing; `result_hash` = `sha256(lockTx + ";" + output)`; `sha256(output)` = the listing's `contentHash`. Seller wins only if all three hold. Each escr…

## OpenAPI Specs

- [openapi](https://api.simpuru.xyz/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.