ikas MCP Server

What is ikas MCP Server?

ikas MCP Server is a Model Context Protocol server for the ikas e-commerce platform. It provides AI assistants with direct access to store data such as customers, orders, products, and analytics.

How to use ikas MCP Server?

Clone the repository, install dependencies (npm install), build the TypeScript code (npm run build), and create a .env file with your ikas credentials (IKAS_STORE_NAME, IKAS_CLIENT_ID, IKAS_CLIENT_SECRET). Then add the server configuration to your Claude Desktop config file and restart Claude Desktop.

Key features of ikas MCP Server

• Access customers, orders, products, and analytics
• Inventory management with stock levels and movements
• Marketing campaigns, promotions, and coupon creation
• Financial analysis including revenue, tax, and cashflow
• Automation suggestions and support ticket management
• Automatic pagination for large data sets

Use cases of ikas MCP Server

• Query customer details and order history via AI assistants
• Monitor inventory levels and reorder low-stock products
• Analyze revenue, campaign performance, and VIP customer segments
• Manage support tickets and suggest automation rules
• Generate tax reports and financial summaries

FAQ from ikas MCP Server

What data can I access with ikas MCP Server?

You can access customers, orders, products, inventory, marketing campaigns, promotions, coupons, financial transactions, tax reports, cashflow analysis, support tickets, and automation suggestions.

How do I set up authentication?

Set IKAS_STORE_NAME, IKAS_CLIENT_ID, and IKAS_CLIENT_SECRET in your .env file. OAuth tokens are cached in memory only and automatically refreshed every 4 hours.

Does the server handle pagination automatically?

Yes, it supports both cursor-based and page-based pagination. When you call a list function, the server automatically fetches all pages and combines them into a single response.

Can I customize VIP customer tiers?

Yes, you can define custom VIP tiers by adding a VIP_TIERS environment variable with JSON specifying name, min spend, min orders, benefits, color, and icon.

Are there any rate limits or retry logic?

The server implements automatic token refresh and retry logic for failed requests, along with graceful error handling and user-friendly messages.