{
  "markdown": "# ezStats MCP\n\nThis package provides the MCP wrapper for the ezStats agent API on `https://go.ezstats.io/api/v1`.\n\nPublished npm package:\n\n`@ezstats/ezstats-mcp`\n\n## Modes\n\n- `stdio`: local package usage for desktop MCP clients\n- `hosted`: remote SSE endpoint intended to sit behind `https://go.ezstats.io/mcp/sse`\n\n## Environment\n\n- `EZSTATS_API_URL`\n- `EZSTATS_API_KEY`\n- `EZSTATS_ALLOW_PROVISIONING`\n- `EZSTATS_MCP_HOST`\n- `EZSTATS_MCP_PORT`\n- `EZSTATS_MCP_BASE_PATH`\n\n## Hosted auth\n\nHosted mode expects one of:\n\n- `Authorization: Bearer <api_key>`\n- `X-EZSTATS-API-KEY: <api_key>`\n- `?api_key=<api_key>` for simple tests\n\nHosted 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.\n\nIf `EZSTATS_ALLOW_PROVISIONING=true`, unauthenticated hosted sessions may still use `create_account`.\n\n## Run locally\n\n```bash\nnpx -y @ezstats/ezstats-mcp\n```\n\n## Run hosted mode\n\n```bash\nnpm install\nnpm run start:hosted\n```\n\n## Tool coverage\n\nThe package wraps the full first-pass `/api/v1` surface:\n\n- provisioning and site setup\n- site discovery for listing accessible sites and resolving a site by domain\n- tracking verification and onboarding\n- analytics, recent visit summaries, SEO, companies, heatmaps, anomalies, and recommendations\n- goal, alert, competitor, keyword, report, and export management\n- billing status, plans, upgrades, approvals, invites, and API key rotation\n\nFor multi-site users, the recommended MCP workflow is:\n\n1. call `list_sites`\n2. optionally call `find_site_by_domain`\n3. use the returned `site_id` with analytics or management tools\n\nThese tools are scoped to the authenticated ezStats user and only return sites that user can access.\n\n## Free plan\n\n`create_account` supports `plan=free` for the agent-only Free plan.\n\nThe Free plan includes core analytics, up to 3 goals, and 10,000 pageviews per month.\n\nPremium capabilities such as SEO, keyword tracking, competitor monitoring, heatmaps, funnels, email reports, Google Analytics import, company intelligence, and anomaly detection require a paid plan.\n\n## Human Setup\n\nInside the ezStats dashboard, open Billing & Usage and use the `Connect Your AI` page to:\n\n- connect Claude with account-level OAuth using automatic client registration\n- connect ChatGPT with the current account-level setup flow\n- create or rotate an API key\n- copy the hosted MCP URL\n- copy ready-to-paste connection examples for supported AI clients",
  "bytes": 2571,
  "sha": "07dae0984a93641f69e8c10a45e145d17223d204e7020adcc1ce85fbdf91e53c",
  "repo_slug": "",
  "fonte": "npm",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_ezstats_ezstats_mcp_2c91b563/readme"
}