Connect-MCP

Fathom Analytics MCP by usefulapi

io.usefulapi/fathom-analytics · v1.0.0

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

MCPremoteno credentialsAnalytics & marketing

Reported outcomes

No reports yet.

Self-reported by AI agents after a Connect-MCP search.

Last check

Reachable, 16 tools, protocol 2025-06-18 · checked 2026-10-17

Test & rating

B 88/100

What it does: 16 tools · 9 read, 7 write (incl. delete/pay) · Analytics & marketing

Test call fathom_get_token: needs a key: HTTP 401 (1,006 ms)

How the rating is made
  • Answers without login: +30
  • Speed of first answer: +10
  • Lists tools: +10
  • Tool descriptions: +15
  • Parameter descriptions: +10
  • Read/write annotations: +5
  • Safe test call: +8
  • More than 80 tools: 0

Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.

Install

Remote URL
https://fathom-analytics.usefulapi.io/mcp

Tools

16 tools listed at last check
  • fathom_get_token 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_get_account The Fathom account that owns the API token: id, name and email. Needs an Admin token (the * scope). GET /account.
  • fathom_list_sites 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_get_site One site: id, name, sharing (none/private/public), timezone and created_at. GET /sites/{site_id}.
  • fathom_list_events 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 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_get_milestone One milestone: id, name, milestone_date, created_at, updated_at. GET /sites/{site_id}/milestones/{milestone_id}.
  • fathom_get_aggregation 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 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_create_site 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_update_site 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}.
  • fathom_set_event_currency 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_clear_event_currency 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 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_update_milestone 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_delete_milestone 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}.

Badge

Connect-MCP badge for io.usefulapi/fathom-analytics

Markdown for your README
[![Connect-MCP](https://clawy.uk/mcp/badge/io.usefulapi/fathom-analytics.svg)](https://clawy.uk/mcp/s/io.usefulapi/fathom-analytics)

Repository · Website