Transform your Salla store management with the power of AI. This Model Context Protocol (MCP) server bridges AI assistants (like Claude and Cursor) directly to your Salla store, enabling natural language operations for products, orders, and analytics.
Tip
Ready to use! This server is already deployed and usable at:
https://salla-mcp-server.inlustris.workers.dev/sse
Live Demo • Salla Partners • MCP Documentation
- 🗣️ Natural Language Ops: "Show me orders from yesterday," or "Update the price of iPhone 15 to 3000 SAR."
- 📊 Real-time Analytics: Access abandoned carts, hourly visitors, and store performance summaries instantly.
- 📦 Inventory Management: Create, update, and browse products and categories with ease.
- 👥 Customer Insights: Search and retrieve detailed customer profiles and order histories.
- ⚡ Edge-Powered: Built on Cloudflare Workers for ultra-low latency and global availability.
| Category | Tools | Description |
|---|---|---|
| Store | salla-store-info, salla-categories-list, salla-brands-list |
Manage store metadata, categories, and brands. |
| Products | salla-products-list, salla-product-details, salla-product-create, salla-product-update |
Full CRUD and search for your product catalog. |
| Orders | salla-orders-list, salla-order-details, salla-order-status-update |
Track shipments, update statuses, and filter orders. |
| Customers | salla-customers-list, salla-customer-details |
Access customer profiles and engagement data. |
| Analytics | salla-abandoned-carts, salla-hourly-visitors, salla-summary-report, salla-latest-orders, salla-general-statistics |
Deep dive into store performance and visitor metrics. |
- Node.js & Cloudflare Account
- Salla Partner Portal account with an active OAuth App.
git clone https://github.com/your-username/salla-mcp-server.git
cd salla-mcp-server
npm installCopy the example environment file:
cp .dev.vars.example .dev.varsUpdate .dev.vars with your Salla credentials:
SALLA_CLIENT_ID="your_client_id"
SALLA_CLIENT_SECRET="your_client_secret"
ENCRYPTION_KEY="generate_using_openssl_rand_hex_32"
# ... other vars from .dev.vars.examplenpm run devYour server will run at http://localhost:8787. The MCP endpoint is /sse.
Add this to your claude_desktop_config.json. You can use the live hosted version directly:
{
"mcpServers": {
"salla": {
"command": "npx",
"args": ["mcp-remote", "https://salla-mcp-server.inlustris.workers.dev/sse"]
}
}
}Or use http://localhost:8787/sse if running locally.
- 🛒 "List all products in the 'Electronics' category that are on sale."
- 📈 "Give me a summary of my store's performance for this month."
- 📦 "What's the status of order #123456? If it's processing, mark it as shipped."
- 👥 "Find customers who haven't ordered anything in the last 30 days."
Deploy to your own Cloudflare account in seconds:
npx wrangler deployNote: Don't forget to add your Salla Redirect URI in the Partner Portal:
https://your-worker.your-subdomain.workers.dev/callback/salla
We love contributions! Whether it's adding new Salla API endpoints or improving the AI prompts.
- Fork the repo
- Create your branch:
git checkout -b feature/amazing-feature - Commit changes:
git commit -m 'Add amazing feature' - Push:
git push origin feature/amazing-feature - Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
Built with ❤️ for the Salla Community