offsets__buy_offset_budget
Retire the maximum cheapest verified carbon offsets within a fixed budget. Never overspends; idempotent; dry_run previews without mutation.
Instructions
[offsets — verified-credit carbon offset clearinghouse] Money-denominated offset purchase: retire the maximum cheapest-first verified mass whose exact cost fits inside budget_minor (never overspends). Built for callers whose restoration obligation is a currency amount — e.g. a revenue share accrued in a ledger. Idempotent on purchase_id; dry_run=true previews without mutating.
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": {
"buyer": "<buyer>",
"purchase_id": "<purchase_id>",
"budget_minor": "<budget_minor>"
},
"name": "offsets__buy_offset_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buyer | Yes | ||
| dry_run | No | ||
| purchase_id | Yes | ||
| budget_minor | Yes |