Find Nova Post divisions
get_divisionsSearches for Nova Post branches, parcel lockers and other service points.
Connection
Get started in three steps
Add the server URL to your AI agent through MCP. No separate plugin or Nova Post API key in the chat is required.
01Add a connector
Enter the MCP endpoint in ChatGPT, Claude, Cursor or another compatible app to connect your AI agent.
02Authorize
During connection, a standard sign-in page will open. Sign in as usual and approve access for the AI agent.
03Describe the task
The AI agent will choose the right tool on its own and, depending on your settings, ask for confirmation before changing data.
{
"mcpServers": {
"nova-post": { "url": "https://mcp.novapost.com/mcp" }
}
}
Capabilities
Write it your way
You do not need to know technical tool names — just describe the result you need.
Find a cargo branch on Horodotska Street in Lviv.
Calculate the delivery cost for a 2 kg parcel from Kyiv to Warsaw.
Which parcels are on their way to me?
Duplicate the last shipment I created.
Access and security
Secure MCP connection
Authorization uses the standard OAuth 2.1 / OIDC flow, and access to operations is granted only after user confirmation.
1
Sign in with Nova Post
You sign in on Nova Post's secure page. Your login and password are never shared with the AI agent.
2
Only the access you need
The AI agent does not get direct access to your account or all of its data. It can only use the available MCP operations within your granted permissions.
3
Protected by MCP
MCP keeps authorization tokens on the server and gives the agent only the result of the requested operation, never your credentials.
Confirmation is required before changes
Creating, fully updating and deleting shipments are performed only after the user's explicit consent.
Delivery tools
Locations
Search settlements, streets, divisions, parcel lockers and other service points.
Find Nova Post settlements
get_settlementsSearches for Nova Post settlements by name and returns the exact settlementId needed to find divisions.
Find Nova Post streets
get_streetsSearches for Nova Post street records by name and country ISO code.
Dictionaries
Currencies, measurement units, customs classifications and restrictions.
Get measurement units
get_dictionary_measurementsReturns the supported measurement units for cargo weight, dimensions and quantity.
Get supported currencies
get_dictionary_currenciesReturns the currencies that can be used for shipments and customs data.
Search cargo classifier
get_dictionary_classifierSearches for a customs HS code or cargo classification by keyword, country and response language.
Get customs settings by country
get_dictionary_customs_fees_codeReturns customs restrictions and declared-value thresholds for a country specified by its ISO code.
Calculations
Estimate delivery costs, timeframes and available services.
Calculate shipment cost
post_shipments_calculationsCalculates the price, delivery time and available delivery types before a shipment is created or changed.
Tracking
Shipment statuses, movement history and delivery details.
Get past shipment movement timeline
get_shipments_tracking_historyReturns a shipment's movement history by its number and can include related shipments when requested.
Get full shipment tracking
get_shipments_trackingReturns detailed tracking events, locations and delivery information by shipment number or ID.
Shipments
Create, view, edit and delete shipments.
Download shipment documents
get_shipments_printGenerates official PDF documents for one or more shipments — a label, international document or invoice — and returns temporary download links.
Find shipments
get_shipmentsReturns existing shipments and supports searching by shipment number, ID, register or sender division.
Create shipment
post_shipmentsCreates a real shipment after the user explicitly confirms the operation.
Delete shipment
delete_shipments_idPermanently deletes a specific shipment by its exact ID and requires explicit user confirmation.