Novaposhta MCP Server - install, status & alternatives [2026]

01 · Install Novaposhta

before you install - you'll need

Set NOVA_POSHTA_API_KEY before connecting.

Claude Code

claude mcp add shopanaio-carrier-api -- npx -y @shopana/novaposhta-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "shopanaio-carrier-api": {
      "command": "npx",
      "args": [
        "-y",
        "@shopana/novaposhta-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @shopana/novaposhta-mcp-server - the @shopana scope differs from the repo owner (shopanaio); confirm it's the project's official package

registry namespace io.github.shopanaio is GitHub-verified and matches the repo owner

03 · What Novaposhta can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

@shopana/[email protected] · 2026-08-17

Add automated package publishing and correct Nova Poshta postomat service handling. · Updated dependencies [b1c78f9] · - @shopana/[email protected] · All notable changes to the Nova Poshta MCP Server will be…

@shopana/[email protected] · 2026-08-17

Add automated package publishing and correct Nova Poshta postomat service handling. · All notable changes to this project will be documented in this file. · The format is based on Keep a Changelog, · and this project…

@shopana/[email protected] · 2026-08-17

Add automated package publishing and correct Nova Poshta postomat service handling. · All notable changes to this project will be documented in this file. · The format is based on Keep a Changelog, · and this project…

04 · Who maintains Novaposhta

novaposhta is maintained by shopanaio. It's the only MCP server we track from this author; the repo dates to Sep 2025.

05 · Facts

repository: github.com/shopanaio/carrier-api
category: e-commerce - ranked #7 of 39 actively-maintained e-commerce servers as of 2026-08-25.
release cadence: 3 releases in the last 90 days (latest 2026-08-17)
registry: io.github.shopanaio/novaposhta (active, first published 2025-11-20 · 2 versions)
packages: npm:@shopana/novaposhta-mcp-server

06 · Novaposhta FAQ

What is Novaposhta?

Modern type-safe API clients for shipping carriers Features • Packages • Quick Start • Documentation • Contributing. It runs locally over stdio via the published package.

Is Novaposhta still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-18 and it shipped 3 releases in the last 90 days. We re-verify nightly.

How do I install Novaposhta?

Run `npx -y @shopana/novaposhta-mcp-server`. The README documents one environment variable (NOVA_POSHTA_API_KEY) to set first. Set NOVA_POSHTA_API_KEY before connecting. You can also paste the ready-made client config above.

Does Novaposhta run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Novaposhta

Alternatives to Novaposhta

Maintained e-commerce servers if Novaposhta isn't the fit.

More e-commerce MCP servers · Cellar Tracker · Presso · Moysklad MCP · Easy Digital Downloads