docs: README shows all 4 couriers (Steadfast/Pathao/RedX/Paperfly) + remote-URL & npx methods

This commit is contained in:
2026-09-02 13:24:19 +00:00
parent 39fed40bc4
commit 10f073cd47
2 changed files with 35 additions and 15 deletions
+34 -14
View File
@@ -1,6 +1,6 @@
# Aura Courier MCP # Aura Courier MCP
Universal Bangladesh courier MCP server — **Steadfast** & **Pathao** with a built-in **fraud-risk engine** — for Claude, Antigravity, Cursor and any MCP-compatible AI agent. Book and track parcels across Bangladesh by just telling your AI. Universal Bangladesh courier MCP server — **Steadfast, Pathao, RedX & Paperfly** with a built-in **fraud-risk engine** — for Claude, Antigravity, Cursor, n8n and any MCP-compatible AI agent. Book and track parcels across Bangladesh by just telling your AI.
By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) · ✓ Verified on Glama By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) · ✓ Verified on Glama
@@ -9,12 +9,24 @@ By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) ·
| Tool | What it does | | Tool | What it does |
|------|--------------| |------|--------------|
| `list_couriers` | Show supported couriers and which credentials are active | | `list_couriers` | Show supported couriers and which credentials are active |
| `create_parcel` | Book a parcel (Steadfast / Pathao / auto smart-routing) | | `create_parcel` | Book a parcel (Steadfast / Pathao / RedX / Paperfly, or `auto`) |
| `track_parcel` | Track a shipment by tracking / consignment ID | | `track_parcel` | Track a shipment by tracking / consignment / reference id |
| `get_balance` | Merchant account balance & payout details | | `get_balance` | Merchant account balance (Steadfast / Pathao) |
| `check_fraud_risk` | Delivery/return-risk score for a Bangladeshi phone number | | `check_fraud_risk` | Delivery/return-risk score for a Bangladeshi phone number |
## Install (add to your AI's MCP config) ## Two ways to connect
### 1) Remote URL — claude.ai web, n8n, any remote client
Add this as a custom MCP connector and pass your courier keys as headers (or query params):
```
https://courier.auraajenticai.cloud/mcp
```
Headers: `x-steadfast-api-key`, `x-steadfast-secret-key`, `x-pathao-client-id` …, `x-redx-api-token`, `x-paperfly-api-key`, `x-paperfly-store-name`, `x-paperfly-username`, `x-paperfly-password`.
### 2) Local (npx) — Claude Desktop, Cursor, Antigravity
```json ```json
{ {
@@ -23,25 +35,33 @@ By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) ·
"command": "npx", "command": "npx",
"args": ["-y", "aura-courier-mcp@latest"], "args": ["-y", "aura-courier-mcp@latest"],
"env": { "env": {
"STEADFAST_API_KEY": "your-steadfast-api-key", "STEADFAST_API_KEY": "…",
"STEADFAST_SECRET_KEY": "your-steadfast-secret-key", "STEADFAST_SECRET_KEY": "…",
"PATHAO_CLIENT_ID": "optional", "REDX_API_TOKEN": "…",
"PATHAO_CLIENT_SECRET": "optional", "PAPERFLY_API_KEY": "…",
"PATHAO_USERNAME": "optional", "PAPERFLY_STORE_NAME": "…",
"PATHAO_PASSWORD": "optional", "PAPERFLY_USERNAME": "…",
"PATHAO_STORE_ID": "optional" "PAPERFLY_PASSWORD": "…"
} }
} }
} }
} }
``` ```
Steadfast keys come from your Steadfast merchant panel → **Settings → API**. Pathao is optional — add it only if you use Pathao. Your keys stay on your own machine (passed as environment variables); they are never sent to Aura. Add only the couriers you use — each is independent. Your keys stay on your side (env vars or request headers); they are never stored by Aura.
## Courier notes
- **Steadfast / Pathao** — API key + secret (Pathao also needs client id/secret + username/password).
- **RedX** — API access token (`REDX_API_TOKEN`). Delivery area is auto-resolved from the address, or pass `delivery_area_id`.
- **Paperfly** — needs **both** the `paperflykey` **and** your merchant username/password on create *and* track, plus your store name.
- `get_balance` is available for Steadfast & Pathao (RedX/Paperfly don't expose a balance API).
## Then just ask ## Then just ask
> "Book a Steadfast parcel for invoice A-1001, COD 1500 to 017XXXXXXXX." > "Book a Steadfast parcel for invoice A-1001, COD 1500 to 017XXXXXXXX."
> "Track consignment 123456." > "Create a RedX parcel to Dhanmondi, COD 900."
> "Track consignment 20A316MOG0DI."
## License ## License
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "aura-courier-mcp", "name": "aura-courier-mcp",
"version": "2.3.2", "version": "2.3.3",
"description": "Universal Bangladesh courier MCP server — Steadfast, Pathao, RedX & Paperfly with a built-in fraud-risk engine — for Claude, Antigravity, Cursor & n8n AI agents. Runs as a local npx (STDIO) server or a remote HTTP endpoint.", "description": "Universal Bangladesh courier MCP server — Steadfast, Pathao, RedX & Paperfly with a built-in fraud-risk engine — for Claude, Antigravity, Cursor & n8n AI agents. Runs as a local npx (STDIO) server or a remote HTTP endpoint.",
"main": "dist/index.js", "main": "dist/index.js",
"type": "module", "type": "module",