# Fathom Analytics MCP > Fathom Analytics MCP connects your AI client directly to your privacy-first website data. Instantly monitor live visitor counts, aggregate pageviews, and analyze traffic sources via natural conversation. Stop exporting CSVs; get deep site intelligence without compromising user privacy. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** privacy-first, website-analytics, cookieless-tracking, visitor-insights, web-traffic, data-privacy ## Description This connection lets you talk to your website analytics the way you'd talk to a teammate. You get full control of your site’s performance metrics—visitor counts, top pages, average session duration, and more—all through natural conversation. There’s no need for manual dashboard exports or wading through complex reports. Instead, you simply ask questions like, “How did our traffic perform last week?” and your agent pulls the answer instantly. This is crucial for teams that handle sensitive data; since Fathom focuses on privacy-first tracking, you never have to worry about accessing personally identifiable information (PII). Because this MCP lives within the Vinkius catalog, you can connect it once from any compatible client—Claude, Cursor, or Windsurf—and access all your site intelligence in one place. ## Tools ### get_account_info Retrieves general information about your Fathom Analytics account settings. ### get_current_visitors Pulls the exact number of people actively visiting a site right now. ### get_device_stats Gathers data showing how many visitors are using different types of devices (mobile, desktop, etc.). ### get_event Retrieves specific details about a custom event that happened on the site. ### get_me Verifies your personal API token profile and account usage limits for you. ### get_top_pages Lists the most viewed pages on your site over a given period. ### get_pageviews Aggregates total pageview statistics for any specified time range. ### get_referrers Lists the top websites that are sending traffic to your site. ### get_site Fetches general metadata and details for a specific website you manage. ### get_visitors Provides aggregated data on visitor counts, including unique users, over time. ### list_events Generates a list of all custom events that have been tracked for a site. ### list_sites Shows all the websites you manage within your Fathom Analytics account. ## Prompt Examples **Prompt:** ``` How many visitors are on my site right now? ``` **Response:** ``` Checking live visitors... You currently have 12 active visitors on 'mysite.com'. Would you like to see the top referrers for this session? ``` **Prompt:** ``` Show me pageview stats for last week. ``` **Response:** ``` Aggregating data for last week... Your site received 5,200 pageviews and 1,800 unique visitors. The average session duration was 2 minutes and 15 seconds. ``` **Prompt:** ``` List my top referral sources. ``` **Response:** ``` Fetching referrers... Your top traffic sources are Google (40%), Twitter (25%), and Direct (15%). Shall I show you the bounce rate for each of these sources? ``` ## Capabilities ### Track live visitor activity Get an immediate count of how many people are currently on your website. ### Aggregate historical pageviews and unique users Retrieve detailed metrics for specific time frames, including total pageviews, unique visitors, and average session duration. ### Analyze traffic sources and behavior Identify where your site's traffic comes from by listing top referring sites or search terms. You can also see which pages perform the best. ### Review device-specific usage stats Understand how visitors are accessing your site, whether they’re using mobile phones, desktop computers, or tablets. ### List and retrieve custom events Track specific actions users take on your site by listing and getting details for defined custom events. ## Use Cases ### Investigating a sudden traffic drop A business owner notices site traffic dipping and asks their agent to run `get_visitors` for the last 24 hours. The agent responds by pointing out that the unique visitor count dropped sharply, immediately directing them to check campaign performance. ### Comparing device performance A marketing analyst suspects mobile users are having a bad time. They use `get_device_stats` and discover that bounce rates are high only on mobile devices, telling the development team exactly where to focus their efforts. ### Analyzing conversion paths A growth marketer wants to know which pages lead to conversions. They ask the agent for `get_top_pages` and then follow up with specific event data using `list_events`, mapping out the most valuable user journeys. ### Auditing site coverage A new team member needs to know which sites are under management. They run `list_sites` and get a full list of properties, ensuring no critical web presence is being neglected or forgotten. ## Benefits - Stop relying on static dashboards. With this MCP, you can ask your agent for live visitor counts using `get_current_visitors` and get the answer immediately. - Cut down reporting time by automating data collection. You don't need to manually export metrics; just ask for pageview aggregations with `get_pageviews`. - Understand where your traffic comes from instantly. Running `get_referrers` gives you a clear picture of your top sources, letting you adjust campaigns fast. - Optimize content strategy easily. Use the agent to check both `get_top_pages` and `get_device_stats` simultaneously to see what content works best for mobile users. - Maintain total data privacy. Since Fathom is designed around user privacy, all your high-level analytics are accessible without touching PII. ## How It Works The bottom line is you get actionable website insights without ever leaving your chat window or running a manual report. 1. Subscribe to this MCP and provide your Fathom Analytics API Token in the settings. 2. Connect your preferred AI client (like Cursor or Claude) to Vinkius, which gives your agent access to the site data. 3. Ask a natural language question, such as, 'What were our top referrers last month?' The agent processes the request and returns the specific metrics. ## Frequently Asked Questions **How do I use Fathom Analytics MCP to see live visitors?** Use the `get_current_visitors` tool. You simply ask your agent how many people are on site now, and it pulls the real-time count for you. **Can I use Fathom Analytics MCP to see historical pageview stats?** Yes, you can. The `get_pageviews` tool lets you aggregate total pageviews across specific time frames so you don't have to check date ranges manually. **What is the best way to find out where my traffic comes from using Fathom Analytics MCP?** Run `get_referrers`. This tool lists the top websites that are sending you traffic, helping you quickly identify strong partners or campaigns. **Does Fathom Analytics MCP require me to connect multiple accounts?** No. Once your API token is set up and linked through Vinkius, the agent can access all sites listed via `list_sites` from that single connection. **How do I check device performance with Fathom Analytics MCP?** You use the `get_device_stats` tool. This gives you a clear breakdown of whether your users are coming from mobile, desktop, or other devices.