Nova Poshta
Nova Poshta (Нова Пошта), Ukraine's parcel carrier: track up to 100 waybills at once, find cities and branches or parcel lockers, calculate delivery price and date, and list your own shipments. Tracking and lookups work without an API key.
7 天免费 · 无需信用卡 · EU 托管
问 Nova 任何事
通过 AnythingMCP 对 Nova Poshta 试一个真实提示 — Claude 调用工具并返回答案。在你的消息上按 Enter 即可在 Cloud 安装。
在 Cloud 上安装 NovaClaude 是 AI,可能会出错。请核对回答。
2 分钟设置
- 1在 cloud.anythingmcp.com 开始免费试用。
- 2在连接器商店点击 Nova Poshta。提示时粘贴凭据。
- 3生成 MCP API 密钥,将 AI 客户端指向生成的 MCP URL。
配置 Nova Poshta
直接来自连接器定义:在哪里获取凭据、需要哪些权限,以及该适配器调用的是哪个 API。 由连接器作者以英文提供。
Nova Poshta is Ukraine's largest parcel carrier. This adapter calls its public API 2.0, a single JSON endpoint (https://api.novaposhta.ua/v2.0/json/) where every call names a model and a method in the request body.
Getting credentials
Tracking, city and branch search, price and delivery-date calculation work without a key. Only nova_poshta_list_shipments (your own waybills) needs one. To create it, sign in to the Nova Poshta business account at new.novaposhta.ua, open Settings → Security and click Create key, accept the API terms and copy the key into NOVA_POSHTA_API_KEY. A key is valid for one year; an expired key makes every call fail with "API key expired", including the ones that work without a key, so renew it or clear the variable.
Workflow
nova_poshta_track_parcelstakes up to 100 waybill (TTN) numbers. Add the sender's or recipient's phone to a number to get the full record (recipient, address, payment); without it Nova Poshta returns only the status and a warning asking for the phone.- Resolve a city name with
nova_poshta_search_settlements. ItsDeliveryCityfield is the city reference thatnova_poshta_list_warehouses,nova_poshta_get_delivery_priceandnova_poshta_get_delivery_dateexpect (Refis the settlement, a different id). - Price and date need a service type: Warehouse = branch, Doors = address, Postomat = parcel locker.
Formats and gotchas
- Dates are DD.MM.YYYY, e.g. 07.10.2026. Weight is in kg, declared value (
cost) in UAH. - Nova Poshta answers HTTP 200 even when a call fails: always read
success. When it is false,errors(anderrorCodes) say why, e.g. "Weight is invalid".warningscan carry useful notes on a successful call. - A tracking number that does not exist still returns success with
Status"Номер не знайдено" (number not found) and StatusCode 3. - Texts come in Ukrainian; many records also carry a Russian
DescriptionRu.
Pagination and limits: list methods take page (from 1) and limit; info.totalCount gives the total where Nova Poshta reports it. No quota is published; keep pages small and avoid bulk loops.
Cloud reachability: api.novaposhta.ua is public over HTTPS, so AnythingMCP Cloud and self-hosted installs reach it directly.