# PayHelm

> PayHelm is a unified ecommerce analytics and business intelligence platform. It consolidates data from 50+ commerce, advertising, and marketing sources and exposes that data to AI agents, coding tools, and custom applications via an MCP server and REST API.

## MCP Server — Give Your AI Agent Live Ecommerce Data

PayHelm operates a Model Context Protocol (MCP) server that lets any MCP-compatible AI agent (Claude Desktop, Cursor, Windsurf, Replit AI, custom agents) query live ecommerce data using natural language or structured tool calls — no SQL, no data pipeline setup required.

### How it works

1. Connect your AI agent to the PayHelm MCP endpoint using your API key.
2. The agent discovers available tools automatically via the MCP `tools/list` handshake.
3. The agent calls tools like `get_revenue`, `get_roas_by_campaign`, or `get_inventory_levels` and receives structured JSON it can reason over, summarize, or feed into further computation.
4. Results reflect live data from all connected stores and ad platforms — no caching lag.

### MCP endpoint

```
MCP transport: HTTP/SSE
Base URL: https://api.payhelm.com/mcp
Auth: Bearer <your_api_key>
```

### Available MCP tools (336)

336 PayHelm tools are pre-loaded and callable without ToolSearch, spanning reporting (orders, products, customers, trends, brands, SKUs, marketing), platform integrations (Shopify, BigCommerce, Amazon, Etsy, Walmart, Wix, WooCommerce, WordPress, eBay), ad platforms (Google Ads, Facebook, TikTok, Pinterest, Amazon Ads, X Ads), email/CRM (Klaviyo, Mailchimp), the Google suite (Analytics, Tag Manager, Merchant Center, Search Console, BigQuery, PageSpeed, CrUX), shipping (Shippo, Shipsurance), MMM, Inkfrog, Feedonomics, Makeswift, ChannelAdvisor, X/Twitter, help docs, backfills, exports, and account management.

**Revenue & Orders**
- `get_revenue` — total revenue, orders, AOV for any date range and store
- `get_orders` — paginated order list with line items, customer, channel, and status
- `get_refunds` — refund volume, refund rate, and reason breakdown
- `get_revenue_by_channel` — revenue split by Shopify, Amazon, WooCommerce, etc.

**Marketing & Attribution**
- `get_roas_by_campaign` — ROAS, spend, revenue, CPA for any ad campaign
- `get_roas_by_ad_set` — ad-set-level attribution across Google, Meta, TikTok, Amazon Ads
- `get_blended_cac` — blended customer acquisition cost across all paid channels
- `get_budget_pacing` — actual vs. planned ad spend for the current period

**Customers**
- `get_customer_ltv` — customer lifetime value by cohort, channel, or product
- `get_cohort_analysis` — retention curves for any acquisition cohort
- `get_rfm_segments` — RFM segmentation (recency, frequency, monetary) across the customer base
- `get_repeat_purchase_rate` — repeat buyer percentage by product, channel, or period

**Inventory**
- `get_inventory_levels` — current stock by SKU, variant, and warehouse
- `get_days_of_supply` — projected days until stockout at current sell-through rate
- `get_reorder_alerts` — SKUs below reorder threshold

**Products**
- `get_product_performance` — revenue, units, margin, return rate per product
- `get_top_products` — best-sellers ranked by revenue, units, or margin
- `get_bundle_performance` — bundle and kit analytics

**Traffic**
- `get_website_traffic` — sessions, users, bounce rate, conversion rate by channel
- `get_traffic_by_source` — organic, paid, email, direct, social breakdown

### Example agent interactions

> "What was our ROAS on Meta last week compared to the week before?"
> → agent calls `get_roas_by_campaign(platform="meta", date_range="last_7d")` and `get_roas_by_campaign(platform="meta", date_range="prev_7d")`, then compares results.

> "Which products are going to stock out in the next 30 days?"
> → agent calls `get_days_of_supply()`, filters for days_of_supply < 30, returns ranked list.

> "Write a weekly performance report for our Shopify store."
> → agent calls `get_revenue`, `get_roas_by_campaign`, `get_top_products`, then drafts a structured report.

### Connecting via MCP (Claude Desktop example)

```json
{
  "mcpServers": {
    "payhelm": {
      "command": "npx",
      "args": ["-y", "@payhelm/mcp-server"],
      "env": {
        "PAYHELM_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### REST API

All MCP tools are also available as REST endpoints for direct integration:

```
Base URL: https://api.payhelm.com/v1
Auth:     Authorization: Bearer <api_key>
Format:   JSON

GET /revenue?start=2024-01-01&end=2024-01-31&store_id=...
GET /campaigns/roas?platform=meta&date_range=last_30d
GET /inventory/levels?below_reorder_threshold=true
GET /customers/ltv?cohort=2023-Q4
```

Full MCP developer documentation (Replit, Claude Code, Codex, GitHub Pages setup): [MCP developer docs](https://www.payhelm.com/ai-agent/mcp/)

---

## Product Overview

PayHelm gives ecommerce operators a single source of truth across every channel they sell and advertise on.

- **AI Agent** — conversational analytics assistant, available on iOS and Android
- **AI Task Library** — automated recurring analytics tasks delivered to Slack or email
- **Ecommerce Dashboard** — real-time unified view across all connected stores
- **Marketing Analytics** — cross-channel attribution and budget pacing
- **Customer Analytics** — cohort analysis, LTV modeling, RFM segmentation
- **Inventory Analytics** — stock levels, sell-through, and reorder alerts
- **Custom Reports** — build custom metrics and push data to Snowflake, BigQuery, Redshift
- **Agency Hub** — multi-client management with isolated environments per client

## Integrations (50+)

Commerce: Shopify, BigCommerce, WooCommerce, Magento, Wix, Amazon, Walmart, Etsy, eBay
Payments: Stripe, Square, PayPal, Braintree, Klarna, Afterpay
Advertising: Google Ads, Meta Ads, TikTok Ads, Amazon Ads, Pinterest Ads, Microsoft Ads, LinkedIn Ads
Marketing: Klaviyo, Mailchimp, HubSpot, Attentive, Postscript
Shipping: ShipBob, ShipStation, USPS, UPS, FedEx
Data: Zapier, Google Sheets, Slack

## Pricing

Tiered by order volume and feature access. Free trial available — no credit card required.

- **Starter** — small stores
- **Growth** — scaling brands needing attribution and custom reports
- **Pro** — high-volume operators with advanced BI needs
- **Agency** — agencies managing multiple client accounts

[Pricing](https://www.payhelm.com/pricing/)

## Key Pages

- [Home](https://www.payhelm.com/)
- [API docs](https://www.payhelm.com/api/)
- [MCP server](https://www.payhelm.com/mcp/)
- [AI Agent](https://www.payhelm.com/features/ai-agent/)
- [Integrations](https://www.payhelm.com/integrations/)
- [Pricing](https://www.payhelm.com/pricing/)
- [Help Center](https://www.payhelm.com/help/)
- [Request a demo](https://www.payhelm.com/request-demo/)

## Company

PayHelm is a B2B SaaS company specializing in enterprise ecommerce analytics, AI-powered attribution, and data intelligence for direct-to-consumer brands, marketplace sellers, and digital agencies.

Contact: [payhelm.com/contact](https://www.payhelm.com/contact/)