What is the bexy MCP server?

A remote Model Context Protocol server that gives an AI assistant three tools: track one shipment by Bill of Lading, carrier Bill of Lading, container number or bexy id; search recent shipments by origin and destination country; and unlock a shipment's Bill of Lading numbers. It covers the Evergreen (EGLV) shipments bexy tracks.

Which AI clients can connect?

Any client that speaks MCP over HTTP with a bearer token: Claude Code, Claude Desktop (through mcp-remote), Cursor and similar tools. The setup snippets on this page cover the three most common ones.

Do I need an account, and does it cost anything?

You need a free bexy account to create a personal access token, and there are no usage fees. Routes, vessels, containers and dates are always returned in full.

Are Bill of Lading numbers included in responses?

They come back masked unless the shipment has been unlocked. An unlock spends one of the account's monthly credits, exactly as on the website, and the server instructs the assistant to ask before spending one.

Can the assistant link back to a shipment?

Yes. Every shipment in a response carries a tracking_url that opens the same shipment page on bexy, so an assistant can cite it or hand you off to the full page.

Developers // MCP

Bring Evergreen cargo tracking into your AI.

bexy speaks the Model Context Protocol — an open standard that lets AI assistants call external tools. Connect once and ask Claude, Cursor or any MCP-capable client to track Evergreen shipments and search lanes with real ocean-freight data. It's free; you just need a token.

Why bexy MCP

Free to use

No usage fees. Routes, vessels and containers are always open — Bill of Lading numbers draw on the same monthly unlock allowance as your account on the site.

Token-scoped

Each token is yours alone and can be revoked instantly from the dashboard.

Carrier-sourced data

The same Evergreen (EGLV) tracking data and route statistics that power the bexy website — straight into your chat.

Tooling

Tools your assistant gets

Three tools, one endpoint. Your AI chooses the right one from your question.

track-shipment

Look up one shipment by Bill of Lading, carrier BL, container number or shipment id — vessel/voyage, full route, every container and its latest status, plus estimated departure and arrival.

search-shipments

List recent shipments, optionally filtered by origin and destination country (ISO codes), ordered by most recent departure.

unlock-shipment

Spend one of your monthly B/L unlock credits to reveal a shipment's Bill of Lading numbers. The same allowance you use on the site, and an unlock is permanent.

Setup

Connect in three steps

Create a token

Generate a personal access token in your dashboard. It is shown once — copy it somewhere safe.

Add the server

Point your MCP-compatible client at the bexy endpoint and pass your token as a bearer header.

Ask your AI

Your assistant can now track shipments and search lanes in plain language — using bexy's tracking data.

Configuration

Point your client at the endpoint

Use this endpoint and authenticate with your token as a bearer header.

Endpoint · streamable HTTP

https://bexy.io/mcp/bexy

Auth header

Authorization: Bearer YOUR_TOKEN

Add the server from your terminal:

claude mcp add --transport http bexy https://bexy.io/mcp/bexy \
  --header "Authorization: Bearer YOUR_TOKEN"

Replace YOUR_TOKEN with a token from your dashboard.

No MCP client? · plain lookup URL

https://bexy.iohttps://bexy.io/track?number=<B/L or container number>

Agents and scripts without MCP can open this URL with an Evergreen (EGLV) Bill of Lading or container number — no token needed. It redirects to the shipment page when bexy already holds that shipment and returns 404 otherwise; it never fetches from Evergreen, so a new Bill of Lading goes through the search on the site.

Response

What comes back

A track-shipment call returns clean, structured JSON — ready for your AI to summarize.

{
  "bill_of_lading": "1404••••••••",
  "vessel_voyage": "EVER FULL 1145-013E",
  "origin": { "location": "QINGDAO, CHINA (CN)", "country": "CN" },
  "destination": { "location": "LOS ANGELES, CA (US)", "country": "US" },
  "estimated_departure": "2024-11-28T00:00:00+00:00",
  "estimated_arrival": "2024-12-27T00:00:00+00:00",
  "containers": [
    {
      "container_no": "TIIU5047849",
      "size_type": "40'(SH)",
      "current_status": "Loaded (FCL) on EVER FULL at QINGDAO, CHINA (CN)"
    }
  ],
  "tracking_url": "https://bexy.io/track/…",
  "access": {
    "bl_locked": true,
    "unlocks_remaining": 14,
    "unlocks_per_month": 20
  }
}

FAQ

Frequently asked questions

What is the bexy MCP server?: A remote Model Context Protocol server that gives an AI assistant three tools: track one shipment by Bill of Lading, carrier Bill of Lading, container number or bexy id; search recent shipments by origin and destination country; and unlock a shipment's Bill of Lading numbers. It covers the Evergreen (EGLV) shipments bexy tracks.
Which AI clients can connect?: Any client that speaks MCP over HTTP with a bearer token: Claude Code, Claude Desktop (through mcp-remote), Cursor and similar tools. The setup snippets on this page cover the three most common ones.
Do I need an account, and does it cost anything?: You need a free bexy account to create a personal access token, and there are no usage fees. Routes, vessels, containers and dates are always returned in full.
Are Bill of Lading numbers included in responses?: They come back masked unless the shipment has been unlocked. An unlock spends one of the account's monthly credits, exactly as on the website, and the server instructs the assistant to ask before spending one.
Can the assistant link back to a shipment?: Yes. Every shipment in a response carries a tracking_url that opens the same shipment page on bexy, so an assistant can cite it or hand you off to the full page.

One minute to live

Ready to wire it up?

Create a free token and connect bexy to your assistant in under a minute.

Learn about MCP