OFZ MCP Server

MCP (Model Context Protocol) сервер для получения данных об облигациях ОФЗ, субфедеральных и корпоративных с MOEX.

Инструменты

get_bonds

Получить список облигаций с фильтрами.

Параметры:

• type — Тип: ofz, subfed, corp или all (по умолчанию all)

• max_months — Максимальный срок до погашения в месяцах

• min_yield — Минимальная доходность в процентах

• issuer — Код эмитента (sber, vtb, gazprom, rzd и др.)

• sort_by — Сортировка: yield, maturity, coupon (по умолчанию yield)

• limit — Лимит результатов (по умолчанию 20)

• ticker — точный тикер выпуска

• currency — валюта номинала, по умолчанию RUB

• coupon_type — known, floating, indexed, unknown или all

Каждый выпуск содержит поля источника цены и доходности, валюту и время биржевых данных. Основная доходность — marketdata_yields.EFFECTIVEYIELD в паре с ценой marketdata_yields.PRICE. Прежнее marketdata.YIELD сохраняется отдельно как legacyYield. Показатель флоатера условный: будущие купоны зависят от ставок. При нулевом купоне и неизвестной ставке сервер сообщает, что сумма не определена, и сохраняет исходный ноль отдельно.

calculate_investment

Оценить покупку с НКД и размером лота. Известные выплаты считает по полному календарю MOEX, с датами фиксации и погашениями. Для плавающего купона, индексации, валютного выпуска, оферты или неполных данных объясняет, почему общую прибыль рассчитать нельзя. Суммы — до комиссий и налогов.

Параметры:

• ticker — Тикер облигации (например, SU26238RMFS4)

• amount — Сумма инвестиции в рублях

get_issuers

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

Полный разбор исправлений: версия1.1.0.

Related MCP server: t-invest-mcp

Эмитенты

Локальный запуск

npm install
npm start

Сервер запустится на порту 3001:

• MCP endpoint: http://localhost:3001/mcp

• REST API: http://localhost:3001/api/bonds

• Health check: http://localhost:3001/health

Рабочий сервер

С29.10.2026 сервер работает на российском Sprintbox рядом с сайтом клуба. Адрес подключения (Streamable HTTP):

https://club.nikexpert.ru/mcp/moex/mcp

API-ключи, OAuth и ключ ИИ не нужны. Данные поступают напрямую из MOEX ISS; модели OpenAI/DeepSeek сервер не вызывает. Прежнее приложение Railway удалено и возвращает404. Автозапуск, проверки и откат описаны в deploy/README.md.

Подключение к Claude

В Claude добавьте пользовательский коннектор с URL выше. В Claude Code можно добавить MCP-сервер в ~/.claude.json:

{
  "mcpServers": {
    "ofz-bonds": {
      "type": "http",
      "url": "https://club.nikexpert.ru/mcp/moex/mcp"
    }
  }
}

Проверка HTTPS и всех трёх инструментов официальным SDK:

TEST_ENDPOINT=https://club.nikexpert.ru/mcp/moex/mcp npm test

REST API

GET /api/bonds — получить облигации в JSON формате.

Query параметры:

• type — ofz, subfed, corp, all

• max_months — максимальный срок в месяцах

• min_yield — минимальная доходность

• issuer — код эмитента

• sort_by — yield, maturity, coupon

• limit — лимит результатов (по умолчанию 50)

Пример:

curl "https://club.nikexpert.ru/mcp/moex/api/bonds?type=ofz&limit=5"