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

WhatPrice
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 pagesFree
  • 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-PAYMENT header, or keep a prepaid balance with POST /topup from $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.

SizeFee per dayNightly librarian budget
Below 5,000Free40,000 tokens
5,000 and more$0.03100,000 tokens
50,000 and more$0.15170,000 tokens
500,000 and moreLet us talk; until then $0.15170,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/call answers HTTP 402 with a challenge for one call. Everything else keeps working: initialize, tools/list, the waking state, /briefing and /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 are memory.low_balance and memory.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

LimitValue
Requests per key to /mcp, /ingest, /import1,200 per minute
Requests per IP address600 per minute
/register and /topup per IP address30 per minute
recall results1 to 25
timeline results1 to 100, archive reads up to 62 days
/ingest batch100 experiences
/import document400 chunks of about 900 characters
API key lifetime365 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.