MCP и API

для ваших агентов и скриптов

Ключ API открывает те же данные, что и кабинет: каталог, карточки с рыночной оценкой и вердиктом, аналоги, избранное и ленту событий. MCP-сервер подключает их к Claude, Cursor и другим агентам, REST — к любым скриптам. Сервис ничего не подаёт и не оплачивает: агент анализирует и напоминает о сроках, заявку и ставки делает человек.

1. Создайте ключНиже на этой странице или в профиле. Ключ показывается один раз, до пяти ключей на аккаунт.

2. Подключите клиентаClaude Code одной командой, Claude Desktop и Cursor через файл настроек, скрипты через REST.

3. Спрашивайте каталогАгент сам прочитает руководство и получит по каждому лоту оценку, дисконт, вердикт и потолок ставки.

Ключи API

Ключи создаются в кабинете аккаунтом с активной подпиской или пробным периодом. После входа на этой странице появится кнопка «Создать ключ».

Войти Создать аккаунт

1. Подключение

Адрес MCP-сервера: https://torgi.io/mcp, транспорт Streamable HTTP, авторизация заголовком Authorization: Bearer tio_…. Вместо tio_ВАШ_КЛЮЧ подставьте свой ключ.

Claude Code

claude mcp add --transport http torgi https://torgi.io/mcp --header "Authorization: Bearer tio_ВАШ_КЛЮЧ"

Проверка: claude mcp list должен показать torgi как подключённый. Готовые сценарии появятся в меню команд по «/» с префиксом torgi.

Cursor

Файл .cursor/mcp.json в проекте (или глобальный ~/.cursor/mcp.json):

{
  "mcpServers": {
    "torgi": { "url": "https://torgi.io/mcp", "headers": { "Authorization": "Bearer tio_ВАШ_КЛЮЧ" } }
  }
}

Claude Desktop

Настройки → Разработчик → Изменить конфигурацию (claude_desktop_config.json). Нужен Node.js: подключение идёт через мост mcp-remote.

{
  "mcpServers": {
    "torgi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://torgi.io/mcp", "--header", "Authorization: Bearer tio_ВАШ_КЛЮЧ"]
    }
  }
}

Другие клиенты (VS Code, Windsurf, свои агенты)

Любой клиент с поддержкой MCP по HTTP: укажите адрес https://torgi.io/mcp и заголовок Authorization. Для клиентов, которые умеют только локальные серверы, подойдёт тот же мост mcp-remote, что и для Claude Desktop.

REST для скриптов

curl -H "Authorization: Bearer tio_ВАШ_КЛЮЧ" "https://torgi.io/api/v1/lots?stage=applications&kind=flat&order=discount_desc&limit=20"
curl -H "Authorization: Bearer tio_ВАШ_КЛЮЧ" "https://torgi.io/api/v1/lots/НОМЕР_ЛОТА/card"
curl -H "Authorization: Bearer tio_ВАШ_КЛЮЧ" "https://torgi.io/api/v1/favorites"

Те же маршруты, что использует кабинет: список лотов с фильтрами каталога, карточка, избранное, лента событий, документы и фото по ссылкам из карточки. В REST дисконт передаётся долей (min_discount=0.4), в MCP — процентами (min_discount_pct=40).

2. Что умеет агент

При подключении агент получает руководство по порталу (инструмент guide и ресурс torgi://guide): откуда данные, как считаются оценка, дисконт, потолок ставки и вердикт, как отвечать пользователю. В каждой строке поиска и в карточке первым идёт поле summary — готовая фраза: оценка и источник, дисконт, вердикт, потолок ставки, риски, сроки.

Инструмент	Что делает
`search_lots`	Поиск с фильтрами каталога: вид, регион, стадия, цена, дисконт в процентах, вердикт, повторные торги, запас потолка, срок заявок, текст; сортировка по дисконту, цене, сроку, потолку
`get_lot`	Полная карточка: экономика с разбивкой потолка ставки, вердикт с обоснованием и проверками до задатка, риски, факты из документов, документы и фото ссылками, спрос и история
`get_comparables`	Аналоги рынка, статистика, пересмотр оценщика, оценка Циана по адресу, причина отклонения рынка
`list_favorites`, `add_favorite`, `remove_favorite`	Избранное — то же, что в кабинете, с этапом воронки и заметкой; по нему приходят напоминания о сроках
`recent_events`	Лента событий за период: новые лоты, снижения цены, переходы стадий, итоги торгов; можно только по избранному
`portal_summary`	Срез каталога: активные лоты, с оценкой, вердикты, средний дисконт, заявки на 7 дней
`guide`	Руководство для агента целиком или по разделу

Готовые сценарии (промпты)

screen_lots — подбор по виду, региону, бюджету и дисконту с группировкой по вердикту.
analyze_lot — разбор лота: экономика, вердикт, аналоги, риски, проверки до задатка.
compare_lots — сравнение нескольких лотов таблицей и рекомендация.
daily_digest — что изменилось по избранному за сутки и ближайшие сроки.
before_deposit_checklist — чек-лист перед внесением задатка.

3. Правила и лимиты

До 5 действующих ключей на аккаунт; ключ показывается один раз, в базе хранится только его хэш. Любой ключ можно отозвать здесь или в профиле.
120 запросов в минуту на ключ (ответ 429 — подождите минуту). Отозванный или неизвестный ключ — 401, закончившаяся подписка — 402.
Данные и правила те же, что в кабинете: персональные данные должников, жильцов и участников — только инициалами, документы отдаются ссылками.
Ключ — это доступ к вашему аккаунту: не вставляйте его в общие чаты и репозитории, при утечке отзовите и создайте новый.
Расчёты и прогнозы — аналитические ориентиры, не гарантия результата торгов; сервис ничего не подаёт и не оплачивает автоматически.

4. Проверка и неполадки

curl -X POST https://torgi.io/mcp -H "Authorization: Bearer tio_ВАШ_КЛЮЧ" -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ответ 401 — ключ введён с ошибкой или отозван: создайте новый. 402 — продлите доступ в разделе «Доступ и тариф». 429 — превышен лимит в минуту.
Агент показывает только старт и задаток — попросите его пересказать поле summary по каждому лоту или прочитать руководство (guide); в свежих подключениях это происходит само.
Claude Desktop не видит сервер — проверьте, что установлен Node.js и конфигурация сохранена без ошибок в JSON; после правки перезапустите приложение.
Вопросы по подключению — через форму «Заказать звонок» на главной странице.