server: remote HTTP MCP endpoint (Streamable HTTP /mcp) + Node Dockerfile; landing served at /
This commit is contained in:
@@ -1,60 +1,21 @@
|
||||
# 🚀 Aura Courier MCP — Bangladesh's 1st Universal Courier Model Context Protocol
|
||||
# Aura Courier MCP
|
||||
|
||||
[](https://glama.ai/mcp/servers/auraajenticai/aura-courier-mcp)
|
||||
[](https://opensource.org/licenses/MIT)
|
||||
[](https://modelcontextprotocol.io)
|
||||
[](https://courier.auraajenticai.cloud)
|
||||
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.
|
||||
|
||||
> **One unified Model Context Protocol connector for every Bangladesh courier.**
|
||||
> Book deliveries, track parcels, inspect merchant balances, and analyze customer return fraud directly from **Google Antigravity**, **Claude Desktop**, **Cursor**, and **n8n AI Agents**.
|
||||
By **Aura Ajentic AI** · [auraajenticai.cloud](https://auraajenticai.cloud) · ✓ Verified on Glama
|
||||
|
||||
🌐 **Showcase & Docs:** [https://courier.auraajenticai.cloud](https://courier.auraajenticai.cloud)
|
||||
🏢 **Developed by:** [Aura Agentic AI](https://auraajenticai.cloud) & Khondokar Towsif
|
||||
## Tools
|
||||
|
||||
---
|
||||
| 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 |
|
||||
| `check_fraud_risk` | Delivery/return-risk score for a Bangladeshi phone number |
|
||||
|
||||
## ⚡ Supported Couriers (All 4 Live)
|
||||
## Install (add to your AI's MCP config)
|
||||
|
||||
1. 🟢 **Steadfast Courier** — API v1 (Live verified on Packzy Gateway)
|
||||
2. 🟢 **Pathao Courier** — Aladdin API v1 (OAuth token + City & Zone resolver)
|
||||
3. 🟢 **RedX Courier** — OpenAPI v1.0.0 (Area resolver & Tracking)
|
||||
4. 🟢 **Paperfly Courier** — Wingman API (Order placement & Tracking)
|
||||
|
||||
---
|
||||
|
||||
## 🧠 Available MCP Tools
|
||||
|
||||
| Tool Name | Description |
|
||||
| :--- | :--- |
|
||||
| `create_parcel` | AI Smart Auto-Routing: Books delivery across Steadfast, Pathao, RedX, or Paperfly with normalized response. |
|
||||
| `track_parcel` | Universal Tracking: Real-time consignment status & timeline across all supported couriers. |
|
||||
| `get_balance` | Retrieves live merchant account balance and payout details. |
|
||||
| `check_fraud_risk` | **BD Phone Fraud AI:** Analyzes customer phone number return & fraud risk score before booking COD. |
|
||||
| `list_couriers` | Displays all registered adapters and checks which credentials are active. |
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ Quick Installation & Configuration
|
||||
|
||||
### 🪐 1. Google Antigravity & Gemini CLI (`antigravity.json`)
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"aura-courier": {
|
||||
"command": "npx.cmd",
|
||||
"args": ["-y", "aura-courier-mcp@latest"],
|
||||
"env": {
|
||||
"STEADFAST_API_KEY": "YOUR_STEADFAST_API_KEY",
|
||||
"STEADFAST_SECRET_KEY": "YOUR_STEADFAST_SECRET_KEY",
|
||||
"REDX_API_TOKEN": "YOUR_REDX_TOKEN",
|
||||
"PAPERFLY_KEY": "YOUR_PAPERFLY_KEY"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### ⚡ 2. Claude Desktop (`claude_desktop_config.json`)
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
@@ -62,46 +23,26 @@
|
||||
"command": "npx",
|
||||
"args": ["-y", "aura-courier-mcp@latest"],
|
||||
"env": {
|
||||
"STEADFAST_API_KEY": "YOUR_STEADFAST_API_KEY",
|
||||
"STEADFAST_SECRET_KEY": "YOUR_STEADFAST_SECRET_KEY"
|
||||
"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"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 💻 3. Cursor / VS Code (`settings.json`)
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"aura-courier": {
|
||||
"command": "npx",
|
||||
"args": ["-y", "aura-courier-mcp@latest"],
|
||||
"env": {
|
||||
"STEADFAST_API_KEY": "YOUR_STEADFAST_API_KEY",
|
||||
"STEADFAST_SECRET_KEY": "YOUR_STEADFAST_SECRET_KEY"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
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.
|
||||
|
||||
---
|
||||
## Then just ask
|
||||
|
||||
## 🏗️ Architecture
|
||||
> "Book a Steadfast parcel for invoice A-1001, COD 1500 to 017XXXXXXXX."
|
||||
> "Track consignment 123456."
|
||||
|
||||
```
|
||||
MCP tools ──► Registry (Gateway & Smart Router) ──► Courier Adapters
|
||||
├── Steadfast (Live)
|
||||
├── Pathao (Live)
|
||||
├── RedX (Live)
|
||||
└── Paperfly (Live)
|
||||
```
|
||||
## License
|
||||
|
||||
---
|
||||
|
||||
## 📜 The Vision
|
||||
> **মানুষের স্বপ্ন · এআই-এর হাত**
|
||||
> Aura is building Bangladesh's native agentic commerce layer — unifying courier logistics, digital payments, and AI automation so any AI in the world can natively interact with Bangladeshi businesses.
|
||||
|
||||
Licensed under **MIT**. Developed by **Aura Agentic AI**.
|
||||
MIT © Aura Ajentic AI
|
||||
|
||||
Reference in New Issue
Block a user