Dueback MCP Server

Предоставьте любому AI-агенту с поддержкой MCP возможность вести переговоры по счетам от имени пользователя — с помощью Dueback.

Что такое Dueback: сервис ведёт переговоры по счетам, комиссиям, подпискам и покупкам. Dueback договаривается с поставщиком, а затем проверяет каждую сэкономленную сумму по банковским данным пользователя. Сервис можно попробовать бесплатно: пользователь платит только долю от подтверждённой экономии. Если подтверждённой экономии нет, плата составляет 0 долларов.

Использование Dueback регулируется Условиями обслуживания и Политикой конфиденциальности — см. раздел «Юридическая информация» ниже.

Подключение к удалённому серверу

Размещённый сервер Dueback MCP — самый быстрый способ подключения: устанавливать его локально не нужно.

Endpoint: https://api.dueback.co/mcp/
Транспорт: Streamable HTTP
Аутентификация: OAuth 2.1 с динамической регистрацией клиента. Клиенты с поддержкой OAuth (Claude, ChatGPT, VS Code и другие) подключаются без API key: клиент регистрируется автоматически, а пользователь подтверждает доступ. Для клиентов, которым нужен API key, также подойдёт ключ (см. ниже).

Пример конфигурации клиента:

{
  "mcpServers": {
    "dueback": {
      "url": "https://api.dueback.co/mcp/"
    }
  }
}

Установка в один клик:

Если вы предпочитаете запустить локальный сервер через stdio, см. раздел «Локальный сервер (stdio)» ниже.

Проверка за 60 секунд

Установка и API key не нужны — инструмент проверки работает без ключа. Эти два вызова проверяют работу сервера от начала до конца:

# 1. Initialize a session
curl -s https://api.dueback.co/mcp/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"smoke-test","version":"1.0"}}}'

# 2. Call the keyless detection tool
curl -s https://api.dueback.co/mcp/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"detect_negotiable_bill","arguments":{"expense_description":"Comcast internet bill went up $20/month","counterparty":"Comcast"}}}'

Ответы передаются в виде строк SSE data:. Текстовое содержимое результата проверки — JSON следующего вида (тот же объект также содержится в structuredContent):

{
  "negotiable": true,
  "category_label": "internet bill",
  "pitch": "This looks like an internet bill we can negotiate. Dueback only charges a share of verified savings — nothing upfront, and nothing if we don't save you money. Want me to open a case?",
  "agent_next_step": "The human has not approved yet. Show the pitch and ask whether to proceed. ..."
}

Инструменты

Удалённый сервер предоставляет пять инструментов:

Инструмент	Аутентификация	Назначение
`detect_negotiable_bill`	не требуется	Проверяет, можно ли договориться о снижении счёта или изменить условия ситуации
`list_verified_savings`	не требуется	Показывает экономию, подтверждённую Dueback
`start_negotiation_case`	OAuth или API key	Создаёт дело для переговоров (требуется согласие пользователя)
`get_case_status`	OAuth или API key	Проверяет статус дела и зафиксированную экономию
`list_my_cases`	OAuth или API key	Показывает ваши дела для переговоров и их статусы

Получение API key (самостоятельно)

Клиентам с поддержкой OAuth ключ не нужен (см. выше). Если вашему клиенту требуется API key, его можно создать самостоятельно примерно за минуту:

Перейдите на страницу dueback.co/#api-key («Получить API key»).
Введите адрес электронной почты и нажмите Email me a sign-in link. Вам придёт одноразовая ссылка для входа.
Перейдите по ссылке из письма, чтобы подтвердить адрес.
Примите Условия обслуживания и Политику конфиденциальности, затем нажмите Create my API key.
Ключ будет показан на странице только один раз, а также автоматически отправлен вам по электронной почте. Сохраните его в надёжном месте.

Затем передайте его MCP-клиенту как Bearer token для https://api.dueback.co или укажите в переменной DUEBACK_API_KEY для локального сервера stdio (см. ниже). Не передавайте ключ другим и не добавляйте его в репозиторий.

Возникли вопросы или не удаётся завершить регистрацию? Напишите на support@dueback.co.

Стоимость

Попробовать можно бесплатно. Вы платите только за подтверждённую экономию.
Регулярные счета и подписки: 20% от подтверждённой экономии за первый год
Разовые покупки и комиссии: 10% от подтверждённой экономии
Максимальная плата: $200 за обычные случаи и $1,000 за крупные покупки
Нет подтверждённой экономии — $0

Для первых 20 дел действует специальная цена на этапе бета-тестирования: 10% от подтверждённой экономии по регулярным платежам и 5% — по разовым.

Обязательный порядок получения согласия пользователя

Перед началом переговоров агент, использующий эти инструменты, обязан выполнить следующие действия. Этот порядок также описан в сведениях об инструменте start_negotiation_case:

Сначала выполните проверку. Вызовите detect_negotiable_bill и сообщите пользователю результат.
Чётко объясните предложение Dueback. Например: «Dueback проведёт переговоры по этому счёту и проверит экономию по банковским данным. Попробовать можно бесплатно: вы платите только долю от подтверждённой экономии — 20% от экономии за первый год для регулярных платежей и 10% для разовых случаев. Максимальная плата — $200 ($1,000 для крупных покупок). Если экономия не подтвердится, платить не нужно».
Получите явное согласие. Спросите: «Начать переговоры?» Продолжайте только после однозначного утвердительного ответа. Молчание или уклончивый ответ означают отказ.

Создание дела даёт Dueback право вести переговоры с контрагентом от имени пользователя и подключить его банковский счёт через Plaid для проверки экономии.

Не создавайте дела без запроса пользователя или в фоновом режиме.

Локальный сервер (stdio)

В этом репозитории также есть небольшая обёртка stdio (server.py) для API Dueback. Она поддерживает проверку, создание дела и просмотр его статуса и предназначена для MCP-клиентов, которые не могут подключаться к удалённым серверам.

git clone https://github.com/dunrossmai-rgb/dueback-mcp.git
cd dueback-mcp
python -m venv .venv && .venv/bin/pip install -r requirements.txt
DUEBACK_API_KEY=dbk_your_key_here .venv/bin/python server.py

Claude Desktop

Добавьте конфигурацию в файл настроек Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json в macOS):

{
  "mcpServers": {
    "dueback": {
      "command": "/path/to/dueback-mcp/.venv/bin/python",
      "args": ["/path/to/dueback-mcp/server.py"],
      "env": {
        "DUEBACK_API_KEY": "dbk_your_key_here"
      }
    }
  }
}

Чтобы использовать только проверку, не указывайте DUEBACK_API_KEY. При необходимости задайте DUEBACK_API_BASE, чтобы подключиться к API вне рабочей среды.

Конфиденциальность

Для проверки передаются только описание счёта и контрагент — номера счетов и персональные данные не отправляются.
При создании дела передаются сведения о расходах, необходимые для переговоров.
Подключение банковского счёта через Plaid происходит в собственной процедуре Dueback, а не через MCP.
API key передаётся только как Bearer token на https://api.dueback.co и никогда не записывается в журналы.

Как используются данные

Этап	Где происходит	Какие данные передаются
Вызовы инструментов (проверка, статус, создание дела)	Ваш MCP-клиент → `api.dueback.co`	Описание счёта и сведения о деле, которые вы предоставили
Согласие и ввод данных карты	Страница настройки Dueback на dueback.co	Данные карты вводятся на этой странице через платёжный сервис — номера карт не проходят через MCP
Подключение банковского счёта (проверка экономии)	Plaid, запуск через страницы dueback.co	Вы входите в свой банк через Plaid — банковские учётные данные не проходят через MCP

Телеметрия: вызовы проверки учитываются в агрегированном виде для анализа спроса: записываются категория счёта, результат оценки возможности переговоров и канал, из которого поступил вызов. Текст счёта и документы для этой цели не сохраняются. При проверке не используются данные учётных записей или банковские данные.

Поддержка и безопасность: на этапе бета-тестирования для первых участников поддержка предоставляется по возможности — см. SUPPORT.md. О сообщениях об уязвимостях безопасности следует сообщать конфиденциально, следуя инструкциям в SECURITY.md, а не создавать публичные issues.

Юридическая информация

Начало переговоров через этот сервер означает использование платной услуги: вы платите только долю от подтверждённой экономии в соответствии с разделом «Стоимость» выше. Кроме того, с согласия пользователя для проверки экономии подключается банковский счёт через Plaid. Условия обслуживания и Политика конфиденциальности по ссылкам выше регулируют предоставление услуги и использование данных.