sdk-v0.2.0rc2 — Keep MCP tool registration on the compatible 1.x API

sdk-v0.2.0rc2 — Keep MCP tool registration on the compatible 1.x API

14 October 2026 · SDK prerelease. Owner: Roman Konnov. Review by: 28 October 2026.
Source merge commit: ec9b6c96d94e3d9a6b0689d92353b769ea420da4.

This SDK hotfix bounds the optional MCP dependency to its compatible 1.x API. A fresh installation of published rc1 could select MCP 2.3.0 and fail before registering its task tools. The release preserves the existing server adapter and gives the corrected package a new version; published rc1 archives remain unchanged.

What was wrong

Fresh rc1 installations on Python 3.11.8 and 3.13.3 resolved mcp==2.3.0. Core imports passed, but tool registration failed with AttributeError: 'Server' object has no attribute 'list_tools'. Installing the wheel and its extra did not ensure the MCP entry point could construct its server.

Root cause

The optional dependency required mcp>=1.27.0 without an upper bound. The existing low-level Server adapter uses the list_tools and call_tool registration decorators, which MCP 2 removed. The startup function _amain calls _make_server, the function that constructs and registers that server; the failure therefore occurs on the startup path, not just a test-only import.

Fix

The release changes the dependency to mcp>=1.27.0,<2, allowing the installer to select 1.x without a manual pin or constraints file. Package metadata, runtime version and README now identify 0.2.0rc2. Only these three SDK files change; the server adapter, task methods and backend remain unchanged. This hotfix does not claim support for MCP 2.

Tests

The preserved AF-20 baseline contains two failed rc1 MCP probes on Python 3.11.8 and 3.13.3, both with MCP 2.3.0. Final rc2 checks on macOS ARM64 passed three core probes and three MCP probes: Python 3.11.8, 3.12.10 and 3.13.3. Each fresh environment installed core first, confirmed MCP was absent, then installed the extra. The resolver selected MCP 1.30.0 automatically in all three; genuine registration exposed nine tools and the installed entry point. Imports came from the new environments' site-packages; versions and six module bytes matched the wheel.

RED: two old MCP failures. GREEN: three corrected environments, each with core and MCP probe exit 0. Earlier pilot checks are separate from this final matrix. This scope proves import and tool registration, not live MCP transport, the public backend, providers, Windows/Linux, load or independent user demand. The package matrix did not rerun full backend/frontend suites locally. PR #122 separately passed all three repository CI jobs: backend, frontend and telemetry.

What owners need to do

MCP users should install the new rc2 wheel with its [mcp] extra following the attached install.md. Four assets accompany this prerelease: wheel, sdist, SHA256SUMS and install.md. The checksum file covers the two archives only. Keep rc1 archives intact. A compatible reviewed-task backend still needs V89, V90 and R__protect_learning_reservation.sql; the SDK does not apply migrations. Keep agent keys private. Core-only users were not affected by the reproduced MCP failure.

Related

The attached install.md contains the installation guide and dated local proof appendix. AF-20/AF-21 retain their red baseline and package report as local evidence, not public download links. PyPI publication, platform deployment and cloud installation are excluded.

---

Русская версия

sdk-v0.2.0rc2: совместимая ветка MCP 1.x для регистрации инструментов

14.10.2026 · Предварительный выпуск SDK. Владелец: Roman Konnov. Пересмотреть до: 28.10.2026.
Исходник: merge commit ec9b6c96d94e3d9a6b0689d92353b769ea420da4.

Исправление ограничивает необязательную зависимость MCP совместимой веткой 1.x. Новая установка опубликованного rc1 могла выбрать MCP 2.3.0 и отказать до регистрации инструментов заданий. Прежний серверный адаптер сохраняется, исправленный пакет получает новый номер; опубликованные архивы rc1 не заменяются.

Что было сломано

Новые установки rc1 на Python 3.11.8 и 3.13.3 выбрали mcp==2.3.0. Импорт core прошёл, но регистрация инструментов завершилась ошибкой AttributeError: 'Server' object has no attribute 'list_tools'. Установка wheel и расширения не гарантировала создание сервера через точку входа MCP.

Первопричина

Необязательная зависимость задавала mcp>=1.27.0 без верхней границы. Прежний адаптер низкоуровневого Server использует декораторы регистрации list_tools и call_tool, удалённые в MCP 2. Функция запуска _amain вызывает _make_server, которая создаёт сервер и регистрирует инструменты; ошибка возникает на пути запуска, а не только при тестовом импорте.

Исправление

Выпуск задаёт mcp>=1.27.0,<2: установщик выбирает 1.x без ручной фиксации версии или файла ограничений. Метаданные пакета, версия при выполнении и README указывают 0.2.0rc2. Меняются только эти три файла SDK; серверный адаптер, методы заданий и backend сохраняются. Поддержка MCP 2 этим исправлением не заявляется.

Тесты

Сохранённый baseline AF-20 содержит два отказа MCP в rc1 на Python 3.11.8 и 3.13.3 с MCP 2.3.0. Итоговые проверки rc2 на macOS ARM64 прошли в трёх окружениях: Python 3.11.8, 3.12.10 и 3.13.3, по одной проверке core и MCP в каждом. В новом окружении сначала устанавливался core с подтверждённым отсутствием MCP, затем расширение. Во всех трёх установщик автоматически выбрал MCP 1.30.0; настоящая регистрация предоставила девять инструментов и установленную точку входа. Импорт шёл из нового site-packages; версии и байты шести модулей совпали с wheel.

RED: два прежних отказа MCP. GREEN: три исправленных окружения, каждое с exit 0 у проверки core и MCP. Предварительные pilot-проверки отделены от итоговой матрицы. Проверены импорт и регистрация инструментов; действующий транспорт MCP, публичный backend, провайдеры, Windows/Linux, нагрузка и независимый спрос не проверены. Матрица пакета не повторяла полные наборы тестов backend/frontend локально. PR #122 отдельно прошёл все три задания CI репозитория: backend, frontend и telemetry.

Что нужно сделать владельцам

Пользователям MCP нужно установить новый wheel rc2 с расширением [mcp] по вложению install.md. Предварительный выпуск содержит четыре вложения: wheel, sdist, SHA256SUMS и install.md. Файл сумм покрывает только два архива. Архивы rc1 сохраняются. Совместимому backend приёмки нужны V89, V90 и R__protect_learning_reservation.sql; SDK не применяет миграции. Ключи агентов храните приватно. Пользователи только core воспроизведённой ошибкой MCP не затронуты.

Связанное

Вложение install.md содержит инструкцию установки и датированное приложение локальной проверки. AF-20/AF-21 сохраняют красный baseline и отчёт пакета как локальные доказательства, не публичные ссылки загрузки. Публикация в PyPI, установка платформы и облачная установка исключены.