Simple Analytics MCP by usefulapi
Server Details
Read Simple Analytics stats: pageviews, visitors, pages, referrers, events and data exports.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
6 toolssimpleanalytics_export_datapointsExport raw data pointsRead-onlyInspect
Raw, unsampled page views or events of one website for a date range, as rows with only the fields asked for. The reply is capped at max_rows (default 100, max 1000) rows and 2 MB; "truncated" says more exist, so narrow the range. Rows are cut to about 40 000 characters of JSON. Dates: YYYY-MM-DD, or YYYY-MM-DDTHH for one hour (start and end the same day). Robots are left out unless asked. Needs the user id too. Export API: GET /api/export/datapoints.
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | End date, inclusive. | |
| type | No | Page views (default) or events. | |
| start | Yes | Start date (see description). | |
| fields | No | Fields to export (default added_iso, path, country_code, device_type, document_referrer). All: added_date, added_iso, added_unix, browser_name, browser_version, country_code, datapoint, device_type, document_referrer, duration_seconds, hostname, hostname_original, is_robot, is_unique, lang_language, lang_region, os_name, os_version, path, path_and_query, query, referrer_hostname, referrer_path, screen_height, screen_width, scrolled_percentage, session_id, user_agent, utm_campaign, utm_content, utm_medium, utm_source, utm_term, uuid, viewport_height, viewport_width, metadata.<key>_<text|int|bool|date>. datapoint is for events only; duration_seconds, is_unique and scrolled_percentage for pageviews only. | |
| hostname | Yes | Website hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites). | |
| max_rows | No | Maximum rows returned (default 100). | |
| timezone | No | IANA time zone, e.g. Europe/Amsterdam. Default: the website setting. | |
| include_robots | No | Include robot/crawler traffic (default false). |
simpleanalytics_get_breakdownGet top pages, referrers, countries or devicesRead-onlyInspect
Top values of one dimension for one website and date range, each with pageviews and visitors: pages, countries, referrers, UTM sources/mediums/campaigns/contents/terms, browsers, operating systems or device types. Optional filters as in simpleanalytics_get_stats. Stats API: GET /.json?fields=.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today. | |
| page | No | Only this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*). | |
| limit | No | Maximum number of values (default 20, max 1000). | |
| pages | No | Only these page paths, comma separated (/contact,/product/*). | |
| start | No | Start date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago. | |
| country | No | Only this country, 2-letter code (NL). | |
| os_name | No | Only this OS name (iOS). | |
| hostname | Yes | Website hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites). | |
| metadata | No | Exact metadata filters as {key: value}; all must match. | |
| referrer | No | Only this referrer (normalized, e.g. google.com). | |
| timezone | No | IANA time zone, e.g. Europe/Amsterdam. Default: the website setting. | |
| utm_term | No | Only this UTM term. | |
| dimension | Yes | What to break the traffic down by. | |
| utm_medium | No | Only this UTM medium. | |
| utm_source | No | Only this UTM source. | |
| device_type | No | Only this device type. | |
| utm_content | No | Only this UTM content. | |
| browser_name | No | Only this browser name (Chrome). | |
| utm_campaign | No | Only this UTM campaign. |
simpleanalytics_get_eventsGet event countsRead-onlyInspect
How often custom events happened on one website in a date range. Pass event names, or leave names out for all events (up to 1000). Stats API: GET /.json?events=...
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today. | |
| page | No | Only this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*). | |
| names | No | Event names; default all events. | |
| pages | No | Only these page paths, comma separated (/contact,/product/*). | |
| start | No | Start date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago. | |
| country | No | Only this country, 2-letter code (NL). | |
| os_name | No | Only this OS name (iOS). | |
| hostname | Yes | Website hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites). | |
| metadata | No | Exact metadata filters as {key: value}; all must match. | |
| referrer | No | Only this referrer (normalized, e.g. google.com). | |
| timezone | No | IANA time zone, e.g. Europe/Amsterdam. Default: the website setting. | |
| utm_term | No | Only this UTM term. | |
| utm_medium | No | Only this UTM medium. | |
| utm_source | No | Only this UTM source. | |
| device_type | No | Only this device type. | |
| utm_content | No | Only this UTM content. | |
| browser_name | No | Only this browser name (Chrome). | |
| utm_campaign | No | Only this UTM campaign. |
simpleanalytics_get_statsGet traffic summaryRead-onlyInspect
Aggregated traffic for one website and date range: total pageviews, unique visitors and the median seconds on page. Optional filters narrow it to a page, country, referrer, UTM value, browser, OS, device or metadata value. Stats API: GET /.json.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today. | |
| page | No | Only this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*). | |
| pages | No | Only these page paths, comma separated (/contact,/product/*). | |
| start | No | Start date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago. | |
| country | No | Only this country, 2-letter code (NL). | |
| os_name | No | Only this OS name (iOS). | |
| hostname | Yes | Website hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites). | |
| metadata | No | Exact metadata filters as {key: value}; all must match. | |
| referrer | No | Only this referrer (normalized, e.g. google.com). | |
| timezone | No | IANA time zone, e.g. Europe/Amsterdam. Default: the website setting. | |
| utm_term | No | Only this UTM term. | |
| utm_medium | No | Only this UTM medium. | |
| utm_source | No | Only this UTM source. | |
| device_type | No | Only this device type. | |
| utm_content | No | Only this UTM content. | |
| browser_name | No | Only this browser name (Chrome). | |
| utm_campaign | No | Only this UTM campaign. |
simpleanalytics_get_timeseriesGet traffic over timeRead-onlyInspect
Pageviews and visitors per hour, day, week, month or year for one website and date range (time series for charts and trends). Optional filters as in simpleanalytics_get_stats. Stats API: GET /.json?fields=histogram.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today. | |
| page | No | Only this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*). | |
| pages | No | Only these page paths, comma separated (/contact,/product/*). | |
| start | No | Start date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago. | |
| country | No | Only this country, 2-letter code (NL). | |
| os_name | No | Only this OS name (iOS). | |
| hostname | Yes | Website hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites). | |
| interval | No | Bucket size (default day). | |
| metadata | No | Exact metadata filters as {key: value}; all must match. | |
| referrer | No | Only this referrer (normalized, e.g. google.com). | |
| timezone | No | IANA time zone, e.g. Europe/Amsterdam. Default: the website setting. | |
| utm_term | No | Only this UTM term. | |
| utm_medium | No | Only this UTM medium. | |
| utm_source | No | Only this UTM source. | |
| device_type | No | Only this device type. | |
| utm_content | No | Only this UTM content. | |
| browser_name | No | Only this browser name (Chrome). | |
| utm_campaign | No | Only this UTM campaign. |
simpleanalytics_list_websitesList websitesRead-onlyInspect
List the websites of the Simple Analytics account (hostnames to use in the other tools). Good first call. Admin API: GET /api/websites.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
6 tool updates
- First observed
simpleanalytics_export_datapoints - First observed
simpleanalytics_get_breakdown - First observed
simpleanalytics_get_events - First observed
simpleanalytics_get_stats - First observed
simpleanalytics_get_timeseries - First observed
simpleanalytics_list_websites
Related MCP Connectors
Read Pirsch web analytics: visitors, pages, referrers, UTM, events, funnels and sessions.
271Query site stats, realtime visitors, breakdowns and goals from Plausible Analytics.
Read-only access to your Nexly web analytics: traffic, pages, acquisition, events, and reports.
Read-only website analytics, AI referrals, crawlers, goals, revenue, and funnels.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceRead website acquisition, content, conversion, and engagement analytics from Matomo's Reporting API.248 npmMIT
- AlicenseNot gradedqualityDmaintenanceExposes Umami analytics (Cloud or self-hosted) as read-only tools for querying website stats, pageviews, metrics, and active visitors.74 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables querying privacy-focused website analytics from Plausible's read-only Stats API v2, with tools for overview, timeseries, breakdown, and goal performance metrics.73 npmMIT
- AlicenseAqualityAmaintenancePrivacy-first, cookieless web analytics hosted in the EU. Ask about visitors, pages, traffic sources, countries, goals, funnels and live traffic for your sites, and set up sites, goals and funnels; 25 tools, forwarded to the hosted Statable endpoint with your API key.2530 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.