KosmoKrator

analytics

Fathom Analytics MCP, CLI, and Lua Integration for AI Agents

Fathom Analytics integration docs for AI agents: MCP gateway setup, Fathom Analytics CLI commands, Lua API reference, credentials, and function schemas.

Fathom Analytics for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Fathom Analytics CLIHeadless setup, JSON output, direct function calls. Fathom Analytics MCPExpose selected tools to local MCP clients. Fathom Analytics LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug
fathom
route_slug
fathom
package
fathom
auth_strategy
bearer_token
cli_setup_supported
true
cli_runtime_supported
true
mcp_gateway_supported
true
lua_supported
true

Function Catalog

FunctionTypeParametersDescription
fathom.fathom_get_account Read read 0 Get the authenticated Fathom account profile from the documented /account endpoint.
fathom.fathom_get_current_user Read read 0 Get the authenticated Fathom account profile. This calls the documented /account endpoint.
fathom.fathom_list_sites Read read 3 List all websites tracked in Fathom Analytics. Returns site IDs, names, and domains you can query for analytics data.
fathom.fathom_get_site Read read 1 Get details for a specific Fathom Analytics site by ID. Returns site name, domain, tracking code, and other configuration.
fathom.fathom_create_site Write write 3 Create a new Fathom site with a name and optional sharing settings.
fathom.fathom_update_site Write write 4 Update a Fathom site name or sharing settings.
fathom.fathom_wipe_site Write write 1 Wipe all pageviews and event completions from a Fathom site. This is destructive.
fathom.fathom_delete_site Write write 1 Delete a Fathom site. This is destructive and cannot be undone.
fathom.fathom_list_events Read read 4 List custom events tracked in Fathom Analytics for a site. Returns event names, event IDs, and configuration details.
fathom.fathom_get_event Read read 2 Get one Fathom event by site ID and event ID.
fathom.fathom_create_event Write write 2 Create a Fathom event for a site.
fathom.fathom_update_event Write write 3 Update a Fathom event name.
fathom.fathom_wipe_event Write write 2 Wipe all completion data belonging to a Fathom event. This is destructive.
fathom.fathom_delete_event Write write 2 Delete a Fathom event. This is destructive and cannot be undone.
fathom.fathom_list_milestones Read read 4 List milestones for a Fathom site with cursor pagination.
fathom.fathom_get_milestone Read read 2 Get one milestone by site ID and milestone ID.
fathom.fathom_create_milestone Write write 3 Create a milestone for a Fathom site.
fathom.fathom_update_milestone Write write 4 Update a Fathom milestone name or date.
fathom.fathom_delete_milestone Write write 2 Delete a Fathom milestone. This is destructive and cannot be undone.
fathom.fathom_get_aggregate Read read 10 Get aggregated analytics data from Fathom. Supports pageviews, visits, uniques, bounce rate, and more. Can group results by page, country, browser, device type, etc.
fathom.fathom_get_current_visitors Read read 2 Get the current visitor count for a Fathom site, optionally with top pages and referrers.