aura-courier-mcp 2.3.2 → 2.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +34 -14
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Aura Courier MCP
2
2
 
3
- 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.
3
+ 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.
4
4
 
5
5
  By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) · ✓ Verified on Glama
6
6
 
@@ -9,12 +9,24 @@ By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) ·
9
9
  | Tool | What it does |
10
10
  |------|--------------|
11
11
  | `list_couriers` | Show supported couriers and which credentials are active |
12
- | `create_parcel` | Book a parcel (Steadfast / Pathao / auto smart-routing) |
13
- | `track_parcel` | Track a shipment by tracking / consignment ID |
14
- | `get_balance` | Merchant account balance & payout details |
12
+ | `create_parcel` | Book a parcel (Steadfast / Pathao / RedX / Paperfly, or `auto`) |
13
+ | `track_parcel` | Track a shipment by tracking / consignment / reference id |
14
+ | `get_balance` | Merchant account balance (Steadfast / Pathao) |
15
15
  | `check_fraud_risk` | Delivery/return-risk score for a Bangladeshi phone number |
16
16
 
17
- ## Install (add to your AI's MCP config)
17
+ ## Two ways to connect
18
+
19
+ ### 1) Remote URL — claude.ai web, n8n, any remote client
20
+
21
+ Add this as a custom MCP connector and pass your courier keys as headers (or query params):
22
+
23
+ ```
24
+ https://courier.auraajenticai.cloud/mcp
25
+ ```
26
+
27
+ 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`.
28
+
29
+ ### 2) Local (npx) — Claude Desktop, Cursor, Antigravity
18
30
 
19
31
  ```json
20
32
  {
@@ -23,25 +35,33 @@ By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) ·
23
35
  "command": "npx",
24
36
  "args": ["-y", "aura-courier-mcp@latest"],
25
37
  "env": {
26
- "STEADFAST_API_KEY": "your-steadfast-api-key",
27
- "STEADFAST_SECRET_KEY": "your-steadfast-secret-key",
28
- "PATHAO_CLIENT_ID": "optional",
29
- "PATHAO_CLIENT_SECRET": "optional",
30
- "PATHAO_USERNAME": "optional",
31
- "PATHAO_PASSWORD": "optional",
32
- "PATHAO_STORE_ID": "optional"
38
+ "STEADFAST_API_KEY": "",
39
+ "STEADFAST_SECRET_KEY": "",
40
+ "REDX_API_TOKEN": "",
41
+ "PAPERFLY_API_KEY": "",
42
+ "PAPERFLY_STORE_NAME": "",
43
+ "PAPERFLY_USERNAME": "",
44
+ "PAPERFLY_PASSWORD": ""
33
45
  }
34
46
  }
35
47
  }
36
48
  }
37
49
  ```
38
50
 
39
- 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.
51
+ 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.
52
+
53
+ ## Courier notes
54
+
55
+ - **Steadfast / Pathao** — API key + secret (Pathao also needs client id/secret + username/password).
56
+ - **RedX** — API access token (`REDX_API_TOKEN`). Delivery area is auto-resolved from the address, or pass `delivery_area_id`.
57
+ - **Paperfly** — needs **both** the `paperflykey` **and** your merchant username/password on create *and* track, plus your store name.
58
+ - `get_balance` is available for Steadfast & Pathao (RedX/Paperfly don't expose a balance API).
40
59
 
41
60
  ## Then just ask
42
61
 
43
62
  > "Book a Steadfast parcel for invoice A-1001, COD 1500 to 017XXXXXXXX."
44
- > "Track consignment 123456."
63
+ > "Create a RedX parcel to Dhanmondi, COD 900."
64
+ > "Track consignment 20A316MOG0DI."
45
65
 
46
66
  ## License
47
67
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "aura-courier-mcp",
3
- "version": "2.3.2",
3
+ "version": "2.3.3",
4
4
  "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.",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",