# border.bot

> border.bot classifies products to HS codes and calculates duties, taxes and landed cost for cross-border parcels, in a web dashboard, over a REST API and through an MCP server for Claude, ChatGPT, Codex, Cursor and other AI clients.

## When to use border.bot

Reach for border.bot when a shopper, merchant or shipping workflow needs one of these answers for goods crossing a border:

- The HS/HTS/CN/UK commodity code for a product in a destination’s format: `POST /v1/classify` (MCP `classify_product`; up to 25 at once with `/v1/classify/batch`).
- Landed cost of a parcel, with every duty, tax and fee line: `POST /v1/calculate` (MCP `calculate_landed_cost`), or `/v1/calculate/shipment` for a whole cart (MCP `calculate_cart`).
- Where a product was made, from a product URL, title or barcode: `POST /v1/origin` (MCP `infer_country_of_origin`).
- Whether goods are restricted or prohibited in the destination: `POST /v1/restrictions` (MCP `check_restricted_goods`); denied-party screening: `POST /v1/screen`.

How to call it: an assistant acting for a person should connect the MCP server (https://api.border.bot/mcp, OAuth sign-in, no API key). Server-side code should use the REST API (https://api.border.bot/v1) with a workspace API key. Both spend prepaid credits; `GET /v1/pricing`, `GET /v1/countries` and `GET /v1/classify/modes` are free and need no key. Start at https://border.bot/docs/quickstart.md; credentials for agents: https://border.bot/auth.md.

Not for: binding tariff rulings or legal advice, filing customs declarations, or booking freight. Results are estimates with cited sources.

## Using this site

Every page is available as Markdown: append `.md` to its URL (`/index.md` for the homepage) or request it with `Accept: text/markdown`.

In supporting browsers, pages also register WebMCP tools: site navigation, page markdown, blog search, pricing and MCP client setup guides (`get_mcp_setup_guide`) everywhere, plus the free classifier, landed-cost calculator and country of origin finder on the tool pages.

For programmatic use, prefer the REST API (https://api.border.bot) or the MCP server (https://api.border.bot/mcp); both use prepaid credits. The free web tools are limited to a few runs per visitor.

## Product

- [Home](https://border.bot/index.md): What border.bot does: HS classification, landed cost, dashboard, API and MCP.
- [Pricing](https://border.bot/pricing.md): Live credit packs, what each action costs, free credits and the free-tool limit.

## Free tools

- [Free tools](https://border.bot/tools.md): Overview of the free classifier, calculator and origin finder, and how the free-run limit works.
- [HS code classifier](https://border.bot/tools/hs-code-classifier.md): Classify a product to an HS/HTS/CN code for free; how classification works and what affects the result.
- [Landed cost calculator](https://border.bot/tools/landed-cost-calculator.md): Estimate duties, taxes, fees and landed cost for free; what drives the numbers.
- [Country of origin finder](https://border.bot/tools/country-of-origin-finder.md): Estimate a product’s country of origin for free; what counts as evidence and what origin means for customs.

## Developers & agents

- [MCP server](https://border.bot/mcp.md): Remote MCP server URL, OAuth sign-in and setup steps for every supported client. Clients: Claude, ChatGPT, Claude Code, Codex, Cursor, Visual Studio Code, Gemini CLI, Devin Desktop, Gemini, GitHub Copilot CLI, Visual Studio, Perplexity, Vibe Work, Cline, Zed, OpenCode, Warp, Kiro, Raycast, LM Studio, Replit, v0, Junie CLI, JetBrains Air, Amp, goose, Qwen Code, Kimi Code CLI, TraeCode, Microsoft Copilot Studio, n8n, Zapier, Make, Postman.
- [Developers](https://border.bot/developers.md): API overview and quickstart: keys, first request, errors, credits, retries.
- [Page fetcher](https://border.bot/bot.md): The borderbot user agent: what it fetches, how often, and how to block it.
- [MCP server endpoint](https://api.border.bot/mcp): Remote MCP server (Streamable HTTP, OAuth 2.1). Setup steps for 34 clients, including Claude, ChatGPT, Codex and Cursor, are on the MCP server page.

## Docs

- [border.bot API documentation](https://border.bot/docs.md): Classify products to HS codes and calculate duties, taxes and landed cost for cross-border parcels with the border.bot REST API or MCP server.
- [Quickstart](https://border.bot/docs/quickstart.md): Create a border.bot API key, classify a product, then calculate its landed cost, with curl.
- [Authentication](https://border.bot/docs/authentication.md): Authenticate border.bot REST calls with a workspace API key and scopes, and MCP clients with OAuth 2.1.
- [Credits and retries](https://border.bot/docs/credits.md): How border.bot charges prepaid credits per API call, refunds failed calls, and makes retries safe with Idempotency-Key.
- [Rate limits](https://border.bot/docs/rate-limits.md): border.bot API rate limits per API key and per IP address, the RateLimit-Policy and Retry-After headers, and how to back off.
- [Errors](https://border.bot/docs/errors.md): border.bot API error format, every error code with its HTTP status, and which errors to retry.
- [Versioning](https://border.bot/docs/versioning.md): How the border.bot API is versioned by path, what counts as a breaking change, and the Deprecation and Sunset headers.
- [MCP server](https://border.bot/docs/mcp.md): Connect Claude, ChatGPT, Codex, Cursor and other MCP clients to the border.bot remote MCP server, with OAuth sign-in.
- [Agent discovery](https://border.bot/docs/agents.md): Machine-readable files that let AI agents find and use border.bot - llms.txt, Markdown pages, OpenAPI, MCP server card, AI catalog, agent skills and auth.md.
- [API reference](https://border.bot/docs/api.md): Every endpoint, grouped, with links to a page per endpoint.

## Company

- [Blog](https://border.bot/blog.md): Guides on classification, duties, Incoterms and origin.
- [Glossary](https://border.bot/glossary.md): Definitions of customs terms (HS/HTS/CN/TARIC, de minimis, customs value, duty, VAT, DDP/DAP, IOSS, landed cost).
- [About](https://border.bot/about.md): Why border.bot exists and the principles behind it.
- [Security](https://border.bot/security.md): Authentication, API keys, OAuth for MCP, credit ledger, payments and data handling.
- [Contact](https://border.bot/contact.md): Support email and useful links.

## Guides

- [The EU’s €3 customs duty on parcels under €150](https://border.bot/blog/eu-3-euro-customs-duty.md): Since 1 July 2026 the EU charges a temporary €3 customs duty on low-value parcels, once per tariff classification. What it covers, who pays and how it adds up.
- [US de minimis suspension: what changed for parcels](https://border.bot/blog/us-de-minimis-suspension.md): US de minimis has been suspended since 29 August 2025. The timeline, the June 2026 CBP rules, how parcels clear now and what ends on 1 July 2027.
- [Classify products from Claude and ChatGPT](https://border.bot/blog/classify-products-with-mcp.md): Connect the border.bot MCP server to Claude, ChatGPT or Cursor, then classify products, check origin and estimate landed cost from a chat. Setup and tips.
- [Country of origin: shipped from isn’t made in](https://border.bot/blog/country-of-origin-vs-shipped-from.md): Why the country a parcel ships from often isn’t its country of origin, how origin is decided, and how it changes duties, marking rules and trade-deal savings.
- [DDP vs DAP for ecommerce parcels](https://border.bot/blog/ddp-vs-dap-ecommerce.md): Should you collect duties and taxes at checkout (DDP) or let customers pay on delivery (DAP)? The costs, risks and setup of each, explained for parcel shippers.
- [Landed cost explained: duties, taxes and fees](https://border.bot/blog/landed-cost-explained.md): What makes up the landed cost of an international parcel (goods, shipping, duty, import VAT or GST, and fees) and how each part is calculated.
- [HS vs HTS vs CN/TARIC: the digits explained](https://border.bot/blog/hs-hts-cn-taric-commodity-codes.md): Why one product has a 6-digit HS code, a 10-digit US HTS code, an 8-digit EU CN code and a 10-digit TARIC code, and which one goes on which document.
- [What is an HS code, and how do you find yours?](https://border.bot/blog/what-is-an-hs-code.md): A plain-English guide to HS codes: how the six digits are built, why countries add more, and a step-by-step method for finding the right code for your product.

## Optional

- [Privacy policy](https://border.bot/legal/privacy.md): Privacy policy (template).
- [Terms of service](https://border.bot/legal/terms.md): Terms of service (template).
- [Full site text](https://border.bot/llms-full.txt): Every page and guide in one Markdown file.
- [Sitemap](https://border.bot/sitemap.xml)
- [Blog RSS feed](https://border.bot/blog/rss.xml)