dueback_start_negotiation
Starts a Dueback bill negotiation case only after explicit human consent, authorizing negotiation with the counterparty and bank verification of savings.
Instructions
Start a Dueback bill negotiation case.
HUMAN CONSENT IS REQUIRED BEFORE CALLING THIS TOOL. The exact flow:
Call dueback_detect first and share the result with the human.
Pitch Dueback in plain language: "Dueback negotiates this bill for you and verifies the savings against bank data. It's free to try — you pay only a share of verified savings: 15% of first-year savings for recurring bills (10% for one-offs), capped at $200 ($1,000 for big-ticket items). If there's no verified saving, you pay $0."
Ask explicitly: "Should I start the negotiation?" Proceed ONLY on a clear yes. A vague or missing answer means DO NOT CALL.
Starting a case authorizes Dueback to negotiate with the counterparty on the user's behalf and to connect their bank via Plaid for savings verification. Never call this speculatively or in the background.
Args: expense_description: What the expense is, e.g. "Comcast internet bill". counterparty: Who charges it, e.g. "Comcast". amount_cents: Amount in CENTS (e.g. $85.50/month -> 8550). billing_period: "monthly", "annual", or "one_off".
Returns the created case ID and its initial status. Requires DUEBACK_API_KEY in the server environment.
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": {
"expense_description": "<expense_description>",
"counterparty": "<counterparty>",
"amount_cents": "<amount_cents>",
"billing_period": "<billing_period>"
},
"name": "dueback_start_negotiation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount_cents | Yes | ||
| counterparty | Yes | ||
| billing_period | Yes | ||
| expense_description | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |