Limits and credits
Everything the server enforces, and why. These are checked server-side: they are not instructions to the model.
Plan gating
| Plan | MCP | Behavior |
|---|---|---|
| Free | No | get_account answers with an upgrade link; other tools return a plan error. |
| Starter | No | Same. Starter does not include API or MCP access. |
| Pro | Yes | 60 calls per minute, 5,000 per day. |
| Ultra | Yes | 180 calls per minute, 20,000 per day. |
Rate limits
Limits are per workspace, not per key, and they are shared across every connected client. A limited call returns a tool error with code 4029 that names the ceiling, so the assistant can back off instead of hammering.
Sending guards
These sit on top of the rate limit and exist so an agent loop cannot burn a sending domain.
create_campaign: 10 per hour.send_reply: 30 per hour.- The two budgets are independent: exhausting one does not block the other.
delete_listrefuses to run withoutconfirm: true.
Per-call ceilings
| Tool | Ceiling | Why |
|---|---|---|
search_b2b_leads | 100 rows | Keeps one call from flooding the context and the credit meter. |
get_list_leads, scrape_job_leads | 200 rows | Page with offset for more. |
export_list_csv | 1,000 rows | Larger exports belong in the dashboard. |
add_leads_to_list | 500 rows | Split larger batches; the error says so. |
get_inbox | 50 messages | Triage in pages rather than dumping the mailbox. |
suppression (add) | 200 addresses | Bulk suppression belongs in the app. |
Credit costs
MCP has no separate currency. Calls spend the same monthly allowances the dashboard spends, so connecting an assistant does not add a line to your bill.
| Tool | Spends | How much |
|---|---|---|
search_b2b_leads | B2B credits | 1 per row returned |
find_email, enrich_lead | Scrape credits | 1 per call |
scrape_leads_start | Scrape credits | 1 per lead found, trimmed to what is left |
create_campaign | Email allowance | 1 per email as the worker sends it |
send_reply | Email allowance | 1 per reply |
| Everything else | Nothing | Reads and state changes are free |
get_account is free and returns remaining credits per bucket. A well-behaved agent calls it first and sizes the work to what is left.Audit trail
Every call is recorded with the tool, the client name, the status, credits spent and the duration. Read it in Settings, MCP, or pull it from GET /api/mcp/audit with your normal session. Rolled-up daily counts power the usage chart.