Connector guide8-minute read29 MCP tools7 languages

Connect Ukrposhta to Claude via MCP

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

HCBy HelpCode teamUpdated 8 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Ukrposhta

Ukrposhta

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

tools

29

Region

INTL

Category

Logistics

Authentication

API credentials

Required env vars

UKRPOSHTA_ECOM_BEARERUKRPOSHTA_TRACKING_BEARERUKRPOSHTA_COUNTERPARTY_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

Guided setup

Connect Ukrposhta to Claude in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Ukrposhta in the guided setup, then add your MCP URL to Claude. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

AnythingMCP is listed in Claude's connector directory: add it to Claude in one click (opens in a new tab), then sign in and choose which MCP servers Claude may use.

Try asking

Example prompts for Ukrposhta

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Ukrposhta · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Ukrposhta, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Ukrposhta + Claude

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

UKRPOSHTA_ECOM_BEARER, UKRPOSHTA_TRACKING_BEARER, UKRPOSHTA_COUNTERPARTY_TOKEN

Step 1 — Get credentials

  1. Sign a contract for the API with Ukrposhta (business customer service, [email protected]). With the contract you receive an annex with your production keys.
  2. Copy PRODUCTION BEARER eCom into UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking into UKRPOSHTA_TRACKING_BEARER and PROD_COUNTERPARTY TOKEN into UKRPOSHTA_COUNTERPARTY_TOKEN.

The sandbox keys (SANDBOX ...) do not work here: this connector calls the production host. The eCom bearer also opens the address classifier and the label service; tracking has its own bearer; the counterparty token identifies your account on calls about your clients and shipments.

Where to start: ukrposhta_track_shipment or ukrposhta_get_last_status with a barcode. For the shipments of your account, ukrposhta_get_shipment_by_barcode or ukrposhta_list_sender_shipments with the sender's client uuid.

Tracking: ukrposhta_track_shipment (all events), ukrposhta_get_last_status, ukrposhta_get_last_statuses (up to 50 barcodes) and ukrposhta_get_shipment_route. Pass lang en for English event names.

Shipments: ukrposhta_get_shipment, ukrposhta_get_shipment_by_barcode, ukrposhta_list_sender_shipments, ukrposhta_get_shipment_lifecycle, ukrposhta_list_shipment_groups, ukrposhta_list_group_shipments, and ukrposhta_get_label (PDF). Before shipping, ukrposhta_check_route and ukrposhta_calculate_domestic_price (UAH, without your contract discounts).

Creating a shipment follows Ukrposhta's order: ukrposhta_create_address for sender and recipient, ukrposhta_create_client for each (or reuse them: ukrposhta_get_client, ukrposhta_find_clients_by_phone, ukrposhta_get_address), then ukrposhta_create_shipment, then the label. ukrposhta_create_shipment and ukrposhta_delete_shipment are installed switched off: a created shipment is charged once handed in, and a deleted one cannot be restored. Addresses and clients cost nothing.

Address classifier: ukrposhta_search_regions, ukrposhta_search_districts, ukrposhta_search_cities, ukrposhta_search_streets, ukrposhta_get_house_postcode, ukrposhta_get_city_by_postcode, and for post offices ukrposhta_find_post_offices_by_postcode, ukrposhta_find_post_offices_near and ukrposhta_get_post_office_hours. Answers come as Entries.Entry lists with upper-case field names; ids are strings.

Units and pitfalls: weight in grams, sizes in cm, money in UAH. Delivery types: W2W post office to post office, W2D to the door, D2W and D2D from the door. A postcode marked RESTRICTED_ACCESS can only be a sender or return address. Statuses: CREATED (not handed in yet), REGISTERED, DELIVERING, IN_DEPARTMENT (waiting at the office), DELIVERED, RETURNING, RETURNED, CANCELLED, DELETED. Times are Kyiv local time.

Step 2 — Install the adapter

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

Step 3 — Add the connector in Claude

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Recommended path: works on claude.ai web without editing any config file.

  1. In Claude, open Plugins (still called Customize on some plans) → Connectors.
  2. Click + Add, then Add custom connector.
  3. Enter a name, e.g. Ukrposhta, and the remote MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, then click Continue, keep the detected settings and click Continue again.
  4. Choose Sign in now, click Add and sign in to AnythingMCP (OAuth) to allow access.

All tools below appear in your chat: start typing prompts.

Available tools

ToolWhat it does
ukrposhta_track_shipmentFull status history of one shipment by barcode: per event step, date, index and name of the post office, event code and eventName (e.g.…
ukrposhta_get_last_statusThe latest status of one shipment by barcode: date, post office index and name, event code, eventName and eventReason. Read-only
ukrposhta_get_last_statusesThe latest status of up to 50 shipments at once, plus the barcodes Ukrposhta does not know: per barcode date, post office, event code and…
ukrposhta_get_shipment_routeWhere a shipment travels from and to (country and locality) by barcode. Read-only
ukrposhta_get_shipmentRead one shipment of your account by uuid: barcode, type, sender and recipient clients with addresses, deliveryType, parcels (weight…
ukrposhta_get_shipment_by_barcodeRead one shipment of your account by its barcode (same fields as ukrposhta_get_shipment). Read-only
ukrposhta_list_sender_shipmentsList the shipments created for one sender client: uuid, barcode, recipient, deliveryType, parcels, prices and lifecycle status. Read-only
ukrposhta_get_shipment_lifecycleCurrent status of one shipment from the eCom side: shipmentUuid, shipmentBarcode, status (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT…
ukrposhta_list_shipment_groupsList the shipment groups (registers for form 103a) of one client: uuid, name, type, created date, closed flag and number of shipments.…
ukrposhta_list_group_shipmentsList the shipments in one shipment group: uuid, barcode, recipient, parcels, prices and lifecycle status. Read-only
ukrposhta_get_labelDownload the address label (sticker) of a shipment you created, as a PDF file: 100 x 100 mm by default, or on an A4 or A5 sheet. Printing a…
ukrposhta_calculate_domestic_priceEstimate the price of a shipment within Ukraine before creating it: deliveryPrice in UAH, rawDeliveryPrice, postPayDeliveryPrice…
ukrposhta_check_routeCheck that Ukrposhta delivers between two postcodes: code (SUCCESS when available), description and mrtps (where the mobile post office of…
ukrposhta_get_clientRead one client (sender or recipient) of your account: uuid, type (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), name, firstName, lastName…
ukrposhta_find_clients_by_phoneFind the clients of your account with a phone number: uuid, name, type, addresses. Read-only
ukrposhta_get_addressRead an address created with ukrposhta_create_address: id, postcode, region, district, city, street, houseNumber, apartmentNumber, country…
ukrposhta_create_addressCreate an address to use for a client or a shipment. Only the postcode is required; add street and house for door delivery. Free; answers…
ukrposhta_create_clientCreate a client (sender or recipient) on an address from ukrposhta_create_address. Individuals and private entrepreneurs need first_name…
ukrposhta_create_shipmentCreate a domestic shipment from a sender client to a recipient client. It gets a barcode and a price, and is charged once handed in at the…
ukrposhta_delete_shipmentDelete a shipment that is still in status CREATED (not yet handed in). Cannot be undone. Installed switched off
ukrposhta_find_post_offices_by_postcodePost offices that serve a postcode: ID, PO_SHORT and PO_LONG (name), ADDRESS, PHONE, TYPE_LONG, LATITUDE, LONGITUDE, POSTTERMINAL…
ukrposhta_find_post_offices_nearPost offices near a point, nearest first: ID, name, address, postcode, distance, coordinates and type. Read-only
ukrposhta_get_post_office_hoursOpening hours of a post office by postcode: per weekday the opening and closing time and breaks. Read-only
ukrposhta_get_city_by_postcodeThe locality, district and region of a postcode, with their ids. Read-only
ukrposhta_search_regionsFind regions (oblasts) by part of the name, in Ukrainian or English: REGION_ID, REGION_UA, REGION_EN, KOATUU and KATOTTG codes. Leave both…
ukrposhta_search_districtsFind districts of a region by name: DISTRICT_ID, names in UA and EN, region. Read-only
ukrposhta_search_citiesFind localities by name, optionally within a region and district: CITY_ID, names in UA and EN, type (city, village), district, region and…
ukrposhta_search_streetsFind streets of a locality by name: STREET_ID, names in UA and EN, street type. Read-only
ukrposhta_get_house_postcodeThe postcode of a house on a street: house number and POSTCODE. Read-only

Example prompts

  • "Where is Ukrposhta parcel 0503112345678?"
  • "Show the last status of these 10 barcodes from yesterday's dispatch."
  • "How much does a 2 kg parcel from Kyiv 01001 to Lviv 79000 cost?"
  • "Which post offices are near postcode 65000, and when are they open on Saturday?"
  • "Download the label of shipment 0503112345678."

FAQ

Does it work with Claude Code as well as Claude Desktop? Yes, point both at https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

Where do the keys come from? Only from a business contract: Ukrposhta sends the production eCom bearer, the StatusTracking bearer and the counterparty token in an annex to your API contract. Sandbox keys do not work here.

What does it cover? Tracking, your shipments and groups, PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with regions, localities, streets, postcodes and post offices with opening hours.

Which tools install switched off? ukrposhta_create_shipment and ukrposhta_delete_shipment. Switch them on on the connector page only if the AI should create or delete shipments.

Next steps

Was this guide helpful?

Connect Ukrposhta to Claude in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Ukrposhta in the guided setup, then add your MCP URL to Claude. No code and no server to run.

Related guides

Connectors

Connect Ukrposhta to ChatGPT via MCP

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

Connectors

Connect Ukrposhta to Microsoft Copilot via MCP

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

Connectors

Connect Ukrposhta to Cursor via MCP

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

Connectors

Connect Ukrposhta to Gemini CLI via MCP

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

Connectors

Connect Ukrposhta to Meta Muse via MCP

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.

Connectors

Ukrposhta MCP Server: Tracking, Prices and Post Offices

Ukrposhta (Укрпошта) API for business customers in Ukraine: shipment tracking, shipments and PDF labels, domestic price estimates, route checks, clients and addresses, and the address classifier with post offices and opening hours. Creating and deleting shipments installed switched off. Contract bearers and counterparty token.