🛍️ Salla MCP Server

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.

Live Demo • Salla Partners • MCP Documentation

✨ Key Capabilities

• 🗣️ 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.

Related MCP server: FacturaHub MCP Server

🛠️ Available AI Tools

🚀 Quick Start

1. Prerequisites

• Node.js & Cloudflare Account

• Salla Partner Portal account with an active OAuth App.

2. Installation

git clone https://github.com/your-username/salla-mcp-server.git
cd salla-mcp-server
npm install

3. Configuration

Copy the example environment file:

cp .dev.vars.example .dev.vars

Update .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.example

4. Development & Local Testing

npm run dev

Your server will run at http://localhost:8787. The MCP endpoint is /sse.

🤖 Using with AI Assistants

Claude Desktop

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.

Example Prompts to Try:

• 🛒 "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."

🌐 Deployment

Deploy to your own Cloudflare account in seconds:

npx wrangler deploy

Note: Don't forget to add your Salla Redirect URI in the Partner Portal: https://your-worker.your-subdomain.workers.dev/callback/salla

🤝 Contributing

We love contributions! Whether it's adding new Salla API endpoints or improving the AI prompts.

1. Fork the repo

2. Create your branch: git checkout -b feature/amazing-feature

3. Commit changes: git commit -m 'Add amazing feature'

4. Push: git push origin feature/amazing-feature

5. Open a Pull Request

📜 License

Distributed under the MIT License. See LICENSE for more information.