Create, track, price and cancel cash-on-delivery parcels with 101 Algerian couriers. No login.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Your own courier credentials as JSON keyed by courier key, for example {"yalidine":{"apiId":"...","apiToken":"..."}}. Used when a tool call carries none, so they stay out of the conversation. The sandbox courier needs none.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Cancel a parcel before the courier collects it. Few couriers offer it: list_couriers says which. Ask the user first.
The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http dzship https://freeship.dzbuild.com/mcp
Headers
X-Courier-Credentials (optional, not in the config above): Optional. Your own courier credentials as JSON keyed by courier key, for example {"yalidine":{"apiId":"...","apiToken":"..."}}. Used when a tool call carries none, so they stay out of the conversation. The sandbox courier needs none.Cancel a parcel before the courier collects it. Few couriers offer it: list_couriers says which. Ask the user first.
| Argument | Type | Description |
|---|---|---|
| courier* | string | |
| options | object | |
| credentials | object | The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier. |
| trackingNumber* | string |
{
"type": "object",
"required": [
"courier",
"trackingNumber"
],
"properties": {
"courier": {
"type": "string",
"example": "sandbox"
},
"options": {
"type": "object",
"properties": {
"baseUrl": {
"type": "string",
"format": "uri",
"description": "Tenant URL, accepted only for the generic \"ecotrack\" courier and only under *.ecotrack.dz. Every other courier has its own key and takes no URL."
},
"timeoutMs": {
"type": "integer",
"maximum": 30000,
"minimum": 1000
},
"fromWilaya": {
"type": "integer",
"maximum": 58,
"minimum": 1
}
}
},
"credentials": {
"type": "object",
"description": "The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier.",
"additionalProperties": {
"type": "string"
}
},
"trackingNumber": {
"type": "string",
"example": "DZTEST-1A2B3C",
"maxLength": 80
}
}
}Create a cash-on-delivery parcel on the merchant's courier account. The "sandbox" courier needs no credentials and creates nothing. Ask the user before creating a real parcel.
| Argument | Type | Description |
|---|---|---|
| order* | object | |
| courier* | string | |
| options | object | |
| credentials | object | The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier. |
{
"type": "object",
"required": [
"courier",
"order"
],
"properties": {
"order": {
"type": "object",
"required": [
"recipient",
"deliveryType",
"productList",
"codAmount"
],
"properties": {
"notes": {
"type": "string",
"maxLength": 255
},
"weightKg": {
"type": "number"
},
"codAmount": {
"type": "integer",
"minimum": 0,
"description": "Integer DZD"
},
"recipient": {
"type": "object",
"required": [
"fullName",
"phone",
"wilayaCode",
"communeName"
],
"properties": {
"phone": {
"type": "string",
"description": "Algerian mobile: 05/06/07"
},
"fullName": {
"type": "string",
"maxLength": 120,
"minLength": 2
},
"phoneAlt": {
"type": "string"
},
"wilayaCode": {
"type": "integer",
"maximum": 58,
"minimum": 1
},
"addressLine": {
"type": "string",
"maxLength": 255
},
"communeName": {
"type": "string"
}
}
},
"reference": {
"type": "string",
"maxLength": 64
},
"isExchange": {
"type": "boolean"
},
"stopDeskId": {
"type": "string"
},
"productList": {
"type": "string",
"maxLength": 500
},
"deliveryType": {
"enum": [
"home",
"stopdesk"
],
"type": "string"
},
"freeShipping": {
"type": "boolean"
},
"declaredValue": {
"type": "integer"
},
"hasOpenPackage": {
"type": "boolean"
}
}
},
"courier": {
"type": "string",
"example": "yalidine"
},
"options": {
"type": "object",
"properties": {
"baseUrl": {
"type": "string",
"format": "uri",
"description": "Tenant URL, accepted only for the generic \"ecotrack\" courier and only under *.ecotrack.dz. Every other courier has its own key and takes no URL."
},
"timeoutMs": {
"type": "integer",
"maximum": 30000,
"minimum": 1000
},
"fromWilaya": {
"type": "integer",
"maximum": 58,
"minimum": 1
}
}
},
"credentials": {
"type": "object",
"description": "The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier.",
"additionalProperties": {
"type": "string"
}
}
}
}Delivery and return fees for a route with one courier.
| Argument | Type | Description |
|---|---|---|
| query* | object | |
| courier* | string | |
| options | object | |
| credentials | object | The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier. |
{
"type": "object",
"required": [
"courier",
"query"
],
"properties": {
"query": {
"type": "object",
"required": [
"toWilaya",
"deliveryType"
],
"properties": {
"tier": {
"enum": [
"express",
"economic"
],
"type": "string"
},
"toWilaya": {
"type": "integer",
"maximum": 58,
"minimum": 1
},
"codAmount": {
"type": "integer"
},
"toCommune": {
"type": "string"
},
"fromWilaya": {
"type": "integer",
"maximum": 58,
"minimum": 1
},
"deliveryType": {
"enum": [
"home",
"stopdesk"
],
"type": "string"
}
}
},
"courier": {
"type": "string"
},
"options": {
"type": "object",
"properties": {
"baseUrl": {
"type": "string",
"format": "uri",
"description": "Tenant URL, accepted only for the generic \"ecotrack\" courier and only under *.ecotrack.dz. Every other courier has its own key and takes no URL."
},
"timeoutMs": {
"type": "integer",
"maximum": 30000,
"minimum": 1000
},
"fromWilaya": {
"type": "integer",
"maximum": 58,
"minimum": 1
}
}
},
"credentials": {
"type": "object",
"description": "The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier.",
"additionalProperties": {
"type": "string"
}
}
}
}Communes in the spelling couriers accept. Pass wilaya, q or both: the full list is too large to return.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| wilaya | integer |
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"wilaya": {
"type": "integer",
"maximum": 69,
"minimum": 1
}
}
}Find a courier: its key, the credential fields it needs and what it supports (create, track, rates, stop desks, label, cancel). Pass q to search by name.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| platform | string |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"example": "rocket"
},
"platform": {
"type": "string",
"example": "ecotrack"
}
}
}The stop desks a courier runs in one wilaya. Send a desk id as order.stopDeskId.
| Argument | Type | Description |
|---|---|---|
| courier* | string | |
| options | object | |
| wilayaCode* | integer | |
| credentials | object | The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier. |
{
"type": "object",
"required": [
"courier",
"wilayaCode"
],
"properties": {
"courier": {
"type": "string",
"example": "sandbox"
},
"options": {
"type": "object",
"properties": {
"baseUrl": {
"type": "string",
"format": "uri",
"description": "Tenant URL, accepted only for the generic \"ecotrack\" courier and only under *.ecotrack.dz. Every other courier has its own key and takes no URL."
},
"timeoutMs": {
"type": "integer",
"maximum": 30000,
"minimum": 1000
},
"fromWilaya": {
"type": "integer",
"maximum": 58,
"minimum": 1
}
}
},
"wilayaCode": {
"type": "integer",
"example": 31,
"maximum": 58,
"minimum": 1
},
"credentials": {
"type": "object",
"description": "The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier.",
"additionalProperties": {
"type": "string"
}
}
}
}The 58 wilayas couriers deliver to, in French and Arabic. Pass all=true for the 69 of the 2026 division, each with the code to ship it under.
| Argument | Type | Description |
|---|---|---|
| q | string | |
| all | boolean | Include the wilayas created in 2026 that couriers do not accept yet |
| code | integer |
{
"type": "object",
"properties": {
"q": {
"type": "string"
},
"all": {
"type": "boolean",
"description": "Include the wilayas created in 2026 that couriers do not accept yet"
},
"code": {
"type": "integer",
"maximum": 69,
"minimum": 1
}
}
}Status and event history of one parcel, in the same status vocabulary for every courier.
| Argument | Type | Description |
|---|---|---|
| courier* | string | |
| options | object | |
| credentials | object | The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier. |
| trackingNumber* | string |
{
"type": "object",
"required": [
"courier",
"trackingNumber"
],
"properties": {
"courier": {
"type": "string"
},
"options": {
"type": "object",
"properties": {
"baseUrl": {
"type": "string",
"format": "uri",
"description": "Tenant URL, accepted only for the generic \"ecotrack\" courier and only under *.ecotrack.dz. Every other courier has its own key and takes no URL."
},
"timeoutMs": {
"type": "integer",
"maximum": 30000,
"minimum": 1000
},
"fromWilaya": {
"type": "integer",
"maximum": 58,
"minimum": 1
}
}
},
"credentials": {
"type": "object",
"description": "The caller's own credentials for that courier, 1-8 string fields. Never stored. Omit entirely for the sandbox courier.",
"additionalProperties": {
"type": "string"
}
},
"trackingNumber": {
"type": "string",
"maxLength": 80
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.