Yandex Delivery MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Yandex Delivery MCP Create a delivery claim for a 5 kg package from Moscow to Kazan"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Yandex Delivery MCP Server
MCP (Model Context Protocol) сервер для интеграции с API Яндекс Доставки. Позволяет Claude и другим AI-ассистентам управлять доставками, отслеживать курьеров и работать с заказами.
🚀 Развернуть в интернете (1 минута)
Рекомендация: Railway - лучший бесплатный вариант
⚡ Нажмите кнопку "Deploy on Railway" выше
🔑 Добавьте API ключ Яндекс Доставки
🌐 Получите рабочий URL:
https://your-app.railway.app🎯 Используйте в AI Studio:
https://your-app.railway.app/manifest
Related MCP server: Yandex AI Studio MCP Server
🚀 Быстрый старт
Установка через npm
npm install -g yandex-delivery-mcpИли локальная установка
git clone https://github.com/aryazansev/-yandex-delivery-mcp.git
cd -yandex-delivery-mcp
npm install
npm run build⚙️ Настройка
1. Получите API ключ из Яндекс Доставки
Войдите в личный кабинет Яндекс Доставки
Перейдите в раздел API / Интеграции
Создайте новый API ключ
Скопируйте ключ
2. Создайте файл конфигурации
Создайте файл ~/.yandex-delivery-mcp/.env:
mkdir -p ~/.yandex-delivery-mcp
cat > ~/.yandex-delivery-mcp/.env << 'EOF'
YANDEX_DELIVERY_API_KEY=your_api_key_here
MCP_PORT=3002
EOFИли просто создайте .env файл в папке проекта:
YANDEX_DELIVERY_API_KEY=your_api_key_here
MCP_PORT=30023. Настройка (2 варианта)
Вариант A: Claude Desktop (локально)
Откройте файл конфигурации Claude Desktop:
macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%/Claude/claude_desktop_config.jsonДобавьте:
{
"mcpServers": {
"yandex-delivery": {
"command": "yandex-delivery-mcp"
}
}
}Вариант B: Внешний HTTP сервер (для AI Studio и других инструментов)
Запуск HTTP сервера:
npm run serverСервер будет доступен на:
Health: http://localhost:3002/health
Manifest: http://localhost:3002/manifest
Tools: http://localhost:3002/tools
Для AI Studio:
Запустите сервер:
npm run serverВ AI Studio используйте URL:
http://localhost:3002/manifestAI Studio автоматически обнаружит все доступные инструменты
4. Перезапустите Claude Desktop (если используете вариант A)
Полностью закройте и откройте заново Claude Desktop.
💬 Использование
Теперь вы можете спрашивать Claude о данных из Яндекс Доставки:
"Рассчитай стоимость доставки из Москвы в Санкт-Петербург"
"Создай заявку на доставку посылки 5 кг"
"Покажи статус заявки ABC123"
"Где сейчас курьер по заявке ABC123?"
"Получи телефон курьера для заявки ABC123"
"Найди все заявки за последние 3 дня"
"Отмени заявку ABC123"
🛠️ Доступные инструменты
Базовые операции
calculate_offers- Рассчитать варианты доставкиcreate_claim- Создать заявку на доставкуget_claim_info- Получить информацию о заявкеaccept_claim- Подтвердить заявкуcancel_claim- Отменить заявку
Стоимость и тарифы
check_price- Проверить стоимость без создания заявкиget_tariffs- Получить доступные тарифы
Отслеживание
get_driver_phone- Получить номер телефона курьераget_performer_position- Получить позицию курьера (координаты, скорость)get_points_eta- Получить ETA для точек маршрутаget_tracking_links- Получить ссылки для отслеживания
Подтверждение доставки
get_confirmation_code- Получить код подтвержденияget_proof_of_delivery- Получить данные о подтверждении доставки
Редактирование
edit_claim- Редактировать заявку (до подтверждения)apply_changes_request- Запросить изменения (после подтверждения)apply_changes_result- Получить результат измененийreturn_claim- Инициировать возврат заказа
Поиск и информация
search_claims- Поиск заявок с фильтрамиget_bulk_info- Получить информацию о нескольких заявкахget_claim_journal- Получить историю изменений заявки
Доставка в течение дня
get_delivery_methods- Получить список доступных услуг
🔧 Разработка
Сборка проекта
npm run buildЗапуск в режиме разработки
# Для Claude Desktop (stdio)
npm run dev
# Для внешнего HTTP сервера (AI Studio)
npm run serverТестирование через MCP Inspector
npx @modelcontextprotocol/inspector node build/index.jsТестирование HTTP сервера
# Запустить сервер
npm run server
# Проверить эндпоинты в другой терминал
curl http://localhost:3002/health
curl http://localhost:3002/manifest
curl http://localhost:3002/tools📝 Требования
Node.js 18+
API ключ от Яндекс Доставки
Claude Desktop (для интеграции с Claude)
📄 Лицензия
MIT License - см. файл LICENSE
🤝 Поддержка
Если у вас возникли проблемы:
Проверьте, что API ключ активен
Убедитесь, что у ключа есть нужные права доступа
Проверьте логи Claude Desktop
Создайте issue на GitHub
🔗 Ссылки
Пример использования
Создание заявки
{
"route_points": [
{
"coordinates": [55.7558, 37.6173],
"fullname": "Москва, Красная площадь, 1",
"contact": {
"name": "Иван",
"phone": "+79991234567"
}
},
{
"coordinates": [59.9343, 30.3351],
"fullname": "Санкт-Петербург, Невский проспект, 1",
"contact": {
"name": "Петр",
"phone": "+79997654321"
}
}
],
"items": [
{
"title": "Посылка",
"weight": 5,
"quantity": 1
}
],
"requirements": {
"taxi_class": "express",
"door_to_door": true
}
}Расчет стоимости
{
"route_points": [
{
"coordinates": [55.7558, 37.6173]
},
{
"coordinates": [59.9343, 30.3351]
}
],
"requirements": {
"cargo_type": "van"
}
}Available Tools
21 toolsaccept_claimD
Inputs: version (required), claim_id (required).
apply_changes_requestD
Inputs: changes (required), claim_id (required).
apply_changes_resultD
Inputs: claim_id (required).
calculate_offersD
Inputs: route_points (required), due, requirements, optional_return.
cancel_claimD
Inputs: version (required), claim_id (required), cancel_state.
check_priceD
Inputs: route_points (required), requirements, optional_return.
create_claimD
Inputs: route_points (required), due, items, comment, +2 more.
edit_claimD
Inputs: version (required), claim_id (required), items, comment, +1 more.
get_bulk_infoD
Inputs: claim_ids (required).
get_claim_infoD
Inputs: claim_id (required).
get_claim_journalD
Inputs: claim_id (required), cursor.
get_confirmation_codeD
Inputs: claim_id (required).
get_delivery_methodsD
Inputs: start_point.
get_driver_phoneD
Inputs: claim_id (required).
get_performer_positionD
Inputs: claim_id (required).
get_points_etaD
Inputs: claim_id (required).
get_proof_of_deliveryD
Inputs: claim_id (required).
get_tariffsD
Inputs: end_point, start_point.
get_tracking_linksD
Inputs: claim_id (required).
return_claimD
Inputs: version (required), claim_id (required), point_id.
search_claimsD
Inputs: limit, phone, cursor, offset, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
The tool set has several overlapping retrieval functions (e.g., get_claim_info, search_claims, get_bulk_info, get_claim_journal) and similar pricing tools (calculate_offers, check_price), which could confuse an agent without detailed descriptions. However, most tools are distinct actions on distinct resources.
All tool names use snake_case and follow a verb_noun pattern (get_tracking_links, create_claim, accept_claim, etc.), which is consistent and readable. The only minor inconsistency is mixing singular and plural nouns (claim vs. claims, info vs. journal).
With 21 tools, the server is slightly over the typical comfortable range but still reasonable for a comprehensive delivery management API covering claims, tracking, pricing, and delivery methods. Each tool appears to serve a distinct purpose, so the count is justified.
The tool surface covers the full claim lifecycle (create, edit, accept, cancel, return, search) and includes tracking, pricing, and delivery method operations, leaving few obvious gaps. Minor missing features like a dedicated 'delete' action are likely covered by cancel/return, so agents can achieve core workflows.
Maintenance
Related MCP Connectors
Furgonetka MCP Server is an extension for LLMs (such as Claude) that integrates AI assistants with Poland's most popular courier brokerage platform. The server enables models to interact directly with services from various couriers (including InPost, DPD, DHL, UPS, and Poczta Polska) through a single, unified interface. With this integration, your AI stops just "writing about logistics" and starts actually managing it.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server for OnceAsk, the AI-native current-address layer for people and agents.
MCP server for AI dialogue using various LLM models via AceDataCloud
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for Yandex Tracker API, enabling AI assistants to search, read, create, and edit issues, as well as manage comments, attachments, and links in Yandex Tracker.46 npm1MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for interacting with Yandex Cloud AI Studio, enabling chat, text generation, image generation, speech recognition/synthesis, embeddings, classification, search indexes, and AI agent creation with function calling.-
- AlicenseAqualityDmaintenanceMCP server for Yandex Eats Vendor Management API, enabling AI agents to manage partner operations like orders, busy mode, menu import, and feedback.116 npmMIT
- AlicenseAqualityBmaintenanceMCP server for Yandex Delivery B2B API, enabling natural language interaction to calculate delivery costs, create and manage express and platform delivery orders, track couriers, and handle pickup points.16104 npmMIT