# 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.

Point a coding agent at [SKILL.md](https://www.payhelm.com/SKILL.md) for agent-native setup instructions to connect to the PayHelm MCP server.

## 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_trends_report`, `get_cross_platform_ads_performance`, or `get_inventory_summary` 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://mcp.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_orders_report` — order-level sales report: revenue totals, order count, AOV, individual order rows
- `get_line_items_report` — line-item-level data: products sold within orders, quantities, unit prices, revenue
- `get_trends_report` — time-series sales/revenue trends; first choice for period sales questions
- `get_year_comparison_report` — YoY comparison of revenue, orders, units vs. the same period last year

**Marketing & Attribution**
- `get_cross_platform_ads_performance` — cross-platform ad attribution: how ads drive sessions, conversions, and revenue, correlated with site analytics
- `get_marketing_budget_scenarios` — optimized budget allocation scenarios that maximize predicted revenue
- `get_website_traffic_summary` — high-level traffic totals for a date range (sessions, unique visitors, cart adds, checkouts, pageviews)

**Customers**
- `get_customers_report` — customer-level detail: total spend, order count, first/last order dates, location

**Inventory**
- `get_inventory_summary` — high-level inventory health summary (totals, low/out-of-stock counts)
- `get_inventory_products` — product-level inventory: stock, value, velocity, low-stock alerts
- `get_inventory_variants` — variant-level (SKU) inventory data

**Products**
- `get_products_report` — per-product sales performance (top products by revenue/units)
- `get_product_trends_report` — time-series sales data per product
- `get_brands_report` — sales aggregated by brand: revenue, units, orders, AOV

**Platform connections**
- `list_connected_platforms` — list ecommerce, ads, and marketing platforms connected to the account

### Example agent interactions

> "What were our sales trends this week compared to last week?"
> → agent calls `get_trends_report(date_range="last_7d")` and `get_trends_report(date_range="prev_7d")`, then compares results.

> "Which products are running low on stock?"
> → agent calls `get_inventory_products()`, filters for low-stock items, returns a ranked list.

> "Write a weekly performance report for our Shopify store."
> → agent calls `get_orders_report`, `get_cross_platform_ads_performance`, `get_products_report`, 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 /reports/trends?start=2024-01-01&end=2024-01-31&store_id=...
GET /ads/cross-platform-performance?date_range=last_30d
GET /inventory/summary
GET /customers/report?start=2024-01-01&end=2024-01-31
```

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

### Open source & GitHub

PayHelm publishes SDKs, MCP server packages, and integration examples as public repositories under the PayHelm GitHub organization.

- [All PayHelm repositories](https://github.com/orgs/payhelm/repositories)
- [PayHelm on GitHub](https://github.com/payhelm)

---

## 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.

- **Free** — small stores getting started
- **Entrepreneur** — growing brands needing deeper attribution and reporting
- **Business** — high-volume operators with advanced BI needs
- **Enterprise** — custom pricing for agencies and large-scale operators

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

## Key Pages

- [Home](https://www.payhelm.com/)
- [MCP server](https://www.payhelm.com/ai-agent/mcp/)
- [AI Agent](https://www.payhelm.com/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/book-demo/)
- [GitHub](https://github.com/payhelm)
- [GitHub repositories](https://github.com/orgs/payhelm/repositories)

## 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.

## Team

PayHelm was founded in 2021 by Andrew Sukow, who previously co-founded Terapeak (eBay market research software, founded 2003, acquired by eBay in 2017 after growing to 1.3M+ merchants). PayHelm is built by a small, hands-on team of enterprise SaaS and AI/data engineers who work directly with customers, based across Victoria, Vancouver, Calgary, Toronto, Los Angeles, Nashville, Minneapolis, and remote.

[Meet the team](https://www.payhelm.com/about/)

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