Server definition
- Hash
- sha256:244be5b8a0857c348fb9bf3efdc72f11ca52db4c0b05ce672c23e3138c4887d6
- What it is
- What a remote MCP server returned when asked what it offers: 27 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "Delete custom goal events by filter. At least one filter is required. WARNING: without a date range, matching records are deleted across the entire history.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end timestamp",
"type": "string"
},
"name": {
"description": "Delete goals matching this event name",
"type": "string"
},
"startAt": {
"description": "ISO 8601 start timestamp",
"type": "string"
},
"visitorId": {
"description": "Delete goals for this visitor",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "delete_goals",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Confirmation of the goal event deletion."
}
},
"type": "object"
}
},
{
"description": "Delete payment records by filter. At least one filter is required. WARNING: without a date range, matching records are deleted across the entire history.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end timestamp",
"type": "string"
},
"startAt": {
"description": "ISO 8601 start timestamp",
"type": "string"
},
"transactionId": {
"description": "Delete the payment with this transaction ID",
"type": "string"
},
"visitorId": {
"description": "Delete all payments for this visitor",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "delete_payments",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Confirmation of the payment record deletion."
}
},
"type": "object"
}
},
{
"description": "Generic breakdown by any dimension. Use this for dimensions that don't have a dedicated endpoint (e.g. entry_page, browser_version, os_version, utm_source, utm_medium, utm_term, utm_content, ref, source, all_params).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"dimension": {
"description": "Dimension to break down by: device, page, entry_page, exit_link, hostname, referrer, channel, campaign, goal, country, region, city, browser, browser_version, os, os_version, utm_source, utm_medium, utm_campaign, utm_term, utm_content, ref, source, all_params",
"enum": [
"device",
"page",
"entry_page",
"exit_link",
"hostname",
"referrer",
"channel",
"campaign",
"goal",
"country",
"region",
"city",
"browser",
"browser_version",
"os",
"os_version",
"utm_source",
"utm_medium",
"utm_campaign",
"utm_term",
"utm_content",
"ref",
"source",
"all_params"
],
"type": "string"
},
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"required": [
"dimension"
],
"type": "object"
},
"name": "get_breakdown",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Values of the requested dimension with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get browser distribution — Chrome, Safari, Firefox, Edge, etc.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_browsers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Browsers with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get UTM campaign performance — which campaigns drive the most traffic.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_campaigns",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "UTM campaigns with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get marketing channel breakdown — Organic Search, Paid Search, Social, Email, Direct, Referral, Affiliate, etc. GA4-aligned classification.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_channels",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Marketing channels with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get visitor breakdown by city.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_cities",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Cities with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get visitor breakdown by country.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_countries",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Countries with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get device type breakdown — desktop vs mobile vs tablet split.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_devices",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Device types (desktop, mobile, tablet) with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get goal/custom event completion stats within a date range.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_goals",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Goals with completion stats for the selected date range."
}
},
"type": "object"
}
},
{
"description": "Get traffic breakdown by hostname/domain.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_hostnames",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Hostnames with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get full detail for one AI-detected issue: every occurrence the AI flagged with timestamps, the sessions behind it, steps to replicate, comments, and any linked external ticket (Linear/Jira).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"issueId": {
"description": "Issue ID from list_issues",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"required": [
"issueId"
],
"type": "object"
},
"name": "get_issue",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "The issue with occurrences, affected sessions, steps to replicate, comments, and external ticket link if any."
}
},
"type": "object"
}
},
{
"description": "Get website configuration — domain, timezone, currency, KPI goal, and color scheme. With a workspace token, pass websiteId or domain; without one, this returns the website list.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_metadata",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Website configuration including domain, timezone, currency, KPI goal, and color scheme."
}
},
"type": "object"
}
},
{
"description": "Get operating system distribution — Mac OS, Windows, iOS, Android, Linux, etc.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_operating_systems",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Operating systems with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get aggregated site metrics: visitors, sessions, bounce rate, average session duration, revenue, revenue per visitor, and conversion rate. Supports date range and all filters. Omit dates for all-time data.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"fields": {
"description": "Comma-separated metrics to include: visitors, sessions, bounce_rate, avg_session_duration, currency, revenue, revenue_per_visitor, conversion_rate. Omit for all.",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_overview",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Aggregated metrics such as visitors, sessions, bounce rate, average session duration, revenue, revenue per visitor, and conversion rate."
}
},
"type": "object"
}
},
{
"description": "Get top pages ranked by visitor count. Shows which pages get the most traffic.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_pages",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Pages ranked by visitor count for the selected range and filters."
}
},
"type": "object"
}
},
{
"description": "Get the number of currently active visitors on the site (active within the last 5 minutes).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_realtime",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Count of visitors active on the site within the last 5 minutes."
}
},
"type": "object"
}
},
{
"description": "Get currently active visitors with geographic location data for map visualization.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_realtime_map",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Currently active visitors with their geographic locations."
}
},
"type": "object"
}
},
{
"description": "Get traffic sources — which websites and domains are sending visitors.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_referrers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Referrer domains with visitor counts for the selected range and filters."
}
},
"type": "object"
}
},
{
"description": "Get visitor breakdown by region/state.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_regions",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Regions/states with visitor counts."
}
},
"type": "object"
}
},
{
"description": "Get time series analytics data grouped by hour, day, week, or month. Returns timestamped data points with totals. Use for trend analysis and charting.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"endAt": {
"description": "ISO 8601 end date (e.g. \"2026-01-31\")",
"type": "string"
},
"fields": {
"description": "Comma-separated metrics: visitors, sessions, revenue, conversion_rate, name",
"type": "string"
},
"filter_browser": {
"description": "Filter by browser name",
"type": "string"
},
"filter_channel": {
"description": "Filter by marketing channel",
"type": "string"
},
"filter_city": {
"description": "Filter by city",
"type": "string"
},
"filter_country": {
"description": "Filter by country",
"type": "string"
},
"filter_device": {
"description": "Filter by device type: desktop, mobile, tablet",
"type": "string"
},
"filter_entry_page": {
"description": "Filter by entry/landing page",
"type": "string"
},
"filter_goal": {
"description": "Filter by goal name",
"type": "string"
},
"filter_hostname": {
"description": "Filter by hostname",
"type": "string"
},
"filter_os": {
"description": "Filter by operating system",
"type": "string"
},
"filter_page": {
"description": "Filter by page path",
"type": "string"
},
"filter_ref": {
"description": "Filter by ref URL parameter",
"type": "string"
},
"filter_referrer": {
"description": "Filter by referrer domain",
"type": "string"
},
"filter_region": {
"description": "Filter by region",
"type": "string"
},
"filter_source": {
"description": "Filter by source URL parameter",
"type": "string"
},
"filter_utm_campaign": {
"description": "Filter by UTM campaign",
"type": "string"
},
"filter_utm_content": {
"description": "Filter by UTM content",
"type": "string"
},
"filter_utm_medium": {
"description": "Filter by UTM medium",
"type": "string"
},
"filter_utm_source": {
"description": "Filter by UTM source",
"type": "string"
},
"filter_utm_term": {
"description": "Filter by UTM term",
"type": "string"
},
"filter_via": {
"description": "Filter by via URL parameter",
"type": "string"
},
"interval": {
"description": "Aggregation interval: hour, day, week, month (default: day)",
"enum": [
"hour",
"day",
"week",
"month"
],
"type": "string"
},
"limit": {
"description": "Max results (1-1000, default: 100)",
"type": "number"
},
"offset": {
"description": "Pagination offset (default: 0)",
"type": "number"
},
"startAt": {
"description": "ISO 8601 start date (e.g. \"2026-01-01\")",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. \"America/New_York\"). Falls back to site default.",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "get_timeseries",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Timestamped data points for the chosen interval with the requested metrics and totals."
}
},
"type": "object"
}
},
{
"description": "Get full visitor profile — identity (geo, device, browser, OS), traffic source, activity (visits, pages, goals), revenue (total, customer flag, time to first conversion), identified profile (userId, name, email), and a merged activity timeline. The visitor ID comes from the _fs_vid browser cookie.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"visitorId": {
"description": "Visitor ID (from _fs_vid cookie)",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"required": [
"visitorId"
],
"type": "object"
},
"name": "get_visitor",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Visitor profile with identity, traffic source, activity, revenue, identified profile fields, and an activity timeline."
}
},
"type": "object"
}
},
{
"description": "List issues the AI found while analyzing session recordings — bugs, broken flows, and UX problems, deduplicated across sessions and ranked by severity. Each issue includes how many sessions hit it, first/last seen times, and steps to replicate. Also returns open/in-progress/resolved counts.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"limit": {
"description": "Max results",
"type": "number"
},
"offset": {
"description": "Pagination offset",
"type": "number"
},
"search": {
"description": "Match against issue title and description",
"type": "string"
},
"severity": {
"description": "Filter by severity",
"enum": [
"low",
"medium",
"high",
"critical"
],
"type": "string"
},
"sort": {
"description": "Order by severity (default) or recency (last seen)",
"enum": [
"severity",
"recency"
],
"type": "string"
},
"status": {
"description": "Filter by status. Default excludes suspended issues",
"enum": [
"open",
"in_progress",
"resolved",
"suspended"
],
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"type": "object"
},
"name": "list_issues",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Issues with severity, status, sessions affected, first/last seen, plus open/in-progress/resolved counts and pagination."
}
},
"type": "object"
}
},
{
"description": "List websites accessible by the current API token. Workspace tokens return every website in the workspace; website keys return only their website. Call this first when using a workspace token.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_websites",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "List of websites the token can access, with identifiers and domains for use in other tools."
}
},
"type": "object"
}
},
{
"description": "Track a custom goal/event for a visitor. The visitor must have at least one recorded pageview. Goal names must be lowercase with only letters, numbers, underscores, and hyphens (max 64 chars).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"metadata": {
"additionalProperties": {
"type": "string"
},
"description": "Up to 10 custom key-value pairs. Keys: lowercase, max 64 chars. Values: max 255 chars.",
"type": "object"
},
"name": {
"description": "Goal name — lowercase letters, numbers, underscores, hyphens only (max 64 chars). E.g. \"newsletter_signup\", \"add-to-cart\"",
"type": "string"
},
"visitorUid": {
"description": "Visitor UID from the _fs_vid browser cookie",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "track_goal",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Confirmation of the recorded goal event."
}
},
"type": "object"
}
},
{
"description": "Record a payment for revenue attribution. If you use Stripe, LemonSqueezy, or Polar, payments are tracked automatically — only use this for other providers.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"amount": {
"description": "Payment amount (e.g. 29.99)",
"type": "number"
},
"currency": {
"description": "Currency code (e.g. \"USD\", \"EUR\")",
"type": "string"
},
"customerId": {
"description": "Customer ID from payment provider",
"type": "string"
},
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"email": {
"description": "Customer email",
"type": "string"
},
"isRefund": {
"description": "True for refunded payments",
"type": "boolean"
},
"isRenewal": {
"description": "True for recurring/renewal payments",
"type": "boolean"
},
"name": {
"description": "Customer name",
"type": "string"
},
"sessionUid": {
"description": "Session ID for the current visitor session",
"type": "string"
},
"transactionId": {
"description": "Unique transaction ID from your payment provider",
"type": "string"
},
"visitorUid": {
"description": "Visitor UID from _fs_vid cookie — strongly recommended for accurate revenue attribution",
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"required": [
"amount",
"currency",
"transactionId"
],
"type": "object"
},
"name": "track_payment",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "Confirmation of the recorded payment."
}
},
"type": "object"
}
},
{
"description": "Update an issue's status: open, in_progress, resolved, or suspended. Suspended issues disappear from the default list. Reversible — set any status back at any time.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Website domain to query. Required when using a workspace token unless websiteId is provided.",
"type": "string"
},
"issueId": {
"description": "Issue ID from list_issues",
"type": "string"
},
"status": {
"description": "New status",
"enum": [
"open",
"in_progress",
"resolved",
"suspended"
],
"type": "string"
},
"websiteId": {
"description": "Website ID to query. Required when using a workspace token unless domain is provided.",
"type": "string"
}
},
"required": [
"issueId",
"status"
],
"type": "object"
},
"name": "update_issue_status",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"result": {
"description": "The updated issue with its new status."
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:244be5b8a0857c348fb9bf3efdc72f11ca52db4c0b05ce672c23e3138c4887d6 | sha256sum