Skip to main content
Glama

Simple Analytics MCP by usefulapi

Server Details

Read Simple Analytics stats: pageviews, visitors, pages, referrers, events and data exports.

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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 tools
simpleanalytics_export_datapointsExport raw data points
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
endYesEnd date, inclusive.
typeNoPage views (default) or events.
startYesStart date (see description).
fieldsNoFields 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.
hostnameYesWebsite hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites).
max_rowsNoMaximum rows returned (default 100).
timezoneNoIANA time zone, e.g. Europe/Amsterdam. Default: the website setting.
include_robotsNoInclude robot/crawler traffic (default false).
simpleanalytics_get_breakdownGet top pages, referrers, countries or devices
Read-only
Inspect

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=.

ParametersJSON Schema
NameRequiredDescriptionDefault
endNoEnd date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today.
pageNoOnly this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*).
limitNoMaximum number of values (default 20, max 1000).
pagesNoOnly these page paths, comma separated (/contact,/product/*).
startNoStart date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago.
countryNoOnly this country, 2-letter code (NL).
os_nameNoOnly this OS name (iOS).
hostnameYesWebsite hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites).
metadataNoExact metadata filters as {key: value}; all must match.
referrerNoOnly this referrer (normalized, e.g. google.com).
timezoneNoIANA time zone, e.g. Europe/Amsterdam. Default: the website setting.
utm_termNoOnly this UTM term.
dimensionYesWhat to break the traffic down by.
utm_mediumNoOnly this UTM medium.
utm_sourceNoOnly this UTM source.
device_typeNoOnly this device type.
utm_contentNoOnly this UTM content.
browser_nameNoOnly this browser name (Chrome).
utm_campaignNoOnly this UTM campaign.
simpleanalytics_get_eventsGet event counts
Read-only
Inspect

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=...

ParametersJSON Schema
NameRequiredDescriptionDefault
endNoEnd date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today.
pageNoOnly this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*).
namesNoEvent names; default all events.
pagesNoOnly these page paths, comma separated (/contact,/product/*).
startNoStart date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago.
countryNoOnly this country, 2-letter code (NL).
os_nameNoOnly this OS name (iOS).
hostnameYesWebsite hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites).
metadataNoExact metadata filters as {key: value}; all must match.
referrerNoOnly this referrer (normalized, e.g. google.com).
timezoneNoIANA time zone, e.g. Europe/Amsterdam. Default: the website setting.
utm_termNoOnly this UTM term.
utm_mediumNoOnly this UTM medium.
utm_sourceNoOnly this UTM source.
device_typeNoOnly this device type.
utm_contentNoOnly this UTM content.
browser_nameNoOnly this browser name (Chrome).
utm_campaignNoOnly this UTM campaign.
simpleanalytics_get_statsGet traffic summary
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
endNoEnd date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today.
pageNoOnly this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*).
pagesNoOnly these page paths, comma separated (/contact,/product/*).
startNoStart date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago.
countryNoOnly this country, 2-letter code (NL).
os_nameNoOnly this OS name (iOS).
hostnameYesWebsite hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites).
metadataNoExact metadata filters as {key: value}; all must match.
referrerNoOnly this referrer (normalized, e.g. google.com).
timezoneNoIANA time zone, e.g. Europe/Amsterdam. Default: the website setting.
utm_termNoOnly this UTM term.
utm_mediumNoOnly this UTM medium.
utm_sourceNoOnly this UTM source.
device_typeNoOnly this device type.
utm_contentNoOnly this UTM content.
browser_nameNoOnly this browser name (Chrome).
utm_campaignNoOnly this UTM campaign.
simpleanalytics_get_timeseriesGet traffic over time
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
endNoEnd date (inclusive): YYYY-MM-DD, today, yesterday or today-1d. Default: today.
pageNoOnly this page path, e.g. /pricing. A trailing * matches a prefix (/blog/*).
pagesNoOnly these page paths, comma separated (/contact,/product/*).
startNoStart date: YYYY-MM-DD, today, yesterday or today-30d. Default: 1 month ago.
countryNoOnly this country, 2-letter code (NL).
os_nameNoOnly this OS name (iOS).
hostnameYesWebsite hostname as shown in Simple Analytics, e.g. example.com (from simpleanalytics_list_websites).
intervalNoBucket size (default day).
metadataNoExact metadata filters as {key: value}; all must match.
referrerNoOnly this referrer (normalized, e.g. google.com).
timezoneNoIANA time zone, e.g. Europe/Amsterdam. Default: the website setting.
utm_termNoOnly this UTM term.
utm_mediumNoOnly this UTM medium.
utm_sourceNoOnly this UTM source.
device_typeNoOnly this device type.
utm_contentNoOnly this UTM content.
browser_nameNoOnly this browser name (Chrome).
utm_campaignNoOnly this UTM campaign.
simpleanalytics_list_websitesList websites
Read-only
Inspect

List the websites of the Simple Analytics account (hostnames to use in the other tools). Good first call. Admin API: GET /api/websites.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updates
    • First observedsimpleanalytics_export_datapoints
    • First observedsimpleanalytics_get_breakdown
    • First observedsimpleanalytics_get_events
    • First observedsimpleanalytics_get_stats
    • First observedsimpleanalytics_get_timeseries
    • First observedsimpleanalytics_list_websites

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Read website acquisition, content, conversion, and engagement analytics from Matomo's Reporting API.
    248 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Exposes Umami analytics (Cloud or self-hosted) as read-only tools for querying website stats, pageviews, metrics, and active visitors.
    74 npm
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables querying privacy-focused website analytics from Plausible's read-only Stats API v2, with tools for overview, timeseries, breakdown, and goal performance metrics.
    73 npm
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Privacy-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.
    25
    30 npm
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.