Presso

Install

Config snippet generator goes here (5 client tabs)

README

# Presso

[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
[![npm version](https://img.shields.io/npm/v/presso-mcp)](https://www.npmjs.com/package/presso-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

<p align="center">
  <img src="assets/logo-400x400.png" alt="Presso Logo" width="200" />
</p>

<p align="center">
  <a href="https://presso.now">Website</a> · <a href="https://app.presso.now/signup">Get Started</a> · <a href="https://presso.now/docs">Docs</a>
</p>

## Overview

[Presso](https://presso.now) is an MCP server that connects your e-commerce and marketing data sources — Shopify, Google Analytics 4, Google Ads, Meta Ads, and more — directly to AI assistants like Claude. Instead of switching between dashboards, ask questions in natural language and get instant answers about your store's performance, ad campaigns, and customer behavior.

The MCP endpoint is a remote HTTP server. Most AI clients (Claude Code, Claude Desktop, Cursor, VS Code) can connect directly. For clients that only support stdio, a lightweight npm proxy (`presso-mcp`) is also available.

## Features

- **11 data source integrations** — Shopify, GA4, Google Ads, Meta Ads, Search Console, Google Merchant Center, Amazon Ads, GTM, Klaviyo, ShipStation, Judge.me
- **100+ tools** — Products, orders, customers, analytics reports, ad campaigns, keyword analysis, shipping, reviews, and more
- **Cross-platform analysis** — Correlate data across Shopify + GA4 + ad platforms in a single conversation
- **Natural language queries** — No SQL or API knowledge required. Ask like you would ask an analyst
- **Real-time data** — Fetches live data from source APIs on every request
- **Read-only access** — Presso never modifies your store data, ad campaigns, or settings
- **OAuth authentication** — Secure token-based access. Presso never stores your passwords
- **Encrypted at rest and in transit** — AES-256 encryption for tokens, TLS 1.2+ for all traffic
- **No permanent raw data storage** — Query results are streamed to the AI client and not retained

## Supported Data Sources

| Data Source | Description | Tools |
|---|---|---|
| **Shopify** | Products, orders, customers, inventory, payments, analytics | 25+ |
| **Google Analytics 4** | Reports, dimensions, metrics, real-time data, funnels | 5 |
| **Google Ads** | Campaigns, ad groups, keywords, quality scores, ROAS | 7 |
| **Meta Ads** | Campaigns, ad sets, creatives, audience insights | 9 |
| **Google Search Console** | Search queries, rankings, CTR, sitemaps | 3 |
| **Google Merchant Center** | Product feeds, status, diagnostics, price competitiveness | 7 |
| **Amazon Ads** | Sponsored products/brands/display, search terms, ACoS | 7 |
| **Google Tag Manager** | Containers, tags, triggers, variables, versions | 12 |
| **Klaviyo** | Campaigns, flows, profiles, segments, predictive analytics | 18 |
| **ShipStation** | Shipments, labels, carriers, rates, inventory, warehouses | 29 |
| **Judge.me** | Reviews, ratings, reviewer profiles, shop statistics | 10 |

## Quick Start

### 1. Create your Presso account

Go to [app.presso.now/signup](https://app.presso.now/signup) and create an account. No credit card required — every account starts with a 14-day free trial.

### 2. Connect your data sources

From the Presso dashboard, click **Add Connection**, select a data source (e.g., Shopify, GA4), and authorize via OAuth. Repeat for each data source you want to query.

### 3. Add Presso to your MCP client

See the configuration section below for your specific client.

## MCP Client Configuration

### Claude Code

Open your terminal and run:

```bash
claude mcp add --transport http presso https://mcp.presso.now/mcp
```

Then start a new Claude Code session:

```bash
claude
```

Claude Code will automatically detect Presso's tools. Try asking: `"Show me my top-selling products from last week."`

### Claude Desktop

1. Open Claude Desktop → **Settings** → **Developer** → **Edit Config**.
2. Add Presso to the `mcpServers` section:

```json
{
  "mcpServers": {
    "presso": {
      "type": "http",
      "url": "https://mcp.presso.now/mcp"
    }
  }
}
```

3. Save and restart Claude Desktop.

### Cursor

Add to your Cursor MCP settings (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "presso": {
      "url": "https://mcp.presso.now/mcp"
    }
  }
}
```

### VS Code (Copilot)

Add to your VS Code settings (`settings.json`):

```json
{
  "mcp": {
    "servers": {
      "presso": {
        "type": "http",
        "url": "https://mcp.presso.now/mcp"
      }
    }
  }
}
```

### stdio via npx

For MCP clients that only support stdio transport, use the `presso-mcp` proxy:

```bash
npx -y presso-mcp
```

Or configure it in your MCP client's JSON:

```json
{
  "mcpServers": {
    "presso": {
      "command": "npx",
      "args": ["-y", "presso-mcp"],
      "env": {
        "PRESSO_API_KEY": "your-ap