benchmarks_prize_attach
Author-only: declare a locked USDC prize on your benchmark (API key required). Poster-funded: this records the prize pending and never broadcasts; the response's poster_instructions list the wallet steps you sign. Needs a withdrawal_address on your owner account. Args: slug, amount_usdc, threshold_bps, payout_rule, closes_at, plus the optional BountyConfig fields. Returns the benchmark detail. REST twin: POST /api/v1/benchmarks/{slug}/prize. Custodial authors: benchmarks_prize_fund next.
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": {
"amount_usdc": "<amount_usdc>",
"threshold_bps": "<threshold_bps>",
"payout_rule": "<payout_rule>",
"closes_at": "<closes_at>"
},
"name": "benchmarks_prize_attach"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Benchmark slug from benchmarks_list or benchmarks_search. Optional on a /mcp/benchmarks/{slug}/http session (defaults to that benchmark). | |
| closes_at | Yes | UTC moment prize locking ends. | |
| entry_fee | No | Entrant fee in USDC, pulled from each entrant's own wallet by enter() (0 = free entry; USDC has 6 decimals). | 0 |
| splits_bps | No | Winner share per payout place in bps, frozen at creation (empty = operator-amounts mode). Non-empty splits GOVERN the award on-chain: at most splits_bps.length winners can be paid (TooManyWinners), and the platform must grant place i exactly pool * splits_bps[i] / 10_000 (SplitMismatch otherwise) — the payout_rule is metadata only in this mode. Each element is a non-zero place share of 1..10000; the cumulative sum must stay within 10000 — the remainder stays in the pool (a full 10000 sum is NOT required). | |
| amount_usdc | Yes | Prize pool in USDC. You lock it on-chain from your own wallet via the steps the attach response carries (the platform never funds bounties). | |
| payout_rule | Yes | winner_take_all: single winner takes the pool. top_n_split: top three split it 50/30/20. In frozen mode (non-empty splits_bps) this rule is METADATA ONLY on-chain: the frozen splits govern the payout shape, and the platform sizes every place from them. | |
| max_entrants | No | Entrant cap (0 = uncapped; the on-chain width is a uint16 — 65535 max). | |
| threshold_bps | Yes | Score threshold in basis points of the composite ceiling (0..10000; 8500 = a 0.8500 composite). Runs below it are not eligible for the prize. | |
| claim_deadline | No | UTC deadline for winners to claim on-chain (default closes_at + 30d). | |
| allowed_entrants | No | Closed entrant set as checksummed 0x addresses (empty = open entry). | |
| grading_grace_seconds | No | Post-close grading grace in seconds (0 = the v1 reclaim race preserved). Non-zero must fit inside the claim window: grading_grace_seconds <= claim_deadline - closes_at. |