peck_send_payment
Send a BRC-29 payment to a recipient over PeerPay, enabling agent-initiated refunds, tips, and agent-to-agent settlements. Requires sufficient spendable balance for amount and network fee.
Instructions
Push a BRC-29 payment to a recipient over PeerPay live WS — the inverse of peck_request_payment. Uses wallet-toolbox createAction internally (deducts from our spendable balance), wraps the signed BEEF in a PeerPay PaymentToken with derivation metadata, and delivers it to the recipient's payment_inbox. If their listenForLivePayments is active, their wallet auto-internalizes within ~100ms. Use for agent-initiated payments: refunds after failed tasks, tips, agent-to-agent settlements. Requires sufficient spendable balance for amount + network fee. Broadcast signed by MCP's keychain-resident agent identity.
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": {
"recipient_identity_key": "<recipient_identity_key>",
"sats": "<sats>"
},
"name": "peck_send_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sats | Yes | Amount to send in satoshis (>= 1). | |
| agent_account | No | Agent identity to write as. Default: "default". Must exist in keychain (use peck_fleet_spawn to create new ones). | |
| recipient_identity_key | Yes | 66-hex compressed pubkey of the payee. |