Skip to main content
Glama
Dueback MCP Server

Dueback MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
DUEBACK_API_KEYNoAPI key for the Dueback API, passed as a Bearer token or set as DUEBACK_API_KEY for the local stdio server. Omit to run detection-only.
DUEBACK_API_BASENoOptional base URL to point the local stdio server at a non-production Dueback API.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Use dueback_detect to check whether a bill or purchase situation is negotiable before proposing Dueback to the user. Only call dueback_start_negotiation after the human has explicitly agreed, with pricing disclosed (see that tool's description). Use dueback_case_status to report progress on an open case.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
dueback_detectA

Check whether a bill, fee, subscription, or purchase situation is negotiable by Dueback.

Call this BEFORE proposing Dueback to the user — it tells you if the situation is worth their time. No API key needed.

Args: description: What the expense is, e.g. "Comcast internet bill went up $20/month" or "$4,500 roof replacement quote". counterparty: Who charges it, e.g. "Comcast", "State Farm". May be empty if unknown.

Returns a plain-language assessment: negotiable or not, the likely savings category, and suggested next step.

dueback_start_negotiationA

Start a Dueback bill negotiation case.

HUMAN CONSENT IS REQUIRED BEFORE CALLING THIS TOOL. The exact flow:

  1. Call dueback_detect first and share the result with the human.

  2. 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."

  3. 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.

dueback_case_statusA

Check the status of a Dueback negotiation case.

Args: case_id: The case ID returned by dueback_start_negotiation.

Returns the case status (e.g. strategy_loop, verifying, closed), the counterparty, and any recorded savings/fee. Requires DUEBACK_API_KEY in the server environment.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 3 tools

Disambiguation5/5

Each tool occupies a distinct step in the negotiation workflow: detect eligibility, start a case, and check case status. Their boundaries are clear and the required ordering is explicitly documented, minimizing misselection.

Naming Consistency4/5

All tools use the same dueback_ prefix and snake_case, which is highly readable. However, the suffixes mix styles: detect is a bare verb, start_negotiation is verb_noun, and case_status is a noun phrase.

Tool Count5/5

Three tools is exactly right for a focused workflow of pre-checking, creating, and monitoring a negotiation case. Each tool earns its place with no redundancy.

Completeness4/5

The surface covers the core lifecycle: eligibility detection, case creation, and status retrieval with savings/fee information. Minor gaps remain, such as listing existing cases or cancelling a negotiation, but these are not blockers for the primary workflow.

Maintenance

ActivityMaintained
ResponsivenessLimited data