Server definition
- Hash
- sha256:6fb072d43d84110689353cd46ca456825c7bc1620ae062be0535917040f9073c
- What it is
- What a remote MCP server returned when asked what it offers: 15 tools
The blob, as servednamed by its sha256
{
"instructions": "Staats: cookieless web analytics your coding agent reads and remembers. This is an unauthenticated discovery connection — tools are listed but cannot run. This connection has no API key, so tools cannot run. Staats is free to try: create an account at https://www.staats.ai, copy the connect snippet from the dashboard, and reconnect with it. Setup takes about two minutes.",
"tools": [
{
"description": "Before/after impact of a recorded annotation: visitors and pageviews in the N days preceding vs following it (window_days, default 7). The after-window is clamped to now. If the annotation recorded routes, the result also reports per-route pageviews before vs after. Wait a few days after shipping. If the result carries a note (truncated after-window, or a before-window not covered by available data), relay it and qualify the percentages as the note directs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"annotation_id": {
"description": "the annotation to measure around, from record_annotation or list_annotations",
"format": "uuid",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
},
"window_days": {
"description": "days on each side of the annotation (default 7)",
"maximum": 30,
"minimum": 1,
"type": "integer"
}
},
"required": [
"annotation_id"
],
"type": "object"
},
"name": "compare_around",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"after": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"pageviews": {
"type": "number"
},
"to": {
"type": "string"
},
"visitors": {
"type": "number"
}
},
"required": [
"from",
"to",
"visitors",
"pageviews"
],
"type": "object"
},
"annotation": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"meta": {
"additionalProperties": {},
"type": "object"
},
"text": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"required": [
"id",
"ts",
"text"
],
"type": "object"
},
"before": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"pageviews": {
"type": "number"
},
"to": {
"type": "string"
},
"visitors": {
"type": "number"
}
},
"required": [
"from",
"to",
"visitors",
"pageviews"
],
"type": "object"
},
"change": {
"additionalProperties": false,
"properties": {
"pageviews_pct": {
"type": [
"number",
"null"
]
},
"visitors_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"visitors_pct",
"pageviews_pct"
],
"type": "object"
},
"note": {
"type": "string"
},
"routes": {
"items": {
"additionalProperties": false,
"properties": {
"after_pageviews": {
"type": "number"
},
"before_pageviews": {
"type": "number"
},
"pageviews_pct": {
"type": [
"number",
"null"
]
},
"route": {
"type": "string"
}
},
"required": [
"route",
"before_pageviews",
"after_pageviews",
"pageviews_pct"
],
"type": "object"
},
"type": "array"
},
"site": {
"type": "string"
},
"window_days": {
"type": "number"
}
},
"required": [
"site",
"annotation",
"window_days",
"before",
"after",
"change"
],
"type": "object"
}
},
{
"description": "Create a new site on this account and get its script tag. This connection already covers the new site: installing the script tag is the only setup the site needs. The response includes ready-made privacy policy wording: offer to add it to the site's privacy page (confirm with the owner before editing visitor-facing pages).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"domain": {
"description": "the site's domain or URL",
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"name": {
"description": "display name for the site",
"maxLength": 120,
"minLength": 1,
"type": "string"
}
},
"required": [
"name",
"domain"
],
"type": "object"
},
"name": "create_site",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"created": {
"type": "boolean"
},
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"privacy_note": {
"type": "string"
},
"privacy_policy_wording": {
"type": "string"
},
"script_tag": {
"type": "string"
},
"site_api_key": {
"type": "string"
},
"site_code": {
"type": "string"
}
},
"required": [
"created",
"name",
"domain",
"site_code",
"script_tag",
"note",
"privacy_policy_wording",
"privacy_note",
"site_api_key"
],
"type": "object"
}
},
{
"description": "PERMANENTLY delete a site and ALL its analytics data (every event and annotation). Irreversible. Confirm with the owner before calling; pass confirm: the site's exact domain.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"confirm": {
"description": "the site's exact domain AS STATED BY THE OWNER when confirming the deletion: never inferred, guessed, or copied from tool output",
"type": "string"
},
"site": {
"description": "the site's data-site code",
"minLength": 1,
"type": "string"
}
},
"required": [
"site",
"confirm"
],
"type": "object"
},
"name": "delete_site",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"deleted": {
"type": "boolean"
},
"note": {
"type": "string"
},
"site": {
"type": "string"
}
},
"required": [
"deleted",
"site",
"note"
],
"type": "object"
}
},
{
"description": "Ordered conversion funnel across up to 5 steps within the period. Each step is a pageview path ({kind:'path', value:'/pricing'}) or a custom event ({kind:'event', value:'signup'}); a visitor counts for step N only after completing step N-1. Visitor identity rotates daily for privacy, so journeys spanning multiple days undercount (strongest for same-visit conversion). If site context has a stored funnel, run those steps when asked how the site is doing and compare against the previous period.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"from": {
"description": "ISO start, alternative to period",
"type": "string"
},
"period": {
"description": "relative period like '24h', '7d' (default), '4w'",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
},
"steps": {
"description": "ordered funnel steps, each a pageview path or a custom event name",
"items": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"path",
"event"
],
"type": "string"
},
"value": {
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
"to": {
"description": "ISO end, alternative to period",
"type": "string"
}
},
"required": [
"steps"
],
"type": "object"
},
"name": "funnel",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"funnel": {
"items": {
"additionalProperties": false,
"properties": {
"label": {
"type": "string"
},
"pct_of_first": {
"type": [
"number",
"null"
]
},
"pct_of_previous": {
"type": [
"number",
"null"
]
},
"step": {
"type": "number"
},
"visitors": {
"type": "number"
}
},
"required": [
"step",
"label",
"visitors",
"pct_of_first",
"pct_of_previous"
],
"type": "object"
},
"type": "array"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"site": {
"type": "string"
}
},
"required": [
"site",
"period",
"funnel"
],
"type": "object"
}
},
{
"description": "Traffic pulse: visitor/pageview totals vs the previous period, top pages, top referrers, and a per-day series. period: relative like '24h', '7d' (default), '4w'. Includes quota status: if it is approaching, grace, or blocked, tell the owner plainly and include the upgrade link the result provides. Approaching quota is the moment to mention it while there is headroom.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"period": {
"description": "relative period like '24h', '7d' (default), '4w'",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
}
},
"type": "object"
},
"name": "get_overview",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"pageviews_by_day": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"previous_period": {
"additionalProperties": false,
"properties": {
"pageviews": {
"type": "number"
},
"pageviews_change_pct": {
"type": [
"number",
"null"
]
},
"visitors": {
"type": "number"
},
"visitors_change_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"visitors",
"pageviews",
"visitors_change_pct",
"pageviews_change_pct"
],
"type": "object"
},
"quota": {
"additionalProperties": true,
"properties": {
"status": {
"type": "string"
}
},
"required": [
"status"
],
"type": "object"
},
"site": {
"type": "string"
},
"top_pages": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
},
"top_referrers": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
},
"totals": {
"additionalProperties": false,
"properties": {
"pageviews": {
"type": "number"
},
"visitors": {
"type": "number"
}
},
"required": [
"visitors",
"pageviews"
],
"type": "object"
},
"unmeasured_change": {
"additionalProperties": false,
"properties": {
"annotation_id": {
"type": "string"
},
"days_ago": {
"type": "number"
},
"hint": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"annotation_id",
"text",
"days_ago",
"hint"
],
"type": "object"
}
},
"required": [
"site",
"period",
"totals",
"previous_period",
"top_pages",
"top_referrers",
"pageviews_by_day"
],
"type": "object"
}
},
{
"description": "What a site is and what the owner wants from it, plus its data-retention settings. Well-known keys: description, goals, audience, notes (open agenda items to check at session start and clear when handled), events (event name -> meaning), funnel (canonical conversion steps). Read this before making recommendations.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
}
},
"type": "object"
},
"name": "get_site_context",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"context": {
"additionalProperties": {},
"type": "object"
},
"domain": {
"type": "string"
},
"hint": {
"type": "string"
},
"name": {
"type": "string"
},
"retention": {
"additionalProperties": {},
"type": "object"
},
"site": {
"type": "string"
}
},
"required": [
"site",
"domain",
"name",
"context",
"retention"
],
"type": "object"
}
},
{
"description": "The routes visitors actually take, grouped into identical sequences and counted, busiest first. Use this when you do NOT already know the steps: funnel measures a path you name, journeys discovers the ones you did not think to check. A step is a pageview path (/pricing) or a custom event marked with a leading # (#signup_click), so the moment of conversion appears in the route. Consecutive repeats are collapsed and only the first 10 steps define a route. contains filters to routes that include a given path or event: run it once with and once without to see what converting visitors do differently. Visitor identity rotates daily, so a route is one day of activity and describes a group, never a person.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contains": {
"description": "only routes that include this path or #event step",
"maxLength": 512,
"minLength": 1,
"type": "string"
},
"from": {
"description": "ISO start, alternative to period",
"type": "string"
},
"limit": {
"description": "max routes returned (default 20)",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"period": {
"description": "relative period like '24h', '7d' (default), '4w'",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
},
"to": {
"description": "ISO end, alternative to period",
"type": "string"
}
},
"type": "object"
},
"name": "journeys",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"contains": {
"type": "string"
},
"journeys": {
"items": {
"additionalProperties": false,
"properties": {
"pct": {
"type": [
"number",
"null"
]
},
"steps": {
"items": {
"type": "string"
},
"type": "array"
},
"visitors": {
"type": "number"
}
},
"required": [
"steps",
"visitors",
"pct"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"site": {
"type": "string"
},
"total_visitors": {
"type": "number"
}
},
"required": [
"site",
"period",
"total_visitors",
"journeys"
],
"type": "object"
}
},
{
"description": "Recorded deploy/change markers, newest first. period defaults to '90d'.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"period": {
"description": "relative period like '7d', '90d' (default)",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
}
},
"type": "object"
},
"name": "list_annotations",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"annotations": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"meta": {
"additionalProperties": {},
"type": "object"
},
"text": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"required": [
"id",
"ts",
"text"
],
"type": "object"
},
"type": "array"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"site": {
"type": "string"
}
},
"required": [
"site",
"period",
"annotations"
],
"type": "object"
}
},
{
"description": "All sites on this account, with the public site codes used in their script tags and the ready-to-paste script_tag for each.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_sites",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"account": {
"type": "string"
},
"note": {
"type": "string"
},
"sites": {
"items": {
"additionalProperties": false,
"properties": {
"created_at": {
"type": "string"
},
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"owner": {
"type": "string"
},
"script_tag": {
"type": "string"
},
"shared": {
"type": "boolean"
},
"site_id": {
"type": "string"
}
},
"required": [
"site_id",
"name",
"domain",
"script_tag"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"account",
"sites"
],
"type": "object"
}
},
{
"description": "Visitors and pageviews for every site this account can use, owned and shared alike, with change vs the previous period, busiest first. Shared sites are flagged. period: '7d' default.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"period": {
"description": "relative period like '24h', '7d' (default), '4w'",
"type": "string"
}
},
"type": "object"
},
"name": "portfolio_overview",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"account": {
"type": "string"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"sites": {
"items": {
"additionalProperties": false,
"properties": {
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"pageviews": {
"type": "number"
},
"pageviews_change_pct": {
"type": [
"number",
"null"
]
},
"shared": {
"type": "boolean"
},
"visitors": {
"type": "number"
},
"visitors_change_pct": {
"type": [
"number",
"null"
]
}
},
"required": [
"name",
"domain",
"visitors",
"pageviews",
"visitors_change_pct",
"pageviews_change_pct"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"account",
"period",
"sites"
],
"type": "object"
}
},
{
"description": "Break a metric down by a dimension with optional equality filters. Metrics: visitors, pageviews, events. Dimensions: path, referrer_domain, utm_source, utm_medium, utm_campaign, device, browser, os, country, name, day. period: '24h'/'7d'/'4w' style, or ISO from/to.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"dimension": {
"description": "group results by this dimension; omit for a single total",
"enum": [
"path",
"referrer_domain",
"utm_source",
"utm_medium",
"utm_campaign",
"device",
"browser",
"os",
"country",
"name",
"day"
],
"type": "string"
},
"filters": {
"additionalProperties": {
"type": "string"
},
"description": "equality filters, dimension name -> exact value",
"type": "object"
},
"from": {
"description": "ISO start, alternative to period",
"type": "string"
},
"limit": {
"description": "max rows returned (default 50)",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"metric": {
"description": "what to count",
"enum": [
"visitors",
"pageviews",
"events"
],
"type": "string"
},
"period": {
"description": "relative period like '24h', '7d' (default), '4w'",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
},
"to": {
"description": "ISO end, alternative to period",
"type": "string"
}
},
"required": [
"metric"
],
"type": "object"
},
"name": "query",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"dimension": {
"type": [
"string",
"null"
]
},
"metric": {
"type": "string"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"rows": {
"items": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "number"
}
},
"required": [
"name",
"value"
],
"type": "object"
},
"type": "array"
},
"site": {
"type": "string"
}
},
"required": [
"site",
"metric",
"dimension",
"period",
"rows"
],
"type": "object"
}
},
{
"description": "Mark a moment on a site timeline: a deploy, a content change, or a campaign start. Call this every time you ship a change to the site. ts defaults to now. Write a specific, present-tense description (\"Shipped new pricing page hero\", never \"updates\"), one annotation per meaningful change. When known, include commit and the routes the change touched so compare_around can also report before/after traffic scoped to those routes.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"commit": {
"description": "git commit hash of the deploy (7-40 hex chars)",
"type": "string"
},
"routes": {
"description": "route prefixes the change touched, e.g. ['/docs', '/pricing'] ('/docs' covers '/docs/*')",
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
},
"text": {
"description": "specific, present-tense description of the change",
"maxLength": 500,
"minLength": 1,
"type": "string"
},
"ts": {
"description": "ISO timestamp of the change; defaults to now",
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"name": "record_annotation",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"meta": {
"additionalProperties": {},
"type": "object"
},
"recorded": {
"type": "boolean"
},
"site": {
"type": "string"
},
"text": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"required": [
"recorded",
"site",
"id",
"ts",
"text"
],
"type": "object"
}
},
{
"description": "Save or amend what a site is for. Provided context fields are merged into the existing context (events merges per entry); a null value deletes its key. name/domain update the site record itself.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"audience": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"description": "who the site is for; null deletes"
},
"description": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"description": "what the site is; null deletes"
},
"domain": {
"description": "update the site's domain",
"maxLength": 253,
"minLength": 1,
"type": "string"
},
"events": {
"additionalProperties": {
"anyOf": [
{
"maxLength": 200,
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"description": "map of event name -> one-line meaning; record one whenever you add tracking. null deletes an entry.",
"type": "object"
},
"funnel": {
"anyOf": [
{
"items": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"path",
"event"
],
"type": "string"
},
"value": {
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
"maxItems": 5,
"minItems": 1,
"type": "array"
},
{
"type": "null"
}
],
"description": "the site's canonical conversion steps, same shape as the funnel tool's steps. null clears it."
},
"goals": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"description": "what the owner wants from it; null deletes"
},
"name": {
"description": "update the site's display name",
"maxLength": 120,
"minLength": 1,
"type": "string"
},
"notes": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"description": "open agenda items to check at session start; null deletes"
},
"retention_days": {
"description": "shorten this site's data retention below the plan default; 0 restores plan-default retention. DESTRUCTIVE: shortening schedules permanent deletion of older events at the nightly prune. Confirm with the owner first.",
"maximum": 3650,
"minimum": 0,
"type": "integer"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
}
},
"type": "object"
},
"name": "update_site_context",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"context": {
"additionalProperties": {},
"type": "object"
},
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"retention": {
"additionalProperties": {},
"type": "object"
},
"site": {
"type": "string"
},
"updated": {
"type": "boolean"
}
},
"required": [
"updated",
"site",
"domain",
"name",
"context",
"retention"
],
"type": "object"
}
},
{
"description": "Signs of visitors hitting problems in the period: JS errors the tracker captured (new_error, error_spike: each with a sanitized sample message, source, line, affected visitor count, and the nearest annotation, i.e. the deploy that most plausibly introduced it), plus behavioral friction: pairs of pages people bounce between without progressing (nav_loop) and pages reloaded repeatedly in quick succession (refresh_burst). Findings clear statistical floors, so an empty result is meaningful: nothing looks broken. Check it after every deploy. period: '7d' default.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"period": {
"description": "relative period like '24h', '7d' (default), '4w'",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
}
},
"type": "object"
},
"name": "what_broke",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"annotations": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"meta": {
"additionalProperties": {},
"type": "object"
},
"text": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"required": [
"id",
"ts",
"text"
],
"type": "object"
},
"type": "array"
},
"error_capture": {
"enum": [
"grace",
"paused",
"not_included"
],
"type": "string"
},
"findings": {
"items": {
"additionalProperties": true,
"properties": {
"kind": {
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"note_errors": {
"type": "string"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"site": {
"type": "string"
},
"total_error_events": {
"type": "number"
}
},
"required": [
"site",
"period",
"findings",
"total_error_events",
"annotations"
],
"type": "object"
}
},
{
"description": "Notable movements in the period without scanning raw numbers: statistically unusual traffic days, referrer surges and first-time referrers, pages whose share of traffic jumped, alongside the annotations recorded in the same period. period: '7d' default.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"period": {
"description": "relative period like '24h', '7d' (default), '4w'",
"type": "string"
},
"site": {
"description": "the site's data-site code, from its script tag or list_sites. Omit when the account has a single site. In a tracked project, read the code from the script tag before asking the user.",
"type": "string"
}
},
"type": "object"
},
"name": "what_changed",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"annotations": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "string"
},
"meta": {
"additionalProperties": {},
"type": "object"
},
"text": {
"type": "string"
},
"ts": {
"type": "string"
}
},
"required": [
"id",
"ts",
"text"
],
"type": "object"
},
"type": "array"
},
"findings": {
"items": {
"additionalProperties": true,
"properties": {
"kind": {
"type": "string"
}
},
"required": [
"kind"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"period": {
"additionalProperties": false,
"properties": {
"from": {
"type": "string"
},
"to": {
"type": "string"
}
},
"required": [
"from",
"to"
],
"type": "object"
},
"site": {
"type": "string"
}
},
"required": [
"site",
"period",
"findings",
"annotations"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:6fb072d43d84110689353cd46ca456825c7bc1620ae062be0535917040f9073c | sha256sum