Model Context Protocol

Your store,
in the AI
you already use

Ask Claude, Cursor or any MCP-compatible AI about your KartmaX store — revenue, orders, margins, COD risk, OMS sync — in plain language. No dashboards. No exports.

View integrations Browse tools
MCP server URL https://mcp.kartmax.in/mcp
Claude — KartmaX MCP
Integrations

Works with your AI stack

Add the MCP server URL once. Sign in with KartmaX. Done.

Claude Desktop

Add to claude_desktop_config.json under mcpServers.

"mcpServers": { "kartmax": { "type": "http", "url": "https://mcp.kartmax.in/mcp" } }

Claude will prompt you to sign in the first time via browser OAuth.

Cursor

Open Settings → MCP → Add server and paste the URL, or add to .cursor/mcp.json.

{ "mcpServers": { "kartmax": { "url": "https://mcp.kartmax.in/mcp", "transport": "http" } } }

Windsurf (Codeium)

Go to Windsurf Settings → MCP Servers → Add and enter the server URL.

{ "mcpServers": { "kartmax": { "serverUrl": "https://mcp.kartmax.in/mcp" } } }

Any MCP Client

This server follows the open MCP specification with OAuth 2.1. Any client that supports remote HTTP MCP servers will work.

MCP Endpoint : https://mcp.kartmax.in/mcp Transport : Streamable HTTP Auth : OAuth 2.1 + PKCE Discovery URL : https://mcp.kartmax.in/.well-known/oauth-authorization-server
Tool directory

49 tools, purpose-built for merchants

Browse by category — each tool ties to your KartmaX admin data. The list is the same for most setups; if you run the server locally, you may see a couple of extra sign-in helpers.

Morning Briefing
One-call daily executive summary for a report day (default: yesterday) vs a prior baseline (default: 7 days). Revenue, traffic, conversion, OMS backlog, refunds, abandoned carts, payments — plus optional heuristic insights.
kartmax_morning_briefing
Area Summary
Same engine as the morning brief, scoped to one area: revenue, traffic & marketing, conversion, fulfillment risk, refunds & abandonment, or customer voice (NPS pointers).
kartmax_executive_area_summary
Auth Status
Check if you're logged in and which admin account is active in the current session.
kartmax_auth_status
Login
Sign in with admin email and password. Stdio / local MCP only — in HTTP mode you authenticate via browser OAuth instead.
kartmax_login
Logout
Clear the stored KartmaX token. Stdio / local MCP only.
kartmax_logout
List Sites
Get all stores linked to your account with site tokens. Supports pagination for accounts with many stores.
kartmax_list_sites
Select Site
Set the active store for all subsequent queries. Required before fetching any store-specific data.
kartmax_select_site
Active Site
Show which store is currently selected and its basic details.
kartmax_active_site
Help
List all available tools with example questions — useful as a starting point in any AI conversation.
kartmax_help
Dashboard Matrix
GMV, total orders, AOV, COD share %, cancel rate, return rate, new customer signups — all in one response for any date range.
kartmax_dashboard_matrix
Daily Trend
Day-by-day breakdown of orders, GMV, new vs returning customers. Detects peak days and computes daily averages.
kartmax_dashboard_trend
Recent Orders
Latest orders showing customer name, order amount, payment method, and fulfilment status.
kartmax_recent_orders
Top Selling Products
Best-selling products ranked by units sold and total revenue for the selected date range.
kartmax_top_selling_products
Payment Splits
COD vs online payment method breakdown — order counts and percentage splits for any date range.
kartmax_payment_splits
List Orders
Paginated order list filtered by status: all, successful, pending_payment, or transaction failure. Includes customer, amount, and payment info.
kartmax_list_orders
List Order Items
Item-level fulfilment list with SKU, size, selling price, warehouse cost, and tracking info. Supports 8 status filters including in-transit, delivered, and cancelled.
kartmax_list_order_items
List Products
Browse and search the full product catalogue. Filter by status (active/inactive), stock status (in-stock/out-of-stock), or keyword. Paginated.
kartmax_list_products
Out-of-Stock Products
Quickly identify OOS products. Filter by active status to find live storefront pages with zero inventory — potential lost sales.
kartmax_out_of_stock_products
Inactive Products
Find disabled products. Use stock_status=in-stock to find inactive products that have stock ready to sell — revenue left on the table.
kartmax_inactive_products
Product Discount Analysis
Analyse pricing gaps across the catalogue. Shows discount % (MRP vs selling price), sorted deepest first. Filter by minimum discount threshold.
kartmax_product_discount_analysis
Catalogue Health
One-shot health snapshot: total products, active vs inactive, in-stock vs out-of-stock, active-OOS pages, and idle stock on disabled products.
kartmax_catalogue_health
List Categories
Fetch all catalogue categories in a flat list. Optionally filter by keyword. Shows id, uuid, full hierarchical name, and parent info.
kartmax_list_categories
Category Tree
Full category hierarchy as a nested tree — root categories with their children and grandchildren. Shows tree depth, child counts, and total category stats.
kartmax_category_tree
List Customers
Browse paginated customer list with date range and status filters. Shows name, contact, verification status, COD block flag, and city.
kartmax_list_customers
New Customer Signups
Summary of new registrations in a date range — total count, mobile verification rate, email completion, address saved, and COD block rate.
kartmax_new_customers
List NPS Responses
Browse individual Net Promoter Score responses from customers — rating (1–10), customer name, phone, linked order, and comment. Promoters (9–10), Passives (7–8), Detractors (0–6).
kartmax_list_nps
NPS Summary
Calculate the overall NPS score (Promoters% − Detractors%), rating distribution, average score, and recent comments from promoters and detractors. Samples up to 50 recent responses.
kartmax_nps_summary
List Pincodes
Browse all shipping pincodes with search (pincode/city), state filter, and pagination. Shows COD/prepaid/returns flags and delivery TAT per pincode.
kartmax_list_pincodes
Pincode Lookup
Check full serviceability for a specific pincode — COD availability, prepaid, returns support, QC, forward delivery TAT, and reverse pickup time.
kartmax_pincode_lookup
List Coupons
Browse all promotions and coupons. Filter by discount type (percentage/fixed/shipping_free/bogo) and status. Paginated with full details including validity dates, min order, restrictions, and display settings.
kartmax_list_coupons
Active Coupons
Get all coupons that are currently live — status active and today's date within their validity window. Filter by discount type.
kartmax_active_coupons
Coupon Summary
High-level overview of all promotions — total counts and breakdown by type (percentage/fixed/shipping_free/bogo), plus active, app-only, and displayed coupon stats.
kartmax_coupon_summary
GMV Trend
Daily Gross Merchandise Value trend for a date range with bar chart, total, and average.
kartmax_gmv_trend
AOV Trend
Average Order Value day-by-day with highest/lowest day callouts.
kartmax_aov_trend
Refund Trend
Daily refund counts with total for the period.
kartmax_refund_trend
Abandoned Cart Trend
Daily abandoned cart (ABC) counts — carts created but not converted to orders.
kartmax_abandoned_cart_trend
Coupon Performance
Per-coupon usage count, total discount given, and average discount per application.
kartmax_coupon_performance
GMV by Category
Revenue breakdown by product category with percentage share.
kartmax_gmv_by_category
GMV by Channel
Revenue breakdown by marketing/traffic channel (Facebook/Instagram, Organic, etc.).
kartmax_gmv_by_channel
COD vs Prepaid GMV Split
GMV split between COD and prepaid payment modes with percentage shares.
kartmax_cod_prepaid_gmv_split
Orders by State
Geographic order count breakdown by Indian state, sorted by volume.
kartmax_orders_by_state
Top Cancelled Products
Products with the most cancellations, with cancel count and revenue lost.
kartmax_top_cancelled_products
Session Trend
Daily session counts with total and average. Shows traffic volume trend over time.
kartmax_session_trend
Sessions by Campaign
Session breakdown by marketing channel (Organic, Facebook/Instagram, Google) with percentage share.
kartmax_session_by_campaign
Conversion Funnel
Full funnel from session → product view → cart → checkout → payment → order. Shows drop-off at each step and overall conversion rate.
kartmax_conversion_funnel
Device Split
Mobile vs desktop session breakdown with percentage shares.
kartmax_device_split
OMS Sync Health
Identify orders not yet synced to your OMS (oms_sync_status=0). Catch fulfilment pipeline failures before they cascade into customer issues.
kartmax_sync_health
Item Margin Analysis
Per-item profitability using warehouse cost fields. Returns selling price, product cost, margin %, and a full coupon and loyalty discount breakdown.
kartmax_item_margin_analysis
COD Risk Summary
List COD-blocked orders with block reasons, COD risk scores, and total GMV at risk — paginated so you can scan across a date range.
kartmax_cod_risk_summary
Channel Breakdown
Web vs App vs iOS vs Android — order count, GMV, AOV, and preferred payment methods per channel for any date range.
kartmax_channel_breakdown
What you can ask

Merchant intelligence, in plain language

Every tool is purpose-built for e-commerce operations. No generic queries — just store-specific answers.

Dashboard & KPIs

Real-time GMV, total orders, AOV, COD share, cancel rate, return rate — all in one answer.

"How are sales this week?" "What's our AOV today?" "Compare this month vs last"

Daily Trends

Day-by-day breakdown of orders, GMV, new vs returning customers. Peak day detection and daily averages.

"Daily trend for March" "Which day peaked?" "New customers per day"

Orders & Items

Paginated order and item lists filtered by status — all, successful, pending, in-transit, delivered, cancelled.

"Show today's orders" "List cancelled items" "In-transit this week"

COD Risk Analysis

Spot COD-blocked orders before fulfilment fails. See block reasons, COD scores, and GMV at risk by page.

"COD blocked today?" "Top block reasons" "GMV at risk this week"

Margin Analysis

Per-item profitability using warehouse cost fields. Selling price vs product cost, margin %, coupon and loyalty discount breakdown.

"Item margins this week" "Coupon impact on margin" "Gross margin this month"

Channel Breakdown

Web vs App, iOS vs Android — order count, GMV, AOV and preferred payment methods per channel.

"Web vs App GMV" "iOS vs Android orders" "App payment preferences"

Payment Splits

COD vs Razorpay vs Snapmint vs Credits — order count and percentage breakdown for any date range.

"COD % this month" "Payment method splits" "Razorpay orders today"

OMS Sync Health

Find orders not yet synced to your OMS. Catch fulfilment failures before they cascade into customer issues.

"Unsynced orders today?" "OMS sync failures" "Orders stuck in sync"

Top Selling Products

Best-selling products by quantity sold and revenue. Surface demand signals without opening any report.

"Best sellers this week" "Top products by revenue" "What's trending this month?"
Getting started

Up and running in 3 steps

From zero to asking your first question in under 2 minutes.

1

Add the MCP server URL to your AI app

Paste https://mcp.kartmax.in/mcp as a remote MCP server in Claude Desktop, Cursor, Windsurf or any compatible client.

2

Sign in with your KartmaX account

Your AI app will open a browser window. Log in with your existing KartmaX admin email and password. No new account needed.

3

Select your store and start asking

In the chat, say "list my sites", pick your store, then ask anything — "What's our GMV today?" or "Show COD blocked orders this week".

Example questions

Things merchants ask every day

"How did yesterday compare to last week?"
"What's our COD vs prepaid split this month?"
"Any orders stuck before OMS sync?"
"Which channel is driving the most GMV?"
"What are the top selling products this week?"
"Show me COD blocked orders and their reasons"
"How much are coupon discounts eating into margins?"
"List all cancelled items from last 7 days"
"Show me the daily trend for March"
Ready to start?

Connect your KartmaX store
to your AI — for free

Sign in once with your existing KartmaX admin account. No new credentials needed. Select your store. Ask your first question.

Get started free View setup guides