# Firstlytics

> Firstlytics is a freemium MCP server for analytics and data. Ask Claude about your web and product analytics and manage goals and funnels. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://firstlytics.com/docs/settings/mcp-server/
- **Repository:** https://github.com/firstlytics/mcp
- **MCP Registry name:** io.github.firstlytics/mcp
- **Categories:** analytics and data
- **Listing updated:** 2026-11-15

## About

Firstlytics is cookieless first-party analytics, and its MCP server lets an assistant answer questions such as where last week's signups came from. It signs in with an organisation API key whose scopes set what the assistant can do, and a key limited to some sites only sees those.

Stats scopes cover reports for overview, time series, breakdowns, live visitors, sessions, events, errors, Web Vitals, journeys and funnels. Site scopes list or change sites, goals and funnels; member scopes list or invite people. The docs suggest read-only scopes for reporting and say the assistant asks before deleting, with a site deletion needing its domain typed out.

run_query and get_query_schema give custom SQL, but only on the Scale plan. Use the hosted Streamable HTTP endpoint, or the stdio npm package that bridges to it.

## Features

- **Scoped API keys:** Scopes limit reading, writing and member access.
- **Report tools:** Overview, breakdowns, live stats, sessions, events and errors.
- **Funnels:** List, analyze, save and delete funnels.
- **Custom SQL:** Run queries on the Scale plan.
- **Site management:** Create, update and delete sites.
- **Hosted or stdio:** Remote endpoint or npx bridge.

## Good for

- Find where signups came from last week
- Analyze a checkout funnel
- Check Web Vitals and JavaScript errors
- Create goals without opening the dashboard

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://api.firstlytics.com/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.firstlytics.com/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://api.firstlytics.com/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://api.firstlytics.com/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://api.firstlytics.com/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://api.firstlytics.com/v1/mcp"
    }
  }
}
```

## Tools

- `list_sites`: Lists the sites the key sees.
- `get_site`: Returns one site's settings.
- `create_site`: Adds a site.
- `update_site_config`: Changes site settings.
- `delete_site`: Deletes a site.
- `get_overview`: Visitors, visits, page views and bounce rate.
- `get_overview_timeseries`: The same over time.
- `get_breakdown`: Top pages, sources, countries and devices.
- `get_live_stats`: Visitors now and in the last 30 minutes.
- `get_sessions`: Lists visits.
- `get_session`: Shows every event of one visit.
- `get_events`: Recent events.
- `get_event_names`: Custom events with counts.
- `get_errors`: JavaScript errors.
- `get_web_vitals`: Core Web Vitals.
- `get_journeys`: Common paths.
- `get_funnels`: Lists funnels.
- `analyze_funnel`: Analyzes a funnel.
- `save_funnel`: Saves a funnel.
- `delete_funnel`: Deletes a funnel.
- `run_query`: Custom SQL on the Scale plan.
- `get_query_schema`: Schema for custom SQL.

## FAQ

### Which plans include the MCP server?

The report tools work on every plan; SQL tools need Scale.

### Can it delete data?

With write scopes, and it asks first; deleting a site needs its domain typed.

### How does Claude Desktop connect?

Via npx -y @firstlytics/mcp with FIRSTLYTICS_API_KEY.

### What does the free plan include?

1,000 events a month, 13 months retention, no support.

### Is Firstlytics free?

Firstlytics has a free plan, with paid plans for more usage or features.

### How do I add Firstlytics to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://api.firstlytics.com/v1/mcp

### What are the best alternatives to Firstlytics?

The closest alternatives to Firstlytics are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/firstlytics
