MCP server

Fathom Analytics MCP by usefulapi

io.usefulapi/fathom-analytics

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Query Fathom Analytics sites, stats, current visitors and events, and manage sites and events.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

16

Token cost

About 4,699 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http fathom-analytics https://fathom-analytics.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.fathom-analytics]
url = "https://fathom-analytics.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"fathom-analytics":{"httpUrl":"https://fathom-analytics.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"fathom-analytics":{"url":"https://fathom-analytics.usefulapi.io/mcp"}}}

VS Code

{"servers":{"fathom-analytics":{"type":"http","url":"https://fathom-analytics.usefulapi.io/mcp"}}}

Antigravity

agy mcp add fathom-analytics https://fathom-analytics.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"fathom-analytics","server_url":"https://fathom-analytics.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"fathom-analytics","server_url":"https://fathom-analytics.usefulapi.io/mcp"}

Tools

• fathom_clear_event_currency ~202 tokens
  Remove the currency set for an event, so it uses the site's default again. The event and its completion data stay. Needs a manage token for the site. DELETE /sites/{site_id}/events?name=.
• fathom_create_milestone ~218 tokens
  Add a milestone (a dated annotation shown on the site's reports, e.g. a launch or campaign start). Needs a manage token for the site. POST /sites/{site_id}/milestones.
• fathom_create_site ~361 tokens
  Create a new site in the Fathom account (returns its id, used in the tracking code). Needs an Admin token. Sharing private needs share_password; multi_domain true needs multi_domain_option. POST /sites.
• fathom_delete_milestone Deletes data · ~211 tokens
  Permanently delete a milestone (only the annotation; traffic data is not touched). Cannot be undone. Needs a manage token for the site. DELETE /sites/{site_id}/milestones/{milestone_id}.
• fathom_get_account ~76 tokens
  The Fathom account that owns the API token: id, name and email. Needs an Admin token (the * scope). GET /account.
• fathom_get_aggregation ~1225 tokens
  Fathom's custom report (the dashboard's numbers): aggregate pageviews or one event over a date range, optionally grouped by date and/or fields and filtered. Pageviews: aggregates visits (unique site visits), uniques (unique page visits), pageviews, avg_duration (seconds), bounce_rate. Events (entity
• fathom_get_current_visitors ~183 tokens
  Live visitors on a site right now: the total, and with detailed true the top 150 pages (hostname, pathname, total) and top 150 referrers. GET /current_visitors.
• fathom_get_milestone ~189 tokens
  One milestone: id, name, milestone_date, created_at, updated_at. GET /sites/{site_id}/milestones/{milestone_id}.
• fathom_get_site ~127 tokens
  One site: id, name, sharing (none/private/public), timezone and created_at. GET /sites/{site_id}.
• fathom_get_token ~112 tokens
  The connected API token's name, permissions (abilities: "*" = Admin, "all-sites-readonly", or per-site read:<id> / manage:<id>) and timestamps. The secret value is never returned. Good first call to know which tools will work. GET /token.
• fathom_list_events ~310 tokens
  List a site's events (conversions/goals): every event name the site has tracked plus events with a currency set, sorted by name. Identify events by name (use it as event_name in fathom_get_aggregation); the id is only a paging cursor. Paged: pass next.starting_after. GET /sites/{site_id}/events.
• fathom_list_milestones ~279 tokens
  List a site's milestones (dated annotations on reports, such as a redesign launch or a campaign start), oldest first. Paged: pass next.starting_after. GET /sites/{site_id}/milestones.
• fathom_list_sites ~261 tokens
  List the sites the token can read (id, name, sharing, timezone, created_at), oldest first. The site id is what every report tool takes. Needs an Admin or all-sites read-only token; a token scoped to a single site cannot list sites, so use fathom_get_site with that site id instead. Paged: pass next.s
• fathom_set_event_currency ~280 tokens
  Set the currency of an event's value by event name (works before the event is first tracked). Needs a manage token for the site. POST /sites/{site_id}/events/currency.
• fathom_update_milestone ~271 tokens
  Rename or re-date a milestone (both name and milestone_date are required). Needs a manage token for the site. POST /sites/{site_id}/milestones/{milestone_id}.
• fathom_update_site ~394 tokens
  Change a site's name, sharing, timezone or multi-domain setting (send only what changes). Changing the timezone changes how reports are bucketed. Needs a manage token for the site. POST /sites/{site_id}.

Browse

• Fathom tools
• Website monitoring
• Email
• Email marketing

Related MCP servers

• Plausible MCP by usefulapi
  Query site stats, realtime visitors, breakdowns and goals from Plausible Analytics.
• Simple Analytics MCP by usefulapi
  Read Simple Analytics stats: pageviews, visitors, pages, referrers, events and data exports.
• Pirsch Analytics MCP by usefulapi
  Read Pirsch web analytics: visitors, pages, referrers, UTM, events, funnels and sessions.
• KrystalView Analytics
  Read-only MCP access to sessions, funnels, campaigns, errors, live visitors, and anomalies.
• DropTheHassle
  Your AI publishes your site: free HTTPS link, or a .com for €19 that goes live with no DNS.
• Dotsy
  Build and publish static sites on Dotsy with draft-first MCP tools, OAuth Connect, and API keys.
• VibeDeploy
  Deploy AI-built sites and apps to EU hosting from your AI agent. OAuth sign-in, 14-day free trial.
• miow
  Build and host a small business website: write its pages, move an existing site in, add a domain.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/fathom-analytics.svg)](https://aptlynx.net/servers/io.usefulapi/fathom-analytics)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents