Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Nova Poshta in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
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.
Try asking
Example prompts for Nova Poshta
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Nova Poshta, paste your credentials, mint an MCP API key — done. No Docker, no
git clone, no local server.
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.
Setup
- Tracking, city and branch search, price and delivery-date calculation work without a key: there is nothing to set up.
- Only
nova_poshta_list_shipments(your own waybills) needs a key. In the Nova Poshta business account at new.novaposhta.ua open Settings → Security, click Create key, accept the API terms and put the key inNOVA_POSHTA_API_KEY. A key is valid for one year; an expired key makes every call fail, so renew it or clear the variable. nova_poshta_track_parcelstakes up to 100 waybill (TTN) numbers. Add the sender's or recipient's phone to get the full record; without it you get the status only.- For price and delivery date, resolve the city with
nova_poshta_search_settlementsand pass itsDeliveryCityvalue (notRef) tonova_poshta_get_delivery_priceornova_poshta_get_delivery_date, with a service type: Warehouse (branch), Doors (address) or Postomat (parcel locker).
Dates are DD.MM.YYYY, weight is in kg and the declared value in UAH. Nova Poshta answers HTTP 200 even when a call fails, so the assistant reads success and errors; an unknown tracking number comes back as "Номер не знайдено" (number not found). Texts are in Ukrainian, and many records also carry a Russian DescriptionRu.
Prerequisites: (none — public API)
Install the connector locally
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Open http://localhost:3000/connectors/store, pick Nova Poshta and paste in the env vars listed under Prerequisites.
Available tools
| Tool | What it does |
|---|---|
nova_poshta_track_parcels | Get the current status of one or more Nova Poshta shipments by waybill (TTN) number: status text and code, dates, cities, branch, weight… |
nova_poshta_search_settlements | Search Ukrainian cities, towns and villages served by Nova Poshta by name |
nova_poshta_list_warehouses | List Nova Poshta branches and parcel lockers (postomats) of a city with address, number, schedule, weight limits and reference |
nova_poshta_list_warehouse_types | List the Nova Poshta branch types (post office, cargo branch, parcel locker and so on) with their references, for filtering… |
nova_poshta_get_delivery_price | Calculate the Nova Poshta delivery price for a shipment between two cities: returns Cost (delivery price in UAH) and AssessedCost (declared… |
nova_poshta_get_delivery_date | Estimate when a Nova Poshta shipment sent on a given day will arrive, for a pair of cities and a service type |
nova_poshta_list_shipments | List the waybills (express invoices) created by the account that owns NOVA_POSHTA_API_KEY within a date range, with number, recipient… |
Next steps
Was this guide helpful?
