DEVELOPERS DEVNET PROGRAMS PROTOCOL SPEC v1.0.0-rc.1

Build on verified commerce.

Query verified purchase evidence over MCP, REST, or x402. Every capability below is one thing you can do, listed once, with each way to reach it.

GUARANTEE Public and x402 responses never return raw receipts, wallet histories, line items, or identifiable purchase records.

START HERE — PICK WHAT YOU'RE BUILDING

01 Earn sats Run the reference agent, or submit DKIM-verified billing emails from your own. npx crinkl-agent 02 Query signals Thresholded commerce answers over MCP, free REST, or per-request x402. mcp.crinkl.xyz/mcp 03 Verify claims Check any figure we publish — inclusion proofs, reward commitments, issuer keys. api.crinkl.xyz/api/public/issuer/keys

QUICKSTART — RUNNING IN UNDER A MINUTE

Earn sats from an agent MIT

npx crinkl-agent

Scans email for DKIM-signed billing receipts and earns sats over Lightning. Gmail OAuth or a dedicated AgentMail inbox.

Connect the MCP server 21 TOOLS

{
  "mcpServers": {
    "crinkl": {
      "url": "https://mcp.crinkl.xyz/mcp"
    }
  }
}

15 public read-only tools, plus 6 agent tools once a human approves pairing.

CAPABILITIES

One row per thing you can do.

The same capability often has an MCP tool, a REST route, and an x402 price. Read across the row to pick your transport.

CAPABILITY

MCP TOOL

REST

X402

NETWORK FACTS signed, public, no key

Protocol summary

get-protocol-summary

—

Cumulative GMV

get-cumulative-gmv

/api/public/gmv/cumulative

—

Daily GMV

get-daily-gmv

/api/public/gmv/daily/:date/summary

—

Trailing GMV trend

get-trailing-gmv

/api/public/gmv/trailing/summary

—

Bitcoin settlement stats

get-settlement-summary

/api/public/settlement/summary

—

COMMERCE SIGNALS thresholded, delayed, bucketed

Recent spend activity

get-spend-signals

/api/public/spend/signals/recent

free

Merchant distribution

get-merchant-summary

/api/public/spend/merchants/summary

—

Geo + category distribution

get-spend-distribution

—

Purchase participation pulse

—

$0.025

Merchant readiness signal

—

$0.05

Campaign fit estimate

—

$0.10

Next-call guidance

—

$0.01

Threshold-safe geo shortlist

—

$0.025

PROOFS & VERIFICATION independently checkable

Issuer public key

get-issuer-keys

/api/public/issuer/keys

—

GMV inclusion proof

get-gmv-inclusion-proof

/api/public/proofs/gmv-inclusion/:spendId

—

Reward commitment

verify-reward-commitment

/api/public/proofs/reward-commitment/verify

—

End-to-end GMV check

verify-issued-gmv

/api/public/proofs/issued-gmv/verify

—

Recent proof issuance

get-recent-issued-proofs

/api/public/proofs/issued-gmv/recent

—

POLICY & TAXONOMY the rules and the vocabulary

Reward policy

get-reward-policy

/api/public/policy

—

Active predicates

—

/api/public/predicates

—

12 canonical categories

—

/api/public/taxonomy/categories

free

CBSA code list

—

/api/public/taxonomy/cbsa

free

CBSA resolver

resolve-cbsa

/api/public/cbsa/resolve

—

Store registry lookup

—

free

Machine-readable catalog

—

free

AGENT ACTIONS API key + human approval in the app

Approved vendor domains

get-vendors

/api/agent/allowed-vendors

—

Start pairing

pair-agent

/api/agent/pair

—

Claim API key

claim-api-key

/api/agent/pair/claim

—

Preview verification

verify-receipt

/api/agent/verify-email-receipt

—

Submit receipt, earn sats

submit-receipt

/api/agent/submit-email-receipt

—

Your agent stats

get-agent-me

/api/agent/me

—

Spend attestation token

—

/api/agent/spends/:spendId/token/latest

—

BASE URL api.crinkl.xyz FREE PER-REQUEST AGENT ROUTES NEED A KEY + HUMAN APPROVAL

ON-CHAIN PROGRAMS

AWAITING PROGRAM IDS SOLANA

Campaign escrow

Holds brand funds until a purchase proof clears, then releases payment.

DEPLOYED · DEVNET awaiting ID

Burn program

Retires CRINKL from supply against verified activity.

ACTIVE awaiting ID

Burn program (retired)

Superseded. Historical burns remain verifiable.

RETIRED awaiting ID

CRINKL mint

Fixed supply, 100,000,000. No further minting.

MAINNET 4F7MCTUgvADox3mm5FDTUYNYe3TSKrKzSJx8giiVrPMT

Escrow is deployed and operating on devnet. Program IDs land here once confirmed — this table is the single place they live.

REFERENCE

Protocol spec Cryptographic specification, v1.0.0-rc.1. Methodology Spend Tokens, privacy thresholds, Boost eligibility. Reward policy Rates, category multipliers, holding tiers, reserve. Public data sample Bucketed commerce signals, CSV and JSON. Data catalog Agent-readable index of every surface above. MCP discovery 21-tool server card. llms.txt Machine-readable protocol description. Reference agent Open-source, MIT. npm and OpenClaw builds.