aura-courier-mcp 2.3.1 → 2.3.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aura Ajentic AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # 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
 
@@ -9,12 +9,24 @@ By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) ·
 | Tool | What it does |
 |------|--------------|
 | `list_couriers` | Show supported couriers and which credentials are active |
-| `create_parcel` | Book a parcel (Steadfast / Pathao / auto smart-routing) |
-| `track_parcel` | Track a shipment by tracking / consignment ID |
-| `get_balance` | Merchant account balance & payout details |
+| `create_parcel` | Book a parcel (Steadfast / Pathao / RedX / Paperfly, or `auto`) |
+| `track_parcel` | Track a shipment by tracking / consignment / reference id |
+| `get_balance` | Merchant account balance (Steadfast / Pathao) |
 | `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
 {
@@ -23,25 +35,33 @@ By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) ·
       "command": "npx",
       "args": ["-y", "aura-courier-mcp@latest"],
       "env": {
-        "STEADFAST_API_KEY": "your-steadfast-api-key",
-        "STEADFAST_SECRET_KEY": "your-steadfast-secret-key",
-        "PATHAO_CLIENT_ID": "optional",
-        "PATHAO_CLIENT_SECRET": "optional",
-        "PATHAO_USERNAME": "optional",
-        "PATHAO_PASSWORD": "optional",
-        "PATHAO_STORE_ID": "optional"
+        "STEADFAST_API_KEY": "…",
+        "STEADFAST_SECRET_KEY": "…",
+        "REDX_API_TOKEN": "…",
+        "PAPERFLY_API_KEY": "…",
+        "PAPERFLY_STORE_NAME": "…",
+        "PAPERFLY_USERNAME": "…",
+        "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
 
 > "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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aura-courier-mcp",
-  "version": "2.3.1",
+  "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.",
   "main": "dist/index.js",
   "type": "module",
@@ -9,7 +9,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "publishConfig": {
     "access": "public"