For developers
One open API with 1,085 operations — the same ones the office, the register, the command line and AI assistants use — with keys, dry runs, webhooks, an agent channel and MCP, documented at docs.almondtill.com.
← all decks1 / 13next →
One API, every surface
GraphQL over HTTPS: 1,085 operations — 395 reads and 690 writes — on one schema. The back office, the browser register, the command line and the AI assistants are consumers of it; nothing is screen-only.
← previous2 / 13next →
The reference, generated from the schema
132 record types rostered, each with its operations, its types and its errors on its own pages. The schema itself is served as a file, the errors are catalogued, and there is an index written for AI assistants.
the schema itself · the error catalogue · the index written for AI assistants
← previous3 / 13next →
Keys and sessions
An API key is minted by an owner with a scope written as rows — the service, the action, allow or disallow — and it expires on a date the owner chose. The secret shows once; your code exchanges it for a session token and never sends it again. People sign in to sessions; tills run on device sessions.
← previous4 / 13next →
Your first call and the envelope
Every request and answer carries a small envelope: the version you wrote against and the version that served you, the call's own id, what the call cost. Paging is a cursor grammar; errors come in one grammar with the retries named; the rate limits are documented, not discovered.
← previous5 / 13next →
Dry runs
A write can be rehearsed: every check runs, the write is rehearsed against your current records, and nothing is stored. Ask with one flag beside the version; the answer is what the real call would answer, marked as a rehearsal.
← previous6 / 13next →
Webhooks
Subscribe an https endpoint to the events you pick; every delivery is signed with a secret you hold, arrives at least once, and carries the record's id and revision — never its contents. Read the record back through the same API, so what your receiver stores is always the truth.
← previous7 / 13next →
The command line
1,085 operations, from the same registry — the command line is a consumer of the API like every other surface, so a script can do what the office does, and nothing is screen-only.
← previous8 / 13next →
AI assistants over MCP
17 tools and 6 resources and resource templates, read-first, with only the permissions the merchant assigns. The assistant signs in over OAuth as a person, or rides an API key; the merchant connects it with one press in the office, or one command in a coding agent.
← previous9 / 13next →
The agent channel
A buyer's AI agent can find your shop, search the catalog and complete a checkout over an open standard. Your side is a set of ordinary operations of this API: create the channel, publish it, pause and resume it, retire it.
← previous10 / 13next →
Search, feeds and exports
One word finds the records that carry it, every kind at once, only the kinds your key may read. A question becomes a plan you can read, run while you wait or as a job. Scheduled data feeds carry your records to a BI tool; the export is machine-readable and whole.
← previous11 / 13next →
What it costs to build on
The kernels meter: 100 million kernels are included inside the $15 a month the merchant already pays, and every call is metered and shown to them in their own ledger — the envelope on every answer says what the call cost.
← previous12 / 13next →
Next steps
Read the reference, mint a key with an owner, make the first call. Then apply with the merchant — no card, no fee.
← previous13 / 13notes →