> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consile.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webshipper

> Orders, shipments and tracking, shipping costs, shipping rates, drop points and returns from Webshipper, plus booking shipments and correcting orders with a preview before every change, directly from your AI.

*[Læs siden på dansk](https://docs.consile.ai/connectors/webshipper.md)*

The Webshipper connector gives your AI access to the shipping from your webshop in
Webshipper: orders with status and error message, shipments with tracking,
shipping costs per carrier, shipping rates, drop points, carriers, order channels
and returns. It can also book a shipment for an order, correct an order before it
ships and create a manual order, always behind a preview that you must confirm.
You connect with your account name and an API token that you create yourself in
Webshipper, and your AI never sees the token itself.

> [!NOTE]
>
> **Read + guardrailed write.** 12 tools only read. The 3 write tools change
> nothing in Webshipper without an explicit confirmation (`confirm: true`).
> Without it, you only get a preview. Booking a shipment buys postage from the
> carrier, and the carrier or the shop can notify the recipient. An administrator
> can set the individual user to **Read only**. See
> [Actions & guardrails](https://docs.consile.ai/en/essentials/actions-and-guardrails.md).

> [card] Access
>
> Read + guardrailed write. Read only can be chosen per user

> [card] Authentication
>
> Account name and API token from Webshipper

> [card] Hosting
>
> Hosted in the EU · Frankfurt

* **Price:** 299 DKK/month excl. VAT (€39/month if you have chosen the EU · EUR
  market in the portal). No lock-in, cancel at any time. The price covers 1 user
  and 1 Webshipper account. Each extra user and each extra account costs 149.50
  DKK/month excl. VAT. See [Pricing](https://docs.consile.ai/en/portal/pricing.md). Webshipper is also
  included in [the Consile Studio membership](https://docs.consile.ai/en/portal/membership.md) and
  [the free edition](https://docs.consile.ai/en/portal/free-edition.md).
* **One account per connection:** an API token belongs to one Webshipper account
  (for example `myshop.webshipper.io`). If you have several accounts, for example
  one per brand or country, you connect one agreement per account. Each extra
  agreement gets its own address, for example
  `https://mcp.consile.ai/webshipper-2/mcp`. See
  [Multiple agreements](https://docs.consile.ai/en/connect/connect-webshipper.md#multiple-agreements).
* **Endpoint:** `https://mcp.consile.ai/webshipper/mcp` (your own named connector
  in your AI).

## Prerequisites

**1. Subscription**

An administrator buys the connector in the [portal](https://app.consile.ai). See
[Buy a connector](https://docs.consile.ai/en/portal/buy-a-connector.md).

**2. Your AI connected**

See [Connect Claude](https://docs.consile.ai/en/connect/connect-claude.md) or
[Connect ChatGPT](https://docs.consile.ai/en/connect/connect-chatgpt.md).

**3. Webshipper Pro or Advanced**

API access comes with Webshipper Pro and Advanced. On another plan you cannot
create the API token the connector uses.

**4. Webshipper connected**

Create an API token in Webshipper under **Settings → Access and tokens**, and
paste it in the portal together with the account name. See
[Connect Webshipper](https://docs.consile.ai/en/connect/connect-webshipper.md).

**5. Access for each user**

Whoever buys Webshipper automatically gets the included access. If more
colleagues need Webshipper in their AI, an administrator gives them access on
the person's page under **Team** and chooses their access level at the same
time (see [Access level per user](#access-level-per-user)). Each extra user
costs 149.50 DKK/month excl. VAT. If you have
[the Consile Studio membership](https://docs.consile.ai/en/portal/membership.md), an administrator
instead gives one membership licence per person, and it also covers Webshipper.
See [Team](https://docs.consile.ai/en/portal/team.md).

> [!NOTE]
>
> **Were you a customer before 2026-11-17?** If your organization has a membership
> or a free edition from before Webshipper was added, Webshipper's tools are
> switched off until an administrator switches them on under
> [Tools](https://docs.consile.ai/en/portal/tools.md). New customers get both the read and the write tools
> switched on from the start.

## What can it do? (tools)

You do not need to know the tool names. You ask in natural language, and your AI
picks and calls the right tool itself. Each tool is called `webshipper__<tool>`
(for example `webshipper__search_orders`); in the tables below the names are shown
without the prefix.

The connector provides 15 tools in total: 12 read-only and 3 guardrailed write
tools. A user on **Read only** only gets the 12.

### Reading (12 read-only)

**Orders**

| Tool | What it does |
| - | - |
| `search_orders` | Orders filtered by status (for example failed orders), the shop's order number, free text, date, order channel, country or tag, with recipient and Webshipper's error message |
| `get_order` | One order with order lines, delivery, billing and sender address, drop point, shipping rate and the shop's original shipping choice |

**Shipments & tracking**

| Tool | What it does |
| - | - |
| `search_shipments` | Shipments for an order or by tracking number, reference, date or country, with carrier, tracking link, latest status and price |
| `get_shipment` | One shipment with the carrier's tracking events, packages with weight and size, addresses, add-ons and cost and sales price |

**Shipping rates & costs**

| Tool | What it does |
| - | - |
| `summarize_shipping_costs` | Number of shipments, cost price and sales price per carrier and currency for a period of up to 92 days |
| `quote_shipping_rates` | Which of an order channel's shipping rates fit a parcel, and what they cost the customer at checkout |
| `quote_carrier_services` | One carrier's services for the given packages with the carrier's cost price and estimated delivery day; nothing is booked |
| `list_shipping_rates` | The shipping rates per order channel with carrier, service code, whether a drop point is required and whether they are hidden or for returns |

**Drop points, setup & returns**

| Tool | What it does |
| - | - |
| `find_drop_points` | Up to 20 of the nearest parcel shops and lockers for an address with id, address, coordinates and opening hours |
| `list_carriers` | The carrier agreements on the account with name, test mode and services; the agreement's credentials are never shown |
| `list_order_channels` | The webshops and systems orders come from, with sync status and whether shipments and fulfilment happen automatically; the shop's credentials are never shown |
| `search_returns` | Return orders from the return portal with status, returned lines, quantity and the customer's stated cause |

### Writing (3 guardrailed tools)

These 3 tools are the only ones that change anything in Webshipper. A call without
`confirm: true` never changes anything, but shows exactly which change would be
sent. Normally your AI shows you the preview and only calls again with
`confirm: true` once you have said yes. The **Extra lock** column shows the tools
where the confirmation must also match the preview (see
[How the guardrail works](#how-the-guardrail-works)).

| Tool | What it does | Extra lock |
| - | - | - |
| `create_shipment` | Books one order with the carrier using the order's own or a chosen shipping rate. This buys postage, and the carrier or the shop can notify the recipient by SMS or e-mail. It cannot be safely cancelled afterwards | Yes, cannot be undone |
| `update_order` | Corrects fields of the delivery address, switches the shipping rate, or puts the order on hold and releases it again, before it ships | Yes |
| `create_order` | Creates a manual order in an order channel, for example a replacement or a B2B parcel, with up to 100 lines. No shipment is booked | |

> [card] [Building on top of it yourself? See the API reference](https://docs.consile.ai/developers/tools/webshipper.md)
>
> Full reference with all 15 tools, arguments, pagination, guardrail fields and
> errors.

## How the guardrail works

1. **All 3 write tools are dry-run by default.** A call without `confirm: true`
   never changes anything in Webshipper. You get a preview of exactly the change
   that would be sent. For bookings and corrections, it also shows the order as it
   is now.
2. **The change is only made with `confirm: true`.** There are no exceptions.
3. **Bookings and corrections must match the preview.** `create_shipment` and
   `update_order` also require a check value from the preview. If the order has
   changed in Webshipper between the preview and the confirmation, the call is
   refused, and nothing is changed. It always takes two calls.
4. **Only orders that can ship.** An order that is already dispatched, partly
   dispatched, cancelled or locked in Webshipper can be neither booked nor
   corrected. An order on hold must be released with `update_order` before it can
   be booked. This stops an order that has already shipped from being booked
   again.
5. **Nothing is deleted or cancelled.** The connector cannot delete or cancel
   orders and shipments, print labels or order a pickup. You do that yourself in
   Webshipper.
6. **An unknown outcome is stated plainly.** If a write gets no answer from
   Webshipper, the error tells your AI that the outcome is unknown and asks it to
   check in Webshipper before trying again.

> [!WARNING]
>
> **A booking costs postage.** Once `create_shipment` is confirmed, the shipment is
> bought from the carrier, and the recipient may have been notified. Deleting the
> shipment in Webshipper afterwards does not always cancel it with the carrier.
> Read the preview before you say yes.

> [!TIP]
>
> Read the full confirmation model, which applies across all write connectors,
> under [Actions & guardrails](https://docs.consile.ai/en/essentials/actions-and-guardrails.md). If you want
> an administrator's yes before specific writes, use
> [Approvals](https://docs.consile.ai/en/portal/approvals.md). A rule on a write tool applies to both the
> preview and the confirmation.

## Access level per user

An administrator chooses the access level for each user in the portal under
[Team](https://docs.consile.ai/en/portal/team.md): click the user's name, and for Webshipper choose between
**None**, **Read only (12)**, **Full access (15)** and **Custom**, where you choose
exactly the tools the user gets (see
[Custom access](https://docs.consile.ai/en/portal/team.md#custom-access)). The numbers count the tools the
organization has switched on.

| Level | Tools | What your AI can do |
| - | - | - |
| **Read only** | 12 | Read orders, shipments, tracking, shipping costs, shipping rates, drop points, setup and returns. No write tools. |
| **Full access** (default) | 15 | Everything above plus the 3 guardrailed write tools. |

* Both levels cost the same.
* If a user is on **Read only**, Consile blocks all write operations on the server
  for that user: the write tools do not show in the user's AI, and a call to them
  is refused without anything being changed.
* The connection to Webshipper belongs to the company, so colleagues with **Full
  access** can still write.

## Try asking

> [accordion] Failed orders
>
> > *"Which orders failed in Webshipper today, and why?"*
>
> > *"Show the orders that are on hold, and how long they have been waiting."*

> [accordion] Tracking
>
> > *"Where is the parcel for order 1001, and when was it last scanned?"*
>
> > *"Find the shipment with tracking number 00370712345678901234, and show its events."*

> [accordion] Shipping costs
>
> > *"What did we spend on shipping per carrier in October, and what did customers pay?"*
>
> > *"Which parcel shops are closest to Vestergade 10, 8000 Aarhus C?"*

> [accordion] Book & correct (guardrailed)
>
> > *"Change the delivery address on order 1001 to Nørregade 5, 1165 Copenhagen K."* (you get a preview and must confirm)
>
> > *"Book the shipment for order 1001 with the order's own shipping rate. Show it to me first."*

> [!TIP]
>
> The shop's own order number is not the same as Webshipper's id for the order.
> Feel free to mention the order number in the question. Your AI finds
> Webshipper's id itself with `search_orders`.

## Limitations

* **Writing is guardrailed, not unrestricted.** The 3 write tools only work behind
  the confirmation lock above. The guardrail consists of safe defaults in the
  connector and is not an absolute guarantee.
* **A booking cannot be taken back.** Postage is bought once a shipment is booked.
  If it must be cancelled, you do that in Webshipper or with the carrier.
* **Not in this version.** Labels and other documents as files, printing, pickups,
  returns as writes, notes, deleting and cancelling, and setting up carriers,
  shipping rules and webhooks.
* **Credentials are never shown.** The shop's access tokens, the carrier
  agreements' credentials, documents such as labels and packing slips, and images
  from returns are never sent to your AI.
* **Personal data.** Orders and shipments contain your customers' addresses. Lists
  show name, company, postal code, city and country. A single order or shipment
  also shows phone and e-mail, which customer service needs.
* **The token's permissions.** If the token lacks access to an area in Webshipper,
  for example shipments, the tools that use that area fail with an explanatory
  message. The other tools keep working.
* **One page at a time.** Searches return 30 results per page. Your AI asks for
  the next page itself when there may be more. A shipping cost summary reads at
  most 1,500 shipments; if the period is larger, your AI asks for a shorter period.
* **Webshipper's call limit.** Webshipper allows about 2 calls per second per API
  token, and the limit is shared by all users of the same connection. If your AI
  hits it, it is told to wait a little.
* **No stored data.** Everything is fetched and written live when you ask. Consile
  stores no order or shipment data.

Is something not working as expected? See [Troubleshooting](https://docs.consile.ai/en/troubleshooting.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.