# Memoshelf

> Your agents forget everything between runs. Memoshelf is where they write it down: memory, a run log you can read, and page reading. One account.

Memoshelf is not a crawler. Keys mint with the ms_ prefix. Budget writes against X-Memoshelf-Quota-Remaining and X-Memoshelf-Quota-Reset on every keyed response.

## Endpoints

- [Health](/health): liveness, version, dataSource, degraded
- [OpenAPI](/openapi.json): machine-readable API spec
- [MCP](/mcp): Streamable HTTP MCP. POST with a key or Connect token. GET without credentials is 401. DELETE is 405
- [Runs](/v1/runs): run log (keyed writes). Accepted query: limit, cursor, q, max_chars, status, tag, tags, lane, since, until, stale. Unknown keys return warnings.
- [Notes](/v1/notes): markdown notes (keyed writes). Accepted query: limit, cursor, q, max_chars, tag, tags, lane, since, until. Unknown keys return warnings.
- [Fetch markdown](/v1/md): public URL to markdown (keyed)
- [Keys](/v1/keys): mint and revoke (keyed)
- [Usage](/v1/usage): this period plus last 30 days (keyed)
- [Export](/v1/export): owner bundle (keyed)
- [What happened last](/v1/what_happened_last?lane=<name>): THE read call — last N runs and recent notes for that lane (keyed). Accepted: lane, tags, project, routine, n, max_chars, cursor. Unknown query keys return warnings.
- [Pricing](/pricing.json): plans table, application/json
- [llms.txt](/llms.txt): this file
- [Docs](/quickstart#developers): documentation
- [Playbooks](/playbooks.md): how to set up memory that sticks — short Q&A with instructions to read, one fetch
- [Packs](/packs.md): rulebook packs — ready-made rules and notes you load into a workspace; the Starter pack is free
- [Articles](/articles): plain-words articles on giving your AI a notebook
- [Your AI forgot everything again. Here is the fix that survives a new chat.](/articles/ai-forgot-everything-again.md): Give your AI a notebook it reads before it answers.
- [Your two AIs don't know about each other. Give them one notebook.](/articles/two-ais-dont-know-about-each-other.md): Put both assistants on the same lane in a shared notebook and they read each other's notes.
- [Crew setup](/setup.md): one instruction sets up all your AIs: house rules, one key per AI, a welcome handoff each, and how to wire Wake so one AI starts another
- [Quickstart](/quickstart.md): first note across your stack, in six steps, from sign-in to a second app reading the pinned rule
- [Connect](/connect.md): add Memoshelf in each AI app, with a custom connector or an API key; each AI gets its own lane
- [Bring your webhook](/connect/webhook.md): what a wake sends to your own https endpoint, how to check the signature, and what to answer
- [Help](/help.md): fixes for common problems, each with a note to paste into your AI; quick answers on accounts, lanes, rules files, export and stale work
- [Security](/security): what we do and do not claim
- [Terms](/terms): terms of use
- [Privacy](/privacy): privacy policy

## Signing up without a browser

POST /v1/signup with {"email"} creates a free workspace, then emails the claim link. The key is made on the account page after confirming.