Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the Aymakan in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Aymakan courier (Saudi Arabia) from an AI agent: track shipments by tracking number or order reference, list your shipments, AWB label links, pickup requests and time slots, cities, PUDO points, warehouses and saved addresses. Creating and cancelling shipments and pickups is included, installed switched off.
Try asking
Example prompts for Aymakan
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Aymakan, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Aymakan + ChatGPT
Aymakan courier (Saudi Arabia) from an AI agent: track shipments by tracking number or order reference, list your shipments, AWB label links, pickup requests and time slots, cities, PUDO points, warehouses and saved addresses. Creating and cancelling shipments and pickups is included, installed switched off.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
AYMAKAN_API_KEY
Step 1 — Get credentials
Setting up takes about 2 minutes. You need a customer account with Aymakan, the Saudi courier.
- Sign in to the Aymakan customer dashboard.
- Open Technical → AyMakan API and copy the API key (the security code).
- Paste it into
AYMAKAN_API_KEYexactly as it is, without the word Bearer. - Install the connector and run
aymakan_ping:logged_inmust sayYes.
Use the production key: a key from Aymakan's development environment answers Invalid Credentials here. Regenerating the key in the dashboard makes the old one stop working, so update every other integration that still uses it.
What it reads: your shipments by tracking number or by your own order reference, with delivery and collection details, cash on delivery amount, weight, pieces, current status and the full status history in English and Arabic; the list of all shipments of your account with delivery attempts and main dates; label (AWB) links; your pickup requests, the cities where pickups are possible and the free time slots for a date; the cities Aymakan delivers to; PUDO points such as lockers and partner shops; Aymakan's warehouses; and the collection addresses saved on your account.
Labels only before pickup: Aymakan returns the PDF label link only while a shipment is still in status AY-0001 (created, not yet picked up). After pickup the API answers 422, so print your labels before the courier comes. For several shipments the AI can fetch one PDF with all their labels.
Tracking by your order number: works only for shipments that were created with a reference, and only shipments of your own account are found. A reference that does not exist answers No Shipments Found.
Switched off at install: aymakan_create_shipment, aymakan_cancel_shipment, aymakan_create_pickup_request and aymakan_cancel_pickup_request. They book or cancel real courier work, so an administrator turns them on deliberately. Even then the AI first shows you the shipment (receiver, city, cash on delivery amount, pieces), the tracking number or the pickup request, and waits for your yes. A shipment can be cancelled only while in AY-0001, a pickup request only while pending or processing.
Limits: the shipment list comes in fixed pages of 100 (about 110 KB each), so for a single shipment the AI uses tracking instead. Aymakan limits the number of pickup requests per customer and day.
Common errors: 401 Invalid Credentials means a wrong key, an old key after regeneration, or a development key. 422 carries the reason in the message, for example No Shipments Found, a validation error per field, or a label request for a shipment that is already past AY-0001.
The connector does not handle cash on delivery settlements or invoices, and it does not book or cancel shipments or pickups unless an administrator has turned those tools on.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in ChatGPT
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.
- Go to chatgpt.com/plugins, click +, then Add custom MCP server.
- Enter a name, e.g. Name:
Aymakan. - Under Connection, enter the Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDand keep Authentication on OAuth. - Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
- Install the new plugin from your personal plugins, then type @ in a chat and pick it.
Available tools
| Tool | What it does |
|---|---|
aymakan_ping | Check the Aymakan API status and the API key: returns status, environment (production) and logged_in Yes or No |
aymakan_get_tracking | Track one or more Aymakan shipments by tracking number: full shipment data with delivery and collection details, COD amount, weight and… |
aymakan_get_shipments_by_reference | Get Aymakan shipments by your own order reference (the reference given when the shipment was created): full shipment data, tracking_info… |
aymakan_list_shipments | List every shipment of the account, 100 per page (fixed by Aymakan): tracking number, reference, service type, COD flag and amount, pieces… |
aymakan_get_awb_label | Get the link to the PDF AWB label of one shipment by tracking number |
aymakan_get_bulk_awb_labels | Get one PDF link with the AWB labels of several shipments |
aymakan_list_pickup_requests | List the pickup requests of the account with id, pickup code, type, contact, city and address, number of shipments and picked shipments… |
aymakan_list_pickup_cities | List the cities where Aymakan accepts pickup requests, in English and Arabic |
aymakan_get_time_slots | Get the pickup time slots available to the account on a date (e.g. morning, afternoon, evening with their hours) |
aymakan_list_cities | List the cities Aymakan delivers to, in English (city_en) and Arabic (city_ar) |
aymakan_list_pudo_locations | List PUDO (pickup and drop-off) points such as lockers and partner shops with id, name in English and Arabic, address, city, coordinates… |
aymakan_list_dropoff_locations | List Aymakan's warehouses where shipments can be dropped off: name, city, address, manager, phone, e-mail and coordinates |
aymakan_list_addresses | List the collection addresses saved on the Aymakan account: id, title, name, e-mail, city, address, postcode, neighbourhood, phone, country… |
aymakan_create_shipment | Create a new Aymakan shipment |
aymakan_cancel_shipment | Cancel an Aymakan shipment by tracking number |
aymakan_create_pickup_request | Book a courier pickup: date (today or later), time slot from aymakan_get_time_slots, city from aymakan_list_pickup_cities, contact name and… |
aymakan_cancel_pickup_request | Cancel a pickup request by its id (from aymakan_list_pickup_requests) |
Example prompts
- "Where are shipments AY2866494373 and AY2866494374 right now?"
- "Find the shipment for our order reference 10045 and show me its full status history."
- "Which of my shipments this week needed more than one delivery attempt, and in which cities?"
- "Give me one PDF with the labels of every shipment created today that has not been picked up yet."
- "Which pickup time slots are free tomorrow, and which of my pickup requests are still pending?"
FAQ
Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.
Next steps
Was this guide helpful?
