Connect Claude to CargoAI's air cargo platform using the Model Context Protocol (MCP).
In addition to direct API integration, CargoAi provides an MCP (Model Context Protocol) server that wraps these endpoints as tools consumable by AI assistants. The MCP server is available to Platform users with a Premium subscription.
Search live flight rates, track shipments by AWB number, look up airline contacts and ground handling agents, manage shipment tracking subscriptions, directly from your AI assistant.
- MCP Server URL: https://api.cargoai.co/mcp
- Authentication: OAuth 2.0 (CargoAI account required)
- Access: CargoMART Premium or Ultimate plan
Prerequisites
1. A CargoAI account with a Premium or Ultimate plan
The CargoAI MCP connector requires a CargoMART Premium or Ultimate office plan. Free and Basic plans do not have access.
If you don't have an account yet:
- Go to cargoai.co and sign up
- Contact your CargoAI account manager to upgrade your office to a Premium or Ultimate plan
If you already have a CargoAI account but are unsure of your plan, log in to CargoMART and check your office settings, or contact [email protected] .
2. Access to Claude.ai or Claude Desktop
A Claude.ai account (any plan) or Claude Desktop is required to use the connector.
Setup
Claude.ai (Web) and Claude Desktop
- Go to Claude.ai → Settings → Connectors
- Click Add connector
- Search for the CargoAI Connector among the list
- Click Connect — you will be redirected to CargoAI's login page
- Sign in with your CargoAI credentials
- The CargoAI connector is now active in your conversations
Available Tools
Track Shipment
Track a shipment by its Air Waybill (AWB) number. Returns current status, location, and full tracking event history.
| Parameter | Type | Required | Description |
|---|---|---|---|
awb_number | string | Yes | AWB number (e.g. 020-12345678) |
Example: "Track AWB 020-12345678"
Search Flight Rates
Search for available flight rates and schedules between airports. Returns flights with pricing, transit times, and carrier information. Searches may take a few seconds — if results are still loading, the tool will automatically retry to fetch completed results.
| Parameter | Type | Required | Description |
|---|---|---|---|
destination | string | Yes | Destination airport IATA code (e.g. CDG) |
origin | string | No | Origin airport IATA code. Defaults to your office airport |
departure_date | string | No | Date in YYYY-MM-DD format. Defaults to tomorrow |
shipment | object | No | Shipment details: pieces, weight (kg), volume (m³), product, special handling codes |
airline_codes | array | No | Filter by airline IATA codes (e.g. ["AF", "QR"]) |
max_legs | integer | No | Maximum number of legs. 1 = direct flights only |
sorting_method | string | No | cheapest_first (default) or shortest_first |
Example: "Find the cheapest direct flights from CDG to JFK tomorrow for 100kg"
Get Airline Contact
Look up contact information for an airline at a specific location. Filter by country, origin airport, or airline name/IATA code.
| Parameter | Type | Required | Description |
|---|---|---|---|
country | array | No | Country names (e.g. ["France"]) |
origin | array | No | Airport IATA codes (e.g. ["CDG"]) |
airline | array | No | Airline names or IATA codes (e.g. ["AF"]) |
Example: "Get Air France cargo contact at CDG"
Get Ground Handling Agent Info
Look up the Ground Handling Agent (GHA) responsible for cargo handling at a given airport for a specific airline.
| Parameter | Type | Required | Description |
|---|---|---|---|
origin | array | No | Airport IATA codes (e.g. ["CDG"]) |
airline | array | No | Airline names or IATA codes (e.g. ["AF"]) |
Example: "Who handles Air France cargo at Frankfurt?"
Subscribe to Shipment Tracking
Subscribe one or more email addresses to receive tracking update notifications for a specific AWB.
| Parameter | Type | Required | Description |
|---|---|---|---|
awb | string | Yes | AWB with prefix (e.g. 020-12345678) |
emails | array | No | Email addresses to subscribe. Defaults to your account email |
include_account_email | boolean | No | Also subscribe your account email alongside emails. Default: false |
Example: "Subscribe me to tracking updates for AWB 020-12345678"
Unsubscribe from Shipment Tracking
Remove one or more email addresses from tracking update notifications for a specific AWB.
| Parameter | Type | Required | Description |
|---|---|---|---|
awb | string | Yes | AWB with prefix (e.g. 020-12345678) |
emails | array | No | Email addresses to remove. Defaults to your account email |
include_account_email | boolean | No | Also remove your account email alongside emails. Default: false |
Example: "Unsubscribe [email protected] from AWB 020-12345678 tracking"
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| MCP access requires a CargoMART Premium plan | Your account is on a free or Basic plan | Upgrade to Premium or contact [email protected] |
| No CargoAI account found for this user | Email not registered in CargoAI | Create an account at cargoai.co |
| Rate search timed out | Search took longer than expected | Retry — large searches may take a few extra seconds |
For further help: [email protected]
Privacy Policy
The CargoAI MCP connector processes the following data to fulfill your requests:
- Authentication data: Your email address and CargoAI user ID, extracted from the OAuth access token, are used solely to authenticate requests and identify your office profile.
- Query data: Search parameters (airport codes, dates, shipment details, AWB numbers) are transmitted to CargoAI's internal APIs to fulfill tool requests.
- Email addresses: When using subscribe/unsubscribe tools, provided email addresses are transmitted to CargoAI's tracking service.
No conversation data is stored by the MCP server. Each request is stateless. Operational logs are retained for 30 days and are not shared with third parties outside of CargoAI's infrastructure.
Full privacy policy: cargoai.co/privacy-policy — For privacy-related questions contact our support team: [email protected]