How to Use the Fathom Analytics MCP in AutoGen

Q: How do I register Fathom Analytics tools in AutoGen?

Use mcpservertools with your server's endpoint URL to load the tool definitions. You can then pass this list directly to your AssistantAgent constructor to give them access to metrics like getvisitors.

Let AutoGen agents debate and analyze your Fathom Analytics traffic data autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Fathom Analytics MCP to AutoGen

Create your Vinkius account to connect Fathom Analytics to AutoGen and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Fathom Analytics with AutoGen

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run multi-agent debates on traffic performance

When traffic drops, you need a strategy, not just a chart. AutoGen lets you deploy a marketing agent and a product agent that debate the cause using data from `get_referrers` and `get_top_pages`. One agent might blame a drop in search traffic while the other points to product changes. They negotiate a solution by calling tools to prove their points. The marketing agent checks `list_events` to see if a campaign ended, while the product agent pulls `get_device_stats` to check for mobile bugs.

Connect the Fathom Analytics MCP Server to AutoGen

Integrating this server with your conversational workflow is straightforward. AutoGen uses MCP server tools to parse the schemas of tools like `get_current_visitors` and `get_visitors` automatically. Your agents can immediately start discussing live traffic without manual schema mapping. The adapter handles all JSON conversions behind the scenes. This ensures that your agents receive clean, typed inputs when executing metrics queries like `get_pageviews`.

Automate traffic auditing with consensus-driven agents

Set up a system where agents must agree before flagging an anomaly. An auditor agent can monitor `get_current_visitors` and alert a coordinator agent if numbers spike. Together, they decide whether to scale up servers or log a security alert. This eliminates false alarms in your operations. By requiring consensus based on tools like `get_site` and `get_visitors`, your agents only escalate real issues.

Setup guide

Set up Fathom Analytics MCP in AutoGen

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] package
Active Vinkius subscription with a valid endpoint token

1

Install AutoGen with MCP
Run pip install "autogen-ext[mcp]" autogen-agentchat. The MCP extension includes mcp_server_tools for stateless tool access.
2

Fetch tools from the MCP
Call mcp_server_tools(SseServerParams(url=...)) with your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Run your agent
Pass the tools to AssistantAgent and call agent.run(). The agent invokes Fathom Analytics tools and returns structured results.

agent.py

from autogen_ext.tools.mcp import SseServerParams, mcp_server_tools
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

tools = await mcp_server_tools(server_params)

agent = AssistantAgent(
    name="Fathom Analytics_assistant",
    model_client=OpenAIChatCompletionClient(model="gpt-4o"),
    tools=tools,
)

result = await agent.run("List recent Fathom Analytics data")
print(result.messages[-1].content)

Get your connection token →

Prerequisites

Python 3.10+ installed
autogen-ext[mcp] + autogen-agentchat
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Same packages as above. McpWorkbench is ideal when your agent needs stateful sessions across multiple tool calls.
2

Use McpWorkbench as context manager
Wrap your agent in async with McpWorkbench(...) to maintain shared state and resources. The workbench manages the full MCP session lifecycle.
3

Run with workbench
Pass workbench=workbench to your agent. State is preserved across multiple tool calls within the same session.

agent.py

from autogen_ext.tools.mcp import McpWorkbench, SseServerParams
from autogen_agentchat.agents import AssistantAgent
from autogen_ext.models.openai import OpenAIChatCompletionClient

server_params = SseServerParams(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

async with McpWorkbench(server_params) as workbench:
    agent = AssistantAgent(
        name="Fathom Analytics_assistant",
        model_client=OpenAIChatCompletionClient(model="gpt-4o"),
        workbench=workbench,
    )

    result = await agent.run("List recent Fathom Analytics data")
    print(result.messages[-1].content)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Fathom Analytics. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Fathom Analytics now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Fathom Analytics MCP in AutoGen

Use mcp_server_tools with your server's endpoint URL to load the tool definitions. You can then pass this list directly to your AssistantAgent constructor to give them access to metrics like `get_visitors`.

Yes, all agents in your conversation group can access tools like `get_referrers` if they are defined in their tool list. This allows different agents to collaborate and cross-reference traffic sources during their deliberations.

The McpToolAdapter in AutoGen automatically translates the server's JSON schemas into the format required by your agents. This means tools like `get_device_stats` work out of the box with no manual mapping.

You can use either stdio or Streamable HTTP transports depending on your hosting setup. For cloud deployments on Vinkius, the Streamable HTTP transport is the easiest way to connect your agents to `list_sites`.

Your event tracking data is secured through Vinkius's zero-trust architecture, which handles all Fathom API authentication on our backend. Your AutoGen agents only interact with tools like `get_event` inside an ephemeral, isolated MCP environment.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript