# Zentria Flow

> Zentria Flow is a freemium MCP server for freight and logistics. US tariff layers by HTS code and origin, origin comparison and landed cost for importers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://zentriaflow.com/developers
- **Repository:** https://github.com/orhansavash/zentria-flow-mcp
- **MCP Registry name:** io.github.orhansavash/zentria-flow-mcp
- **Categories:** freight and logistics, e-commerce
- **Listing updated:** 2026-11-15

## About

Zentria Flow is a landed-cost and US tariff engine for importers, and this server lets an assistant look up duties instead of answering from memory. us_tariff_check returns every tariff layer for one HTS code and origin, including MFN duty, China Section 301, the forced-labor Section 301 tariff, Section 232 and Section 338 on Canada, plus exemptions, USMCA and CAFTA-DR cases and dated changes ahead.

Compare_origins runs the check for two to six origins, lowest total first, and hts_search finds eight-digit HTSUS lines. These three tools need no account or key. landed_cost needs a ZENTRIA_API_KEY and covers freight, insurance, duty layers, VAT or GST and fees for 70+ countries. Each answer carries the date checked and HTSUS revision.

Results are planning estimates, not customs rulings, and Zentria Flow is software, not a customs broker. It is a dependency-free Node.js program, also available as a Docker image.

## Features

- **Tariff layers:** All US tariff layers for an HTS code and origin.
- **Origin comparison:** Compare 2 to 6 origins by total duty.
- **HTSUS search:** Find 8-digit lines by product words.
- **Landed cost:** Full shipment cost for 70+ countries with a key.
- **Dated answers:** Includes check date and HTSUS revision.
- **Structured output:** JSON alongside the text summary.

## Good for

- Check the duty on a product from China
- Compare sourcing countries by total tariff
- Find the right HTS line for a product
- Estimate landed cost before ordering

## Install

### Claude Code (Terminal)

```sh
claude mcp add zentria-flow-mcp --env ZENTRIA_API_KEY='<ZENTRIA_API_KEY>' -- docker run -i --rm -e ZENTRIA_API_KEY ghcr.io/orhansavash/zentria-flow-mcp:0.2.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zentria-flow-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZENTRIA_API_KEY",
        "ghcr.io/orhansavash/zentria-flow-mcp:0.2.0"
      ],
      "env": {
        "ZENTRIA_API_KEY": "<ZENTRIA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "zentria-flow-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZENTRIA_API_KEY",
        "ghcr.io/orhansavash/zentria-flow-mcp:0.2.0"
      ],
      "env": {
        "ZENTRIA_API_KEY": "<ZENTRIA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "zentria-flow-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZENTRIA_API_KEY",
        "ghcr.io/orhansavash/zentria-flow-mcp:0.2.0"
      ],
      "env": {
        "ZENTRIA_API_KEY": "<ZENTRIA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zentria-flow-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZENTRIA_API_KEY",
        "ghcr.io/orhansavash/zentria-flow-mcp:0.2.0"
      ],
      "env": {
        "ZENTRIA_API_KEY": "<ZENTRIA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zentria-flow-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ZENTRIA_API_KEY",
        "ghcr.io/orhansavash/zentria-flow-mcp:0.2.0"
      ],
      "env": {
        "ZENTRIA_API_KEY": "<ZENTRIA_API_KEY>"
      }
    }
  }
}
```

## Tools

- `us_tariff_check`: Returns every US tariff layer for an HTS code and origin.
- `compare_origins`: Runs the tariff check for 2 to 6 origins.
- `hts_search`: Finds 8-digit HTSUS lines by product words or code.
- `landed_cost`: Computes full landed cost; needs an API key.

## FAQ

### Which tools need a key?

Only landed_cost; the other three work without one.

### Is it customs advice?

No; results are planning estimates.

### How do I run it?

npx -y github:orhansavash/zentria-flow-mcp, needing Node.js 18 or newer.

### Are API plans paid?

API access needs a Professional or Enterprise subscription or a paid API plan; a sandbox gives 100 calls a month.

### Is Zentria Flow free?

Zentria Flow has a free plan, with paid plans for more usage or features.

### How do I add Zentria Flow to Claude Code?

Run this command in your terminal: claude mcp add zentria-flow-mcp --env ZENTRIA_API_KEY='<ZENTRIA_API_KEY>' -- docker run -i --rm -e ZENTRIA_API_KEY ghcr.io/orhansavash/zentria-flow-mcp:0.2.0

### What are the best alternatives to Zentria Flow?

The closest alternatives to Zentria Flow are O'So MCP Server for PrestaShop, SecureCloud, MadMax Trade Supply parts, Renta and Shopify MCP Server (any store).

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [repairinfo](https://ai-powered.com/mcp/repairinfo): repairinfo is a freemium MCP server for analytics and data.
- [bxmcp — 1C-Bitrix site assistant](https://ai-powered.com/mcp/bxmcp-1c-bitrix-site-assistant): bxmcp — 1C-Bitrix site assistant is a freemium MCP server for e-commerce.
- [Suawave](https://ai-powered.com/mcp/suawave): Suawave is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/zentria-flow
