@ezstats/ezstats-mcp

ezStats MCP

This package provides the MCP wrapper for the ezStats agent API on https://go.ezstats.io/api/v1.

Published npm package:

@ezstats/ezstats-mcp

Modes

• stdio: local package usage for desktop MCP clients
• hosted: remote SSE endpoint intended to sit behind https://go.ezstats.io/mcp/sse

Environment

• EZSTATS_API_URL
• EZSTATS_API_KEY
• EZSTATS_ALLOW_PROVISIONING
• EZSTATS_MCP_HOST
• EZSTATS_MCP_PORT
• EZSTATS_MCP_BASE_PATH

Hosted auth

Hosted mode expects one of:

• Authorization: Bearer <api_key>
• X-EZSTATS-API-KEY: <api_key>
• ?api_key=<api_key> for simple tests

Hosted MCP also supports account-level connector flows that use ezStats OAuth on top of the same /mcp/sse endpoint. That lets users connect Claude or ChatGPT at the account level without giving those products a reusable raw API key.

If EZSTATS_ALLOW_PROVISIONING=true, unauthenticated hosted sessions may still use create_account.

Run locally

npx -y @ezstats/ezstats-mcp

Run hosted mode

npm install
npm run start:hosted

Tool coverage

The package wraps the full first-pass /api/v1 surface:

• provisioning and site setup
• site discovery for listing accessible sites and resolving a site by domain
• tracking verification and onboarding
• analytics, recent visit summaries, SEO, companies, heatmaps, anomalies, and recommendations
• goal, alert, competitor, keyword, report, and export management
• billing status, plans, upgrades, approvals, invites, and API key rotation

For multi-site users, the recommended MCP workflow is:

• call list_sites
• optionally call find_site_by_domain
• use the returned site_id with analytics or management tools

These tools are scoped to the authenticated ezStats user and only return sites that user can access.

Free plan

create_account supports plan=free for the agent-only Free plan.

The Free plan includes core analytics, up to 3 goals, and 10,000 pageviews per month.

Premium capabilities such as SEO, keyword tracking, competitor monitoring, heatmaps, funnels, email reports, Google Analytics import, company intelligence, and anomaly detection require a paid plan.

Human Setup

Inside the ezStats dashboard, open Billing & Usage and use the Connect Your AI page to:

• connect Claude with account-level OAuth using automatic client registration
• connect ChatGPT with the current account-level setup flow
• create or rotate an API key
• copy the hosted MCP URL
• copy ready-to-paste connection examples for supported AI clients