Swetrix (BYOK) — connector documentation
- MCP endpoint:
https://byok-swetrix.connectorbay.com/mcp - REST API:
POST https://byok-swetrix.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec athttps://byok-swetrix.connectorbay.com/openapi.json - Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
- Authentication: your own Swetrix Swetrix API key, sent in the
X-Upstream-Keyheader of every request (never stored, logged or cached) - Health:
https://byok-swetrix.connectorbay.com/health· Tool schemas:https://byok-swetrix.connectorbay.com/tools.json - Publisher: Unify Dynamics LLC · connectorbay.com/byok-swetrix · agent@connectorbay.com
What Swetrix (BYOK) is for
Swetrix (BYOK) lets an AI assistant read your own Swetrix data through the Swetrix API with a key you supply (Swetrix API key). Read-only: 11 tools (list_projects, traffic_summary, traffic_timeseries, traffic_breakdown, list_custom_events, custom_events_timeseries, performance_summary, performance_breakdown, list_error_groups, list_sessions, live_visitors). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.swetrix.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Swetrix. Swetrix and its logos are trademarks of their owners and are used only to say which service the connector works with.
Ask your assistant things like:
- "Which Swetrix projects do I have?"
- "How did my website traffic change compared with the previous 7 days?"
- "How many visitors per day did my site get this month?"
- "Which pages got the most visitors last month?"
- "Which custom events fired most often this week and how many times?"
- "How many signups and purchases happened each day this week?"
What it does
list_projects: List your Swetrix projects with id, name, and whether each is collecting data and has a public dashboard.traffic_summary: Visitors, pageviews, users, bounce rate and average session duration for the period, the previous period of equal length and the change.traffic_timeseries: Traffic metrics per time bucket as rows with ISO timestamps (visitors and pageviews by default).traffic_breakdown: Traffic metrics grouped by one dimension (country, page, browser, referrer, UTM fields and more), sortable and paginated.list_custom_events: Counts of each custom event name in the period, paginated.custom_events_timeseries: Occurrences of named custom events per time bucket.performance_summary: Average frontend, network and backend load timings in seconds for the period, the previous period and the change.performance_breakdown: Page load timings in seconds grouped by one dimension such as country, browser or page.list_error_groups: List grouped JavaScript errors with name, message, file, occurrence count, affected users and sessions, and status.list_sessions: List recent visitor sessions with country, browser, OS, pageviews, start, last activity and duration. Paginated.live_visitors: Visitors active on the site in the last 5 minutes with device, browser, OS and country.
BYOK key
You bring your own Swetrix Swetrix API key (https://swetrix.com/docs/statistics-api-v2). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.swetrix.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.
Data sources
- https://swetrix.com/docs/statistics-api-v2 (the API this connector calls, with a BYOK key)
Live from the Swetrix API (api.swetrix.com) with a BYOK key; documentation: https://swetrix.com/docs/statistics-api-v2. Endpoints checked against that documentation on 2026-10-16.
What it is not
Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Swetrix. Swetrix and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Swetrix account.
Built for: Worldwide. Languages: English.