🤖 CartVai AI Assistant — ChatGPT & Codex Plugin
Official OpenAI Agent Plugin for CartVai E-commerce SaaS. Connects ChatGPT and OpenAI Codex directly to a merchant's CartVai store via the Model Context Protocol (MCP).
🌟 Overview
The CartVai AI Assistant empowers merchants to monitor sales, review pending and unverified orders, track inventory, and manage product catalog drafts directly within ChatGPT or Codex using natural language (Bangla or English).
- Native Protocol: Model Context Protocol (MCP) over Streamable HTTP (
https://app.cartvai.com/api/mcp). - Authentication: Per-merchant Bearer API Token (
cv_live_sk_...) generated in the CartVai Control Panel. - Tenant Isolation: Hard, database-enforced multi-tenant isolation. No store ID parameter is accepted from the model.
- Permissions: Scoped access via
mcp:read(Read-only) andmcp:write(Read + Write operations).
🛠️ Supported Tools (13 Tools)
📊 Store & Business Overview
get-store-summary— Real-time summary of today's sales, order volume, pending orders, and low-stock alerts.
📦 Order Operations
list-orders— Filter orders by status, date range, or customer name/phone. Phone numbers are automatically masked (017••••321) for privacy.get-order— Full details for a single order including line items, delivery address, COD verification status, and courier tracking (Steadfast, Pathao, RedX).get-order-counts— Aggregated order counts grouped by status.list-missing-orders— Identifies recoverable abandoned checkout sessions.update-order-status(requiresmcp:write) — Safely transitions order statuses following valid lifecycle rules.
🏷️ Catalog & Inventory
list-products— Search and filter products by title, SKU, or status.get-product— Detailed product view with variants, pricing, and available stock.list-low-stock(requires inventory plan) — Identifies out-of-stock items or products at/below low-stock thresholds.create-product(requiresmcp:write) — Adds simple physical product drafts with initial stock.update-product(requiresmcp:write) — Modifies title, regular price, sale price, SKU, or status.adjust-stock(requiresmcp:write+ inventory plan) — Atomic inventory adjustment (set,add,remove) with row-level locking.
👥 Customer Insights
search-customers— Search customer profiles with lifetime order count and total spend.
🔐 Security & Safety Architecture
- Token-Bound Tenant Context: The authenticated merchant's API key strictly binds the session to their store. Cross-store access is physically impossible.
- Strict Guard Rails: Write operations mandate explicit merchant confirmation before execution.
- Prompt Injection Defense: Customer notes, delivery addresses, and customer names are treated as raw string data and never interpreted as prompt instructions.
- Instant Revocation: Keys can be instantly revoked from the CartVai Control Panel (Settings → Developer).
📦 Package Structure
plugins/cartvai-ai-assistant/
├── .codex-plugin/
│ └── plugin.json # Codex/ChatGPT UI & presentation manifest
├── .mcp.json # MCP server configuration with Bearer auth scheme
├── mcp.json # Public MCP manifest
├── plugin.json # Agent Plugins v1.0.0 root manifest
├── README.md # Plugin documentation
└── skills/
└── cartvai-merchant-assistant/
└── SKILL.md # Assistant persona, guard rails, and execution rules
🚀 How to Publish to OpenAI Plugin Marketplace
- Visit the OpenAI Developer Dashboard.
- Go to Plugins → Submit a Plugin (or Upload Plugin Package).
- Zip the plugin directory:
cd plugins/cartvai-ai-assistant zip -r cartvai-ai-assistant.zip . -x "*.DS_Store" - Upload
cartvai-ai-assistant.zipor link the repository path. - Provide developer contact info, privacy policy URL (
https://cartvai.com/privacy), and submit for review.
📄 License & Attribution
Developed by the CartVai Team. For support, contact support@cartvai.com.