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 Meta Muse in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Ukrposhta in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
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.
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 + Meta Muse
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
- Sign a contract for the API with Ukrposhta (business customer service, [email protected]). With the contract you receive an annex with your production keys.
- Copy PRODUCTION BEARER eCom into
UKRPOSHTA_ECOM_BEARER, PRODUCTION BEARER StatusTracking intoUKRPOSHTA_TRACKING_BEARERand PROD_COUNTERPARTY TOKEN intoUKRPOSHTA_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 Muse
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 showsYOUR_SERVER_ID.
Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.
- In Muse, open Settings → Connectors and choose Add custom connector.
- Paste the MCP server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse opens the AnythingMCP sign-in page: sign in and approve access.
- In a chat, ask Muse for something that needs the
Ukrposhtatools.
You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
ukrposhta_track_shipment | Full 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_status | The latest status of one shipment by barcode: date, post office index and name, event code, eventName and eventReason. Read-only |
ukrposhta_get_last_statuses | The 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_route | Where a shipment travels from and to (country and locality) by barcode. Read-only |
ukrposhta_get_shipment | Read one shipment of your account by uuid: barcode, type, sender and recipient clients with addresses, deliveryType, parcels (weight… |
ukrposhta_get_shipment_by_barcode | Read one shipment of your account by its barcode (same fields as ukrposhta_get_shipment). Read-only |
ukrposhta_list_sender_shipments | List the shipments created for one sender client: uuid, barcode, recipient, deliveryType, parcels, prices and lifecycle status. Read-only |
ukrposhta_get_shipment_lifecycle | Current status of one shipment from the eCom side: shipmentUuid, shipmentBarcode, status (CREATED, REGISTERED, DELIVERING, IN_DEPARTMENT… |
ukrposhta_list_shipment_groups | List the shipment groups (registers for form 103a) of one client: uuid, name, type, created date, closed flag and number of shipments.… |
ukrposhta_list_group_shipments | List the shipments in one shipment group: uuid, barcode, recipient, parcels, prices and lifecycle status. Read-only |
ukrposhta_get_label | Download 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_price | Estimate the price of a shipment within Ukraine before creating it: deliveryPrice in UAH, rawDeliveryPrice, postPayDeliveryPrice… |
ukrposhta_check_route | Check that Ukrposhta delivers between two postcodes: code (SUCCESS when available), description and mrtps (where the mobile post office of… |
ukrposhta_get_client | Read one client (sender or recipient) of your account: uuid, type (INDIVIDUAL, PRIVATE_ENTREPRENEUR, COMPANY), name, firstName, lastName… |
ukrposhta_find_clients_by_phone | Find the clients of your account with a phone number: uuid, name, type, addresses. Read-only |
ukrposhta_get_address | Read an address created with ukrposhta_create_address: id, postcode, region, district, city, street, houseNumber, apartmentNumber, country… |
ukrposhta_create_address | Create 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_client | Create a client (sender or recipient) on an address from ukrposhta_create_address. Individuals and private entrepreneurs need first_name… |
ukrposhta_create_shipment | Create 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_shipment | Delete a shipment that is still in status CREATED (not yet handed in). Cannot be undone. Installed switched off |
ukrposhta_find_post_offices_by_postcode | Post offices that serve a postcode: ID, PO_SHORT and PO_LONG (name), ADDRESS, PHONE, TYPE_LONG, LATITUDE, LONGITUDE, POSTTERMINAL… |
ukrposhta_find_post_offices_near | Post offices near a point, nearest first: ID, name, address, postcode, distance, coordinates and type. Read-only |
ukrposhta_get_post_office_hours | Opening hours of a post office by postcode: per weekday the opening and closing time and breaks. Read-only |
ukrposhta_get_city_by_postcode | The locality, district and region of a postcode, with their ids. Read-only |
ukrposhta_search_regions | Find 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_districts | Find districts of a region by name: DISTRICT_ID, names in UA and EN, region. Read-only |
ukrposhta_search_cities | Find localities by name, optionally within a region and district: CITY_ID, names in UA and EN, type (city, village), district, region and… |
ukrposhta_search_streets | Find streets of a locality by name: STREET_ID, names in UA and EN, street type. Read-only |
ukrposhta_get_house_postcode | The 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
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.
Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.
Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.
Next steps
Was this guide helpful?