Staats

Cookieless web analytics your coding agent reads: traffic answers, deploy impact, what broke.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
89%
Qualität der Benennung
92%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~6,189Tokens (Tool-Definitionen)
~3.9 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (4.84% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "staats": {
      "url": "https://api.staats.ai/functions/v1/mcp"
    }
  }
}

Remote-Endpunkte

https://api.staats.ai/functions/v1/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (15)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢get_site_context(site)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "context": {
      "type": "object",
      "additionalProperties": {}
    },
    "retention": {
      "type": "object",
      "additionalProperties": {}
    },
    "hint": {
      "type": "string"
    }
  },
  "required": [
    "site",
    "domain",
    "name",
    "context",
    "retention"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴update_site_context(site, description, goals, audience, notes, ...)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "description": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ],
      "description": "what the site is; null deletes"
    },
    "goals": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ],
      "description": "what the owner wants from it; null deletes"
    },
    "audience": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ],
      "description": "who the site is for; null deletes"
    },
    "notes": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2000
        },
        {
          "type": "null"
        }
      ],
      "description": "open agenda items to check at session start; null deletes"
    },
    "events": {
      "type": "object",
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          {
            "type": "null"
          }
        ]
      },
      "description": "map of event name -> one-line meaning; record one whenever you add tracking. null deletes an entry."
    },
    "funnel": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "enum": [
                  "path",
                  "event"
                ]
              },
              "value": {
                "type": "string",
                "minLength": 1,
                "maxLength": 512
              }
            },
            "required": [
              "kind",
              "value"
            ],
            "additionalProperties": false
          },
          "minItems": 1,
          "maxItems": 5
        },
        {
          "type": "null"
        }
      ],
      "description": "the site's canonical conversion steps, same shape as the funnel tool's steps. null clears it."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "update the site's display name"
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 253,
      "description": "update the site's domain"
    },
    "retention_days": {
      "type": "integer",
      "minimum": 0,
      "maximum": 3650,
      "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "updated": {
      "type": "boolean"
    },
    "site": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "context": {
      "type": "object",
      "additionalProperties": {}
    },
    "retention": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "updated",
    "site",
    "domain",
    "name",
    "context",
    "retention"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢what_changed(site, period)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "period": {
      "type": "string",
      "description": "relative period like '24h', '7d' (default), '4w'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string"
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": true
      }
    },
    "annotations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "ts": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "meta": {
            "type": "object",
            "additionalProperties": {}
          }
        },
        "required": [
          "id",
          "ts",
          "text"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "site",
    "period",
    "findings",
    "annotations"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢what_broke(site, period)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "period": {
      "type": "string",
      "description": "relative period like '24h', '7d' (default), '4w'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string"
          }
        },
        "required": [
          "kind"
        ],
        "additionalProperties": true
      }
    },
    "total_error_events": {
      "type": "number"
    },
    "error_capture": {
      "type": "string",
      "enum": [
        "grace",
        "paused",
        "not_included"
      ]
    },
    "note_errors": {
      "type": "string"
    },
    "annotations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "ts": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "meta": {
            "type": "object",
            "additionalProperties": {}
          }
        },
        "required": [
          "id",
          "ts",
          "text"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "site",
    "period",
    "findings",
    "total_error_events",
    "annotations"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢get_overview(site, period)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "period": {
      "type": "string",
      "description": "relative period like '24h', '7d' (default), '4w'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "totals": {
      "type": "object",
      "properties": {
        "visitors": {
          "type": "number"
        },
        "pageviews": {
          "type": "number"
        }
      },
      "required": [
        "visitors",
        "pageviews"
      ],
      "additionalProperties": false
    },
    "previous_period": {
      "type": "object",
      "properties": {
        "visitors": {
          "type": "number"
        },
        "pageviews": {
          "type": "number"
        },
        "visitors_change_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "pageviews_change_pct": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "visitors",
        "pageviews",
        "visitors_change_pct",
        "pageviews_change_pct"
      ],
      "additionalProperties": false
    },
    "top_pages": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "top_referrers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "pageviews_by_day": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "additionalProperties": false
      }
    },
    "unmeasured_change": {
      "type": "object",
      "properties": {
        "annotation_id": {
          "type": "string"
        },
        "text": {
          "type": "string"
        },
        "days_ago": {
          "type": "number"
        },
        "hint": {
          "type": "string"
        }
      },
      "required": [
        "annotation_id",
        "text",
        "days_ago",
        "hint"
      ],
      "additionalProperties": false
    },
    "quota": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string"
        }
      },
      "required": [
        "status"
      ],
      "additionalProperties": true
    }
  },
  "required": [
    "site",
    "period",
    "totals",
    "previous_period",
    "top_pages",
    "top_referrers",
    "pageviews_by_day"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢query(site, metric, dimension, filters, period, ...)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "metric": {
      "type": "string",
      "enum": [
        "visitors",
        "pageviews",
        "events"
      ],
      "description": "what to count"
    },
    "dimension": {
      "type": "string",
      "enum": [
        "path",
        "referrer_domain",
        "utm_source",
        "utm_medium",
        "utm_campaign",
        "device",
        "browser",
        "os",
        "country",
        "name",
        "day"
      ],
      "description": "group results by this dimension; omit for a single total"
    },
    "filters": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "equality filters, dimension name -> exact value"
    },
    "period": {
      "type": "string",
      "description": "relative period like '24h', '7d' (default), '4w'"
    },
    "from": {
      "type": "string",
      "description": "ISO start, alternative to period"
    },
    "to": {
      "type": "string",
      "description": "ISO end, alternative to period"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "max rows returned (default 50)"
    }
  },
  "required": [
    "metric"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "metric": {
      "type": "string"
    },
    "dimension": {
      "type": [
        "string",
        "null"
      ]
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "value": {
            "type": "number"
          }
        },
        "required": [
          "name",
          "value"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "site",
    "metric",
    "dimension",
    "period",
    "rows"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢funnel(site, steps, period, from, to)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "steps": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "path",
              "event"
            ]
          },
          "value": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512
          }
        },
        "required": [
          "kind",
          "value"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "ordered funnel steps, each a pageview path or a custom event name"
    },
    "period": {
      "type": "string",
      "description": "relative period like '24h', '7d' (default), '4w'"
    },
    "from": {
      "type": "string",
      "description": "ISO start, alternative to period"
    },
    "to": {
      "type": "string",
      "description": "ISO end, alternative to period"
    }
  },
  "required": [
    "steps"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "funnel": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "step": {
            "type": "number"
          },
          "label": {
            "type": "string"
          },
          "visitors": {
            "type": "number"
          },
          "pct_of_first": {
            "type": [
              "number",
              "null"
            ]
          },
          "pct_of_previous": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "step",
          "label",
          "visitors",
          "pct_of_first",
          "pct_of_previous"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "site",
    "period",
    "funnel"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢journeys(site, contains, limit, period, from, ...)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "contains": {
      "type": "string",
      "minLength": 1,
      "maxLength": 512,
      "description": "only routes that include this path or #event step"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "max routes returned (default 20)"
    },
    "period": {
      "type": "string",
      "description": "relative period like '24h', '7d' (default), '4w'"
    },
    "from": {
      "type": "string",
      "description": "ISO start, alternative to period"
    },
    "to": {
      "type": "string",
      "description": "ISO end, alternative to period"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "contains": {
      "type": "string"
    },
    "total_visitors": {
      "type": "number"
    },
    "journeys": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "steps": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "visitors": {
            "type": "number"
          },
          "pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "steps",
          "visitors",
          "pct"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "site",
    "period",
    "total_visitors",
    "journeys"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡record_annotation(site, text, ts, commit, routes)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "specific, present-tense description of the change"
    },
    "ts": {
      "type": "string",
      "description": "ISO timestamp of the change; defaults to now"
    },
    "commit": {
      "type": "string",
      "description": "git commit hash of the deploy (7-40 hex chars)"
    },
    "routes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200
      },
      "maxItems": 10,
      "description": "route prefixes the change touched, e.g. ['/docs', '/pricing'] ('/docs' covers '/docs/*')"
    }
  },
  "required": [
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "recorded": {
      "type": "boolean"
    },
    "site": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "ts": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "meta": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "recorded",
    "site",
    "id",
    "ts",
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢list_annotations(site, period)

Recorded deploy/change markers, newest first. period defaults to '90d'.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "period": {
      "type": "string",
      "description": "relative period like '7d', '90d' (default)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "annotations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "ts": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "meta": {
            "type": "object",
            "additionalProperties": {}
          }
        },
        "required": [
          "id",
          "ts",
          "text"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "site",
    "period",
    "annotations"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢compare_around(site, annotation_id, window_days)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "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."
    },
    "annotation_id": {
      "type": "string",
      "format": "uuid",
      "description": "the annotation to measure around, from record_annotation or list_annotations"
    },
    "window_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "days on each side of the annotation (default 7)"
    }
  },
  "required": [
    "annotation_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string"
    },
    "annotation": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string"
        },
        "ts": {
          "type": "string"
        },
        "text": {
          "type": "string"
        },
        "meta": {
          "type": "object",
          "additionalProperties": {}
        }
      },
      "required": [
        "id",
        "ts",
        "text"
      ],
      "additionalProperties": false
    },
    "window_days": {
      "type": "number"
    },
    "before": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        },
        "visitors": {
          "type": "number"
        },
        "pageviews": {
          "type": "number"
        }
      },
      "required": [
        "from",
        "to",
        "visitors",
        "pageviews"
      ],
      "additionalProperties": false
    },
    "after": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        },
        "visitors": {
          "type": "number"
        },
        "pageviews": {
          "type": "number"
        }
      },
      "required": [
        "from",
        "to",
        "visitors",
        "pageviews"
      ],
      "additionalProperties": false
    },
    "change": {
      "type": "object",
      "properties": {
        "visitors_pct": {
          "type": [
            "number",
            "null"
          ]
        },
        "pageviews_pct": {
          "type": [
            "number",
            "null"
          ]
        }
      },
      "required": [
        "visitors_pct",
        "pageviews_pct"
      ],
      "additionalProperties": false
    },
    "routes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "route": {
            "type": "string"
          },
          "before_pageviews": {
            "type": "number"
          },
          "after_pageviews": {
            "type": "number"
          },
          "pageviews_pct": {
            "type": [
              "number",
              "null"
            ]
          }
        },
        "required": [
          "route",
          "before_pageviews",
          "after_pageviews",
          "pageviews_pct"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "site",
    "annotation",
    "window_days",
    "before",
    "after",
    "change"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢list_sites

All sites on this account, with the public site codes used in their script tags and the ready-to-paste script_tag for each.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string"
    },
    "sites": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "site_id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "created_at": {
            "type": "string"
          },
          "script_tag": {
            "type": "string"
          },
          "shared": {
            "type": "boolean"
          },
          "owner": {
            "type": "string"
          }
        },
        "required": [
          "site_id",
          "name",
          "domain",
          "script_tag"
        ],
        "additionalProperties": false
      }
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "account",
    "sites"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡create_site(name, domain)

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

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "display name for the site"
    },
    "domain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 253,
      "description": "the site's domain or URL"
    }
  },
  "required": [
    "name",
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "created": {
      "type": "boolean"
    },
    "name": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "site_code": {
      "type": "string"
    },
    "script_tag": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "privacy_policy_wording": {
      "type": "string"
    },
    "privacy_note": {
      "type": "string"
    },
    "site_api_key": {
      "type": "string"
    }
  },
  "required": [
    "created",
    "name",
    "domain",
    "site_code",
    "script_tag",
    "note",
    "privacy_policy_wording",
    "privacy_note",
    "site_api_key"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🔴delete_site(site, confirm)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "site": {
      "type": "string",
      "minLength": 1,
      "description": "the site's data-site code"
    },
    "confirm": {
      "type": "string",
      "description": "the site's exact domain AS STATED BY THE OWNER when confirming the deletion: never inferred, guessed, or copied from tool output"
    }
  },
  "required": [
    "site",
    "confirm"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "deleted": {
      "type": "boolean"
    },
    "site": {
      "type": "string"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "deleted",
    "site",
    "note"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢portfolio_overview(period)

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.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "description": "relative period like '24h', '7d' (default), '4w'"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ausgabe-Schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string"
    },
    "period": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string"
        },
        "to": {
          "type": "string"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "sites": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "domain": {
            "type": "string"
          },
          "visitors": {
            "type": "number"
          },
          "pageviews": {
            "type": "number"
          },
          "visitors_change_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "pageviews_change_pct": {
            "type": [
              "number",
              "null"
            ]
          },
          "shared": {
            "type": "boolean"
          }
        },
        "required": [
          "name",
          "domain",
          "visitors",
          "pageviews",
          "visitors_change_pct",
          "pageviews_change_pct"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "account",
    "period",
    "sites"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Empfohlene Prompts

search_research
Search for information about [topic] using Staats
Erwartete Tools: query
find_specific
Find [specific item] using Staats
Erwartete Tools: query
retrieve_data
Get details about [item] from Staats
Erwartete Tools: get_site_context
fetch_info
Fetch [information type] using Staats
Erwartete Tools: get_site_context
list_items
List all [items] available in Staats
Erwartete Tools: list_annotations

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet15 Tools
verifiziertVersion nicht aufgezeichnet15 Tools
verifiziertVersion nicht aufgezeichnet15 Tools
verifiziertVersion nicht aufgezeichnet15 Tools
verifiziertVersion nicht aufgezeichnet15 Tools
verifiziertVersion nicht aufgezeichnet15 Tools