MCP Server

The Zappush MCP server connects your AI assistant to your store. Once set up, you can ask questions like "what was my conversion rate last week?" and get answers from your real data, no dashboards or SQL required.

It works with Claude, Cursor, Windsurf, VS Code, and anything else that supports MCP.

1. Add the server

Pick your tool. Most have a one-click install.

Cursor

Install Zappush MCP in Cursor

Claude Code

Run this in your terminal:

claude mcp add zappush -- npx -y @zappush/mcp

Claude Desktop

Open Settings > Developer > Edit Config, add zappush to mcpServers, and restart:

"zappush": {
  "command": "npx",
  "args": ["-y", "@zappush/mcp"]
}

Windsurf

Open Settings > MCP > Add Server > Custom. Set the name to zappush and the command to npx -y @zappush/mcp.

VS Code

Open the Command Palette and run MCP: Add Server. Choose Command (stdio), enter npx -y @zappush/mcp, and name it zappush.

2. Log in

Run this once after adding the server:

npx @zappush/mcp login

Your browser opens. Sign in to your Zappush account and authorize access. After that, your credentials refresh automatically and you do not need to log in again.

3. Start asking questions

Your assistant now has access to your store's data. Try things like:

• "How many events happened in the last 24 hours?"
• "Show me revenue by channel for last month"
• "What's my conversion rate by country this week?"
• "Which products have the highest add-to-cart rate?"
• "How is CAPI delivery health looking for Meta?"
• "Compare mobile vs desktop conversion rates this month"

The assistant reads your table schema, writes the query, and returns results. You do not need to know SQL.

Multiple stores

If you manage more than one store, mention the store by name and the assistant resolves it for you. You can also ask "which stores do I have access to?" to see the full list.

What data is available

Your assistant can query events, sessions, orders, attribution touchpoints, shopper profiles, product catalog, traffic routes, and server-side delivery health. All the data you see in your Zappush dashboard is available here.

Security

Every query is read-only and sandboxed. Your assistant can only see data from stores you have access to. Write operations are blocked, and each query runs in an isolated session scoped to your store.

Uninstall

For Claude Code:

claude mcp remove zappush

For other clients, remove zappush from your MCP server settings.