{"id":26362283,"url":"https://github.com/mackenly/mcp-fathom-analytics","last_synced_at":"2025-04-10T20:44:21.569Z","repository":{"id":281516850,"uuid":"944742244","full_name":"mackenly/mcp-fathom-analytics","owner":"mackenly","description":"MCP server for Fathom Analytics","archived":false,"fork":false,"pushed_at":"2025-03-12T15:32:22.000Z","size":28,"stargazers_count":1,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-05T11:55:44.473Z","etag":null,"topics":["fathom-analytics","mcp","mcp-server"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/mcp-fathom-analytics","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mackenly.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-07T22:12:27.000Z","updated_at":"2025-03-12T15:32:26.000Z","dependencies_parsed_at":"2025-03-09T16:48:31.289Z","dependency_job_id":null,"html_url":"https://github.com/mackenly/mcp-fathom-analytics","commit_stats":null,"previous_names":["mackenly/mcp-fathom-analytics"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mackenly%2Fmcp-fathom-analytics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mackenly%2Fmcp-fathom-analytics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mackenly%2Fmcp-fathom-analytics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mackenly%2Fmcp-fathom-analytics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mackenly","download_url":"https://codeload.github.com/mackenly/mcp-fathom-analytics/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248294414,"owners_count":21079867,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fathom-analytics","mcp","mcp-server"],"created_at":"2025-03-16T18:01:31.802Z","updated_at":"2025-04-10T20:44:21.552Z","avatar_url":"https://github.com/mackenly.png","language":"TypeScript","funding_links":[],"categories":["🎯 \u003ca name=\"marketing\"\u003e\u003c/a\u003eMarketing","Community Servers","📦 Other","Research \u0026 Data","Cloud Services","Uncategorized","Data \u0026 Analytics","Table of Contents"],"sub_categories":["How to Submit","Other Tools and Integrations"],"readme":"# MCP Fathom Analytics\n\nAn unofficial Model Context Protocol ([MCP](https://modelcontextprotocol.io/introduction)) server for accessing [Fathom Analytics](https://usefathom.com/) data through an AI assistant. This implementation uses the [@mackenly/fathom-api](https://github.com/mackenly/fathom-api) unofficial SDK to interact with the Fathom Analytics API. Not affiliated, endorsed, or supported by Fathom Analytics. Published to [npm as an npx script](https://www.npmjs.com/package/mcp-fathom-analytics).\n\n\u003ca href=\"https://glama.ai/mcp/servers/56cxbakbc4\"\u003e\n  \u003cimg width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/56cxbakbc4/badge\" alt=\"Fathom Analytics MCP server\" /\u003e\n\u003c/a\u003e\n\n## Features\n\nThe MCP server provides the following Fathom Analytics tools:\n\n### Account Information\n- `get-account`: Retrieve details about your Fathom Analytics account\n\n### Sites Management\n- `list-sites`: List all your Fathom Analytics sites\n\n### Events\n- `list-events`: List events for a specific site\n\n### Analytics\n- `get-aggregation`: Generate aggregated analytics reports with flexible filtering and grouping options\n\n### Visitor Tracking\n- `get-current-visitors`: Get real-time data about current site visitors\n\n## Usage\nIf you're using Claude Desktop, you can add the MCP server using the json config ([more info](https://modelcontextprotocol.io/quickstart/user)). Here's an example:\n```json\n{\n    \"mcpServers\": {\n        \"fathom-analytics\": {\n            \"command\": \"npx\",\n            \"args\": [\n                \"-y\",\n                \"mcp-fathom-analytics\"\n            ],\n            \"env\": {\n                \"FATHOM_API_KEY\": \"your_api_key_here\"\n            }\n        }\n    }\n}\n```\n\nYou can find more information about other MCP Clients here: [Model Context Protocol Example Clients](https://modelcontextprotocol.io/clients)\n\n## API Structure\n\nThe MCP server uses the [@mackenly/fathom-api](https://github.com/mackenly/fathom-api) SDK to interface with the Fathom Analytics API endpoints:\n\n1. **Account API**: `https://api.usefathom.com/v1/account`\n2. **Sites API**: `https://api.usefathom.com/v1/sites`\n3. **Events API**: `https://api.usefathom.com/v1/sites/SITE_ID/events`\n4. **Aggregation API**: `https://api.usefathom.com/v1/aggregations`\n5. **Current Visitors API**: `https://api.usefathom.com/v1/current_visitors`\n\n## Aggregation Examples\n\nThe aggregation tool is highly flexible. Here are some example use cases:\n\n1. **Daily pageview statistics for the last 30 days**:\n```json\n{\n  \"entity\": \"pageview\",\n  \"entity_id\": \"SITE_ID\",\n  \"aggregates\": \"pageviews,uniques,visits\",\n  \"date_grouping\": \"day\",\n  \"date_from\": \"2023-08-01 00:00:00\"\n}\n```\n\n2. **Performance of individual pages**:\n```json\n{\n  \"entity\": \"pageview\",\n  \"entity_id\": \"SITE_ID\",\n  \"aggregates\": \"pageviews,uniques,avg_duration\",\n  \"field_grouping\": \"pathname\",\n  \"sort_by\": \"pageviews:desc\",\n  \"limit\": 10\n}\n```\n\n3. **Traffic from specific countries**:\n```json\n{\n  \"entity\": \"pageview\",\n  \"entity_id\": \"SITE_ID\",\n  \"aggregates\": \"visits\",\n  \"field_grouping\": \"country_code\",\n  \"sort_by\": \"visits:desc\"\n}\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmackenly%2Fmcp-fathom-analytics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmackenly%2Fmcp-fathom-analytics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmackenly%2Fmcp-fathom-analytics/lists"}