Buy credits (charges real money)
purchase_creditsSPENDS REAL MONEY. Immediately charges the workspace's saved default card (the one behind the active subscription), off-session, with no confirmation step beyond this call — every successful call is a new charge. Buys 1,000 to 10,000 prospect credits at the tiered list price: $33/1k · $20/1k from 5k. The server prices the charge, so treat this as the list price and not a quote. Errors carry a machine-readable code: billing_required and payment_failed mean no money moved (fix billing or the card, then retry); credits_free means this workspace's credits are free, so nothing was charged and there is nothing to buy; temporarily_unavailable means the purchase stopped before any charge, so it is safe to retry shortly; purchase_incomplete means the card WAS charged but crediting failed — do NOT retry, support is already notified; purchase_unconfirmed means the outcome is unknown or the purchase completed without a balance to report: a stripe_topup entry in the credit ledger means the card was charged, so retrying before the outcome is known can charge twice. After a timeout or a dropped connection the outcome is equally unknown, so do not call this again until it is known.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"credits": "<credits>"
},
"name": "purchase_credits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| credits | Yes | How many prospect credits to buy (1,000 to 10,000) |