Novaposhta

50 tools. 16 can modify or destroy data without limits.

5 destructive tools with no built-in limits. Policy required.

Last updated:

16 can modify or destroy data
34 read-only
50 tools total

Community server · catalogue entry verified 05/07/2026

How to control Novaposhta ↓

What Novaposhta exposes to your agents

Read (34) Write / Execute (11) Destructive / Financial (5)
Critical Risk

The most dangerous Novaposhta tools

16 of Novaposhta's 50 tools can modify, destroy, or commit something on every call — and an agent calls them with no built-in limits.

How to control Novaposhta

PolicyLayer is an MCP gateway — it sits between your AI agents and Novaposhta, and nothing reaches the server without passing your rules. These are the rules we recommend:

Deny destructive operations
{
  "address_delete": {
    "deny_if": [
      {
        "conditions": [],
        "on_deny": "Blocked by default. Requires approval."
      }
    ]
  }
}

Destructive tools should never be available to autonomous agents without human approval.

Rate limit write operations
{
  "address_save": {
    "limits": [
      {
        "counter": "address_save_per_hour",
        "window": "hour",
        "max": 30,
        "scope": "grant"
      }
    ]
  }
}

Prevents bulk unintended modifications from agents caught in loops.

Cap read operations
{
  "address_get_settlement_country_region": {
    "limits": [
      {
        "counter": "address_get_settlement_country_region_per_minute",
        "window": "minute",
        "max": 60,
        "scope": "grant"
      }
    ]
  }
}

Controls API costs and prevents retry loops from exhausting upstream rate limits.

  1. Create a free account and register Novaposhta — nothing to install.
  2. Add these rules — paste them, or build them visually. Tune the limits to your setup.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
ENFORCE POLICY ON NOVAPOSHTA →

Instant setup, no code required.

All 50 Novaposhta tools

WRITE 11 tools
Write address_save Create new address for a counterparty via Address/save (doc 1.24). Requires API key plus CounterpartyRef, Stre Write address_update Update existing counterparty address with Address/update (doc 1.25). Nova Poshta docs stress you can edit an a Write contact_person_save Create new contact person for a counterparty via ContactPerson/save (doc 1.26). Docs require entering all fiel Write contact_person_update Update existing contact person details via ContactPerson/update (doc 1.27). Only legal entities may edit full Write counterparty_save Create new counterparty (private person or organization) with Counterparty/save (docs 1.20–1.21). Provide City Write counterparty_update Update existing counterparty details via Counterparty/update (doc 1.22). Nova Poshta only lets you edit a coun Write waybill_create Create a standard Nova Poshta waybill (Internet document) via InternetDocument/save (doc 1.2). This is the bas Write waybill_create_batch Batch create multiple waybills sequentially via InternetDocument/save (doc 1.2). Processes each waybill one by Write waybill_create_for_postomat Create a waybill for postomat delivery via InternetDocument/save (doc 1.2). Postomats have size/weight restric Write waybill_create_with_options Create a Nova Poshta waybill with additional options and services via InternetDocument/save (doc 1.2). Support Write waybill_update Update an existing waybill. Per doc 1.2 the same InternetDocument request envelope is used for update calls, s
READ 34 tools
Read address_get_settlement_country_region Get settlement country regions (регіонів) for a specific area via Address/getSettlementCountryRegion (doc 1.3) Read address_get_settlements Get settlement areas (областей) via Address/getSettlementAreas (doc 1.3). Returns list of administrative regio Read address_get_warehouses List Nova Poshta warehouses (branches, postomats, pickup points) via Address/getWarehouses (doc 1.5). Docs emp Read address_search_cities Find Nova Poshta cities by name or postal index using Address/getCities (doc 1.3). Docs note the city director Read address_search_settlements Search for settlements (city, town, village) with pagination over the same Address/getCities dataset described Read address_search_streets Search for streets inside a settlement via Address/getStreet (doc 1.4). Used for door pickup/delivery flows, l Read counterparty_get_addresses Get addresses for a specific counterparty using Counterparty/getCounterpartyAddresses (doc 1.6). Requires API Read counterparty_get_contact_persons Get contact persons for a counterparty through Counterparty/getCounterpartyContactPersons (doc 1.6). API key i Read counterparty_get_counterparties Get counterparties list filtered by property (Sender/Recipient/ThirdPerson) via Counterparty/getCounterparties Read counterparty_get_options Get counterparty options and permissions via Counterparty/getCounterpartyOptions (doc 1.23) to see booleans su Read get_document_list List documents created in the given date range. Per doc 1.2, these queries target the InternetDocument model u Read get_document_movement Get movement history for up to 10 documents including statuses and timestamps. Doc 1.2 identifies InternetDocu Read reference_decode_message Decode Nova Poshta API message code into human readable text. Doc 1.2 explains how every response contains suc Read reference_get_backward_cargo_types List backward delivery cargo types via Common/getBackwardDeliveryCargoTypes (doc 1.18). Returns types of cargo Read reference_get_cargo_description_list List cargo descriptions with optional search via Common/getCargoDescriptionList (doc 1.15). Returns predefined Read reference_get_cargo_types List available cargo types supported by Nova Poshta via Common/getCargoTypes (doc 1.8). Docs advise caching th Read reference_get_ownership_forms List corporate ownership forms required for counterparty creation via Common/getOwnershipFormsList (doc 1.11). Read reference_get_pack_list List available packaging types via Common/getPackList (doc 1.10). Returns standard package dimensions and desc Read reference_get_pallet_types List pallet types with dimensions and weight via Common/getPalletsList (doc 1.13). Refresh monthly per docs, e Read reference_get_payment_forms Get list of payment forms (Cash/NonCash) for waybill creation with Common/getPaymentForm (doc 1.7). Nova Posht Read reference_get_payment_methods List supported payment methods for shipments (Cash/NonCash) matching the Common/getPaymentForm directory from Read reference_get_pickup_time_intervals Get available pickup time intervals via Common/getPickupTimeIntervals (doc 1.17). Returns time windows when No Read reference_get_redelivery_payers List payer types for redelivery via Common/getTypesOfPayersForRedelivery (doc 1.19). Returns who can pay for b Read reference_get_service_types List delivery service types (warehouse-door etc.) through Common/getServiceType (doc 1.9). Docs say to refresh Read reference_get_time_intervals Get available delivery time intervals for recipient city using Common/getTimeIntervals (doc 1.16). Requires Re Read reference_get_tires_wheels_list List available tires and wheels types via Common/getTiresWheelsList (doc 1.12). Returns types and descriptions Read reference_get_types_of_counterparties Get list of counterparty types (PrivatePerson/Organization) via Common/getTypesOfCounterparties (doc 1.14). Re Read reference_get_types_of_payers Get list of payer types (Sender/Recipient/ThirdPerson) for waybill creation via Common/getTypesOfPayers (doc 1 Read track_document Track a single Nova Poshta document by number and optional phone to receive live status, location, and ETA. Do Read track_multiple Track multiple Nova Poshta documents with organized results and statistics via TrackingDocument/getStatusDocum Read track_multiple_documents Track multiple Nova Poshta documents at once and receive aggregated statistics. Doc 1.2 states every API call Read waybill_calculate_cost Calculate delivery cost and optional delivery date estimation for a shipment. Doc 1.2 explains that every Nova Read waybill_get_delivery_date Get estimated delivery date for a city pair and service type. Doc 1.2 outlines the generic Nova Poshta envelop Read waybill_get_estimate Get complete shipment estimate (price + delivery date) in one call via InternetDocument/getDocumentPrice and g

Related servers

Other MCP servers with similar tools — same risk classification, starter policies for each.

Questions about Novaposhta

Can an AI agent delete data through the Novaposhta MCP server? +

Yes. The Novaposhta server exposes 5 destructive tools including address_delete, contact_person_delete, counterparty_delete. These permanently remove resources with no undo. PolicyLayer blocks destructive tools by default so they never reach the upstream server.

How do I prevent bulk modifications through Novaposhta? +

The Novaposhta server has 11 write tools including address_save, address_update, contact_person_save. Set a rate limit in your policy -- for example, 10 calls per hour prevents an agent from making more than 10 modifications per hour. PolicyLayer enforces this at the gateway, before calls reach Novaposhta.

How many tools does the Novaposhta MCP server expose? +

50 tools across 3 categories: Destructive, Read, Write. 34 are read-only. 16 can modify, create, or delete data.

How do I enforce a policy on Novaposhta? +

Register the Novaposhta MCP server in PolicyLayer, apply the suggested rules above (adjust the limits to your use case), and point your AI client at the PolicyLayer proxy URL instead of the server directly. Your agents keep the same tools; PolicyLayer evaluates every call against policy before it executes. Nothing to install, live in minutes.

Enforce policy on every Novaposhta tool call.

Deterministic rules across all 50 Novaposhta tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

Instant setup, no code required.

50 Novaposhta tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.