@ezstats/ezstats-mcp
v0.2.1
Published
MCP server for the ezStats agent platform
Downloads
253
Maintainers
Readme
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 clientshosted: remote SSE endpoint intended to sit behindhttps://go.ezstats.io/mcp/sse
Environment
EZSTATS_API_URLEZSTATS_API_KEYEZSTATS_ALLOW_PROVISIONINGEZSTATS_MCP_HOSTEZSTATS_MCP_PORTEZSTATS_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-mcpRun hosted mode
npm install
npm run start:hostedTool 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_idwith 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
