rivomiCredits
What spends credits, what is free, how to price work before paying for it, and how retries are protected.
A credit is one person enriched or one AI judgement (a score, a draft, a brief). Reading data is free. Sending on LinkedIn uses the sender's daily allowance, not credits.
The four tools that spend
Each description starts with $ and states its unit cost and the case where nothing is charged.
| Tool | Charged for | Free case |
|---|---|---|
rivomi_run_agent_now (and set_agent_state → live) | Each profile actually looked at | A run that finds nobody new costs only its searches. A second call while a run is going returns the run already in flight. |
rivomi_process_list | Each profile fetched, each person scored or drafted | People already enriched are skipped unless rescore is set, so a second pass costs a fraction of the first |
rivomi_import_prospects | Each engager actually pulled | estimate_only: true prices the post and imports nothing |
rivomi_research_prospect | A fraction of a credit per person | None. Charged whether or not the brief says anything new. |
Before spending
- Call
rivomi_get_workspace. Ifplan.spend_blockedistrue,spend_blocked_reasonsays which limit is hit, and nothing more will be spent until it resets. - For an import, call it with
estimate_only: trueand show the user the price. - State the planned
$calls to the user before making them.
After spending, rivomi_get_run on the run returns what it actually cost, line by line.
Retries
A retried call spends nothing twice:
- MCP: the server derives an idempotency key from the JSON-RPC request id and the arguments. A host that retries a timed-out call with the same id gets the first result back.
- REST: send an
Idempotency-Keyheader. See REST API.
Keys live 24 hours.
Limits
Plans cap credits and prospects per month, a daily provider spend, the number of agents, senders
and signals watched, and the largest import. rivomi_get_workspace.plan.limits and plan.used
give the current values. Going over one returns 402 naming the limit. See
Errors and limits.