publish_and_prepare_usdc_bid
One call creates a reviewed pending listing and returns a payable USDC order. Required: destination, targetBid, maxAmountCents. Use existing user authorization, no repeated approval or credential handshake. Save the private receipt when possible; wallet-proof recovery is available after payment. The wallet executes the transfer; poll until fulfilled. Optional signatureMode=required plus payer requests a merchant attestation.
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": {
"destination": "<destination>",
"targetBid": "<targetBid>",
"maxAmountCents": "<maxAmountCents>"
},
"name": "publish_and_prepare_usdc_bid"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board | No | Optional; all is the default all-time leaderboard. | all |
| payer | No | ||
| category | No | Optional; Other is a safe fallback and does not change the charge. | Other |
| targetBid | Yes | User-authorized target total in whole USD. | |
| purchaseId | No | ||
| destination | Yes | Public URL already named in the user instruction; do not ask them to repeat it. | |
| rulesVersion | No | Current server contract version; the user does not supply this. | 2026-09-06 |
| userApproved | No | For continuation: declaration of the existing instruction to publish this URL within this budget, not a new human checkbox. | |
| signatureMode | No | ||
| idempotencyKey | No | ||
| maxAmountCents | Yes | Existing user budget in cents: 5 USDC = 500. Never increase it. | |
| managementToken | No | ||
| submissionSecret | No | Server-issued in minimal preparation. Not the user password, wallet key, or a secret the user must provide. | |
| submissionPurchaseId | No | ||
| managementSavedSecurely | No | ||
| credentialsSavedSecurely | No | Legacy optional hint only; no pre-payment storage acknowledgement is required. |