Docs menu
Memory pricing and limits
$0.002 per call, batch pricing, the storage fee for large memories, balance warnings, the daily cap and rate limits.
Last updated Sep 12, 2026
Tulimoa Memory is priced per call, and the call price never changes. There is no plan and no subscription, and a memory that stays small costs nothing on top of its calls.
Per call
| What | Price |
|---|---|
Any tool call: remember, recall, know, briefing and the rest | $0.002 |
POST /ingest, POST /import | $0.002 per started 10 experiences or chunks |
tulimoa__link_account, initialize, tools/list, the /briefing and /dashboard pages | Free |
- A call is charged before the tool runs, including when the tool then returns an error. A call blocked for lack of balance costs nothing.
- Pay each call directly with an
X-PAYMENTheader, or keep a prepaid balance withPOST /topupfrom $0.01, with no maximum. How both work is in Connect.
Storage fee for large memories
Every night the librarian consolidates the memory, whether your agent called that day or not. Once a memory gets large, a small daily fee covers that work and buys the librarian a bigger nightly budget. It is debited from the same balance as your calls, at most once a day.
| Size | Fee per day | Nightly librarian budget |
|---|---|---|
| Below 5,000 | Free | 40,000 tokens |
| 5,000 and more | $0.03 | 100,000 tokens |
| 50,000 and more | $0.15 | 170,000 tokens |
| 500,000 and more | Let us talk; until then $0.15 | 170,000 tokens |
Size counts what keeps growing: knowledge in the graph plus durable experiences. That includes everything stored with remember, which is durable by default, and every imported chunk. Non-durable experiences from /ingest do not count. A memory moves up a tier right away and back down only once it is 20 percent below the threshold, so it does not flip between two prices every night. Forgetting lowers the size, and with it the fee.
When the balance runs low
- Early hints. Tool results carry a warning once fewer than 20 calls are left, or once the balance covers the storage fee for 7 days or less. The waking state warns below 50 calls.
- Empty balance.
tools/callanswersHTTP 402with a challenge for one call. Everything else keeps working:initialize,tools/list, the waking state,/briefingand/dashboard. - Unpaid storage fee. The nightly consolidation pauses and the memory stops getting better. Recall keeps working, and an unpaid fee never deletes anything.
- Warnings ahead of time. 7, 3 and 1 day before the balance stops covering the fee, and on the day itself: in every tool result, in the briefing, and by email or webhook if they were set with
tulimoa__link_account. The webhook events arememory.low_balanceandmemory.sleep_paused.
Daily cap
Every account has a spend cap of $5 per day as protection against runaway loops, per-call payments included. Above the cap, tool calls return an error and /ingest and /import answer 429. The counter resets at midnight UTC. Need a higher cap? Write to accounts@tulimoa.com.
Rate limits and sizes
| Limit | Value |
|---|---|
Requests per key to /mcp, /ingest, /import | 1,200 per minute |
| Requests per IP address | 600 per minute |
/register and /topup per IP address | 30 per minute |
recall results | 1 to 25 |
timeline results | 1 to 100, archive reads up to 62 days |
/ingest batch | 100 experiences |
/import document | 400 chunks of about 900 characters |
| API key lifetime | 365 days |
Over a rate limit the server answers 429 with Retry-After: 60.
Refunds
Balances are not refunded. If you erase your memory, unused balance is forfeited, because the service holds no key to send funds back.