Fathom Analytics MCP by usefulapi is an MCP server published by io.usefulapi, hosted at fathom-analytics.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 16 tools, including fathom_get_token, fathom_get_account, fathom_list_sites, fathom_get_site, fathom_list_events.
Query Fathom Analytics sites, stats, current visitors and events, and manage sites and events.
4,084 connections through 5 shared values. Tap any node.
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.
No parameters.
{
"name": "fathom_get_token",
"title": "Get the API token's permissions",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the API token's permissions",
"readOnlyHint": true,
"openWorldHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The Fathom account that owns the API token: id, name and email. Needs an Admin token (the * scope). GET /account.
No parameters.
{
"name": "fathom_get_account",
"title": "Get the account",
"description": "The Fathom account that owns the API token: id, name and email. Needs an Admin token (the * scope). GET /account.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get the account",
"readOnlyHint": true,
"openWorldHint": true
}
}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.starting_after. GET /sites.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| ending_before | string | Page backward from this object id (newest first). Not together with starting_after. |
| starting_after | string | Page forward: pass next.starting_after from the previous reply (an object id). |
{
"name": "fathom_list_sites",
"title": "List sites",
"description": "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.starting_after. GET /sites.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"ending_before": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Page backward from this object id (newest first). Not together with starting_after."
},
"starting_after": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Page forward: pass next.starting_after from the previous reply (an object id)."
}
}
},
"annotations": {
"title": "List sites",
"readOnlyHint": true,
"openWorldHint": true
}
}One site: id, name, sharing (none/private/public), timezone and created_at. GET /sites/{site_id}.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
{
"name": "fathom_get_site",
"title": "Get a site",
"description": "One site: id, name, sharing (none/private/public), timezone and created_at. GET /sites/{site_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
}
}
},
"annotations": {
"title": "Get a site",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| ending_before | string | Page backward from this object id (newest first). Not together with starting_after. |
| starting_after | string | Page forward: pass next.starting_after from the previous reply (an object id). |
{
"name": "fathom_list_events",
"title": "List a site's events",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"ending_before": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Page backward from this object id (newest first). Not together with starting_after."
},
"starting_after": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Page forward: pass next.starting_after from the previous reply (an object id)."
}
}
},
"annotations": {
"title": "List a site's events",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page, 1-100 (default 10). |
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| ending_before | string | Page backward from this object id (newest first). Not together with starting_after. |
| starting_after | string | Page forward: pass next.starting_after from the previous reply (an object id). |
{
"name": "fathom_list_milestones",
"title": "List a site's milestones",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page, 1-100 (default 10)."
},
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"ending_before": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Page backward from this object id (newest first). Not together with starting_after."
},
"starting_after": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "Page forward: pass next.starting_after from the previous reply (an object id)."
}
}
},
"annotations": {
"title": "List a site's milestones",
"readOnlyHint": true,
"openWorldHint": true
}
}One milestone: id, name, milestone_date, created_at, updated_at. GET /sites/{site_id}/milestones/{milestone_id}.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| milestone_id * | string | The milestone id (a UUID, from fathom_list_milestones). |
{
"name": "fathom_get_milestone",
"title": "Get a milestone",
"description": "One milestone: id, name, milestone_date, created_at, updated_at. GET /sites/{site_id}/milestones/{milestone_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"milestone_id"
],
"properties": {
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"milestone_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The milestone id (a UUID, from fathom_list_milestones)."
}
}
},
"annotations": {
"title": "Get a milestone",
"readOnlyHint": true,
"openWorldHint": true
}
}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 event + event_name): conversions, unique_conversions, value (in cents). Examples: top pages = field_grouping [pathname], sort_by pageviews:desc; traffic sources = [referrer_source] or [referrer_hostname]; AI referrals = [ai_source]; daily trend = date_grouping day. All numbers come back as strings. Dates are in the site's timezone; hour grouping only for ranges up to 7 days. Grouped reports return at most 500 rows unless limit is set (max 1000, no paging), so narrow with filters or dates. Data before March 2021 cannot be grouped/filtered. GET /aggregations.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Row cap, 1-1000 (default 500 when grouping by fields). |
| entity * | string | pageview = site traffic; event = one event's conversions (needs event_name). |
| date_to | string | End, YYYY-MM-DD (end of day) or "YYYY-MM-DD HH:MM:SS", in the site's timezone. Default: now. |
| filters | array | Filters, all applied (AND). Example: [{"property":"country_code","operator":"is","value":"GB"}]. |
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| sort_by | string | "<field>:asc|desc" with a field from aggregates or field_grouping (or timestamp with date_grouping), e.g. pageviews:desc. |
| date_from | string | Start, YYYY-MM-DD (start of day) or "YYYY-MM-DD HH:MM:SS", in the site's timezone. Default: the first recorded data. |
| aggregates * | array | Metrics. pageview: visits, uniques, pageviews, avg_duration, bounce_rate. event: conversions, unique_conversions, value. |
| event_name | string | For entity event: the event's name, as listed by fathom_list_events. |
| date_grouping | string | Group by time (omit for one total). hour only for ranges up to 7 days. |
| field_grouping | array | Group by these fields, e.g. [pathname] or [referrer_source, utm_campaign]. |
{
"name": "fathom_get_aggregation",
"title": "Run a traffic or event report",
"description": "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 event + event_name): conversions, unique_conversions, value (in cents). Examples: top pages = field_grouping [pathname], sort_by pageviews:desc; traffic sources = [referrer_source] or [referrer_hostname]; AI referrals = [ai_source]; daily trend = date_grouping day. All numbers come back as strings. Dates are in the site's timezone; hour grouping only for ranges up to 7 days. Grouped reports return at most 500 rows unless limit is set (max 1000, no paging), so narrow with filters or dates. Data before March 2021 cannot be grouped/filtered. GET /aggregations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"entity",
"aggregates"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Row cap, 1-1000 (default 500 when grouping by fields)."
},
"entity": {
"enum": [
"pageview",
"event"
],
"type": "string",
"description": "pageview = site traffic; event = one event's conversions (needs event_name)."
},
"date_to": {
"type": "string",
"maxLength": 19,
"minLength": 10,
"description": "End, YYYY-MM-DD (end of day) or \"YYYY-MM-DD HH:MM:SS\", in the site's timezone. Default: now."
},
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"property",
"operator",
"value"
],
"properties": {
"value": {
"type": "string",
"maxLength": 1000,
"description": "The value to compare with, always a string (e.g. /pricing, GB, Mobile, ChatGPT)."
},
"operator": {
"enum": [
"is",
"is not",
"is like",
"is not like",
"matching",
"not matching"
],
"type": "string",
"description": "is, is not, is like (contains, * wildcards), is not like, matching (regex), not matching. Categorical fields (device_type, operating_system, browser, country_code, city, state, region) allow only is / is not."
},
"property": {
"enum": [
"domain",
"hostname",
"pathname",
"entry_page",
"exit_page",
"referrer_hostname",
"referrer_pathname",
"referrer_source",
"ai_source",
"browser",
"country_code",
"city",
"state",
"region",
"device_type",
"operating_system",
"utm_campaign",
"utm_content",
"utm_medium",
"utm_source",
"utm_term",
"ref"
],
"type": "string",
"description": "Field to filter on (domain is filter-only; keyword cannot be filtered)."
}
}
},
"maxItems": 20,
"description": "Filters, all applied (AND). Example: [{\"property\":\"country_code\",\"operator\":\"is\",\"value\":\"GB\"}]."
},
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"sort_by": {
"type": "string",
"maxLength": 64,
"description": "\"<field>:asc|desc\" with a field from aggregates or field_grouping (or timestamp with date_grouping), e.g. pageviews:desc."
},
"date_from": {
"type": "string",
"maxLength": 19,
"minLength": 10,
"description": "Start, YYYY-MM-DD (start of day) or \"YYYY-MM-DD HH:MM:SS\", in the site's timezone. Default: the first recorded data."
},
"aggregates": {
"type": "array",
"items": {
"enum": [
"visits",
"uniques",
"pageviews",
"avg_duration",
"bounce_rate",
"conversions",
"unique_conversions",
"value"
],
"type": "string"
},
"maxItems": 8,
"minItems": 1,
"description": "Metrics. pageview: visits, uniques, pageviews, avg_duration, bounce_rate. event: conversions, unique_conversions, value."
},
"event_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "For entity event: the event's name, as listed by fathom_list_events."
},
"date_grouping": {
"enum": [
"hour",
"day",
"month",
"year"
],
"type": "string",
"description": "Group by time (omit for one total). hour only for ranges up to 7 days."
},
"field_grouping": {
"type": "array",
"items": {
"enum": [
"hostname",
"pathname",
"entry_page",
"exit_page",
"referrer_hostname",
"referrer_pathname",
"referrer_source",
"ai_source",
"browser",
"country_code",
"city",
"state",
"region",
"device_type",
"operating_system",
"utm_campaign",
"utm_content",
"utm_medium",
"utm_source",
"utm_term",
"keyword",
"ref"
],
"type": "string"
},
"maxItems": 6,
"minItems": 1,
"description": "Group by these fields, e.g. [pathname] or [referrer_source, utm_campaign]."
}
}
},
"annotations": {
"title": "Run a traffic or event report",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| detailed | boolean | true = also the top pages and referrers (default false: only the count). |
{
"name": "fathom_get_current_visitors",
"title": "Get current visitors",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"detailed": {
"type": "boolean",
"description": "true = also the top pages and referrers (default false: only the count)."
}
}
},
"annotations": {
"title": "Get current visitors",
"readOnlyHint": true,
"openWorldHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Site name (up to 255 characters; need not match the URL). |
| sharing | string | Dashboard sharing: none (default), private (password) or public. |
| timezone | string | Reporting timezone as a TZ database name, e.g. America/New_York, Europe/London, UTC. |
| multi_domain | boolean | true = the site may track multiple domains. |
| share_password | string | Required when sharing is private: the password for the shared dashboard. |
| multi_domain_option | string | Required when multi_domain is true: report domains combined or separate. |
{
"name": "fathom_create_site",
"title": "Create a site",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Site name (up to 255 characters; need not match the URL)."
},
"sharing": {
"enum": [
"none",
"private",
"public"
],
"type": "string",
"description": "Dashboard sharing: none (default), private (password) or public."
},
"timezone": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(\\/[A-Za-z0-9_+-]+){0,2}$",
"maxLength": 64,
"description": "Reporting timezone as a TZ database name, e.g. America/New_York, Europe/London, UTC."
},
"multi_domain": {
"type": "boolean",
"description": "true = the site may track multiple domains."
},
"share_password": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Required when sharing is private: the password for the shared dashboard."
},
"multi_domain_option": {
"enum": [
"combined",
"separate"
],
"type": "string",
"description": "Required when multi_domain is true: report domains combined or separate."
}
}
},
"annotations": {
"title": "Create a site",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| name | string | New site name (up to 255 characters). |
| sharing | string | Dashboard sharing: none, private (needs share_password) or public. |
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| timezone | string | Reporting timezone as a TZ database name, e.g. America/New_York, Europe/London, UTC. |
| multi_domain | boolean | true = the site may track multiple domains. |
| share_password | string | Required when setting sharing to private. |
| multi_domain_option | string | Required when multi_domain is true: combined or separate. |
{
"name": "fathom_update_site",
"title": "Update a site",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "New site name (up to 255 characters)."
},
"sharing": {
"enum": [
"none",
"private",
"public"
],
"type": "string",
"description": "Dashboard sharing: none, private (needs share_password) or public."
},
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"timezone": {
"type": "string",
"pattern": "^[A-Za-z][A-Za-z0-9_+-]*(\\/[A-Za-z0-9_+-]+){0,2}$",
"maxLength": 64,
"description": "Reporting timezone as a TZ database name, e.g. America/New_York, Europe/London, UTC."
},
"multi_domain": {
"type": "boolean",
"description": "true = the site may track multiple domains."
},
"share_password": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "Required when setting sharing to private."
},
"multi_domain_option": {
"enum": [
"combined",
"separate"
],
"type": "string",
"description": "Required when multi_domain is true: combined or separate."
}
}
},
"annotations": {
"title": "Update a site",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| currency * | string | dollar, pound, euro, yuan, peso, shekel, yen, won, hryvnia, franc, rupee, integer (a plain number) or none. |
| event_name * | string | The event's name exactly as tracked (up to 255 characters; fathom_list_events lists them). |
{
"name": "fathom_set_event_currency",
"title": "Set an event's currency",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"event_name",
"currency"
],
"properties": {
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"currency": {
"enum": [
"dollar",
"pound",
"euro",
"yuan",
"peso",
"shekel",
"yen",
"won",
"hryvnia",
"franc",
"rupee",
"integer",
"none"
],
"type": "string",
"description": "dollar, pound, euro, yuan, peso, shekel, yen, won, hryvnia, franc, rupee, integer (a plain number) or none."
},
"event_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The event's name exactly as tracked (up to 255 characters; fathom_list_events lists them)."
}
}
},
"annotations": {
"title": "Set an event's currency",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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=.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| event_name * | string | The event's name exactly as tracked (fathom_list_events lists them). |
{
"name": "fathom_clear_event_currency",
"title": "Clear an event's currency",
"description": "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=.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"event_name"
],
"properties": {
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"event_name": {
"type": "string",
"maxLength": 255,
"minLength": 1,
"description": "The event's name exactly as tracked (fathom_list_events lists them)."
}
}
},
"annotations": {
"title": "Clear an event's currency",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Milestone name (up to 30 characters), e.g. Redesign launch. |
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| milestone_date * | string | The milestone's date, YYYY-MM-DD. |
{
"name": "fathom_create_milestone",
"title": "Create a milestone",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"name",
"milestone_date"
],
"properties": {
"name": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Milestone name (up to 30 characters), e.g. Redesign launch."
},
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"milestone_date": {
"type": "string",
"description": "The milestone's date, YYYY-MM-DD."
}
}
},
"annotations": {
"title": "Create a milestone",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Milestone name (up to 30 characters), e.g. Redesign launch. |
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| milestone_id * | string | The milestone id (a UUID, from fathom_list_milestones). |
| milestone_date * | string | The milestone's date, YYYY-MM-DD. |
{
"name": "fathom_update_milestone",
"title": "Update a milestone",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"milestone_id",
"name",
"milestone_date"
],
"properties": {
"name": {
"type": "string",
"maxLength": 30,
"minLength": 1,
"description": "Milestone name (up to 30 characters), e.g. Redesign launch."
},
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"milestone_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The milestone id (a UUID, from fathom_list_milestones)."
},
"milestone_date": {
"type": "string",
"description": "The milestone's date, YYYY-MM-DD."
}
}
},
"annotations": {
"title": "Update a milestone",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}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}.
| Parameter | Type | Description |
|---|---|---|
| site_id * | string | The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them. |
| milestone_id * | string | The milestone id (a UUID, from fathom_list_milestones). |
{
"name": "fathom_delete_milestone",
"title": "Delete a milestone",
"description": "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}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"site_id",
"milestone_id"
],
"properties": {
"site_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The site id, the same string as in the tracking code (e.g. CDBUGS). fathom_list_sites lists them."
},
"milestone_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The milestone id (a UUID, from fathom_list_milestones)."
}
}
},
"annotations": {
"title": "Delete a milestone",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Fathom Analytics, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "How many pageviews did my site get last week?"; "How many people are on my website right now?"; "How many times was the signup event triggered this month?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Fathom Analytics data. Free plan: 50 tool calls per month. Run fathom_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run fathom_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run fathom_upgrade without a plan: it returns both plans, each with a payment link for the user to open. fathom_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.