observability Static interface comparison

Microsoft Clarity MCP

1.0.5 2.0.0

FAILPending human review

3 new unknown capabilities require explicit review.

View the upgrade review as Markdown

A shareable summary of this comparison for an issue, pull request or ticket. Select the text and copy it.

Tools1 → 3
Added3
Removed1
Schema changes0
Input schema changes0
Output schema changes0
Unclassified schema changes0
Description changes0
New write authority0
New destructive authority0
New unknown authority3
AnalysisFAIL

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

4 tools with recorded changes

  1. get-clarity-dataRemovedRemovedREVIEW

    What changed

    • Tool get-clarity-data was removed.

    Why it could matter

    • Integrations, prompts or agent configurations that call this tool will not find it in this release.

    What to verify

    • Check whether existing integrations still reference this tool.
    Declared effect
    unknown → —

    Input schema

    PropertyPrevious (1.0.5)Current (2.0.0)Change
    (schema root)object, additionalProperties=falsenot present
    • Removed
    dimensionsarrayoptionalnot present
    • Removed
    dimensions › [items]stringnot present
    • Removed
    metricsarrayoptionalnot present
    • Removed
    metrics › [items]stringnot present
    • Removed
    numOfDaysnumber, maximum=3, minimum=1requirednot present
    • Removed
    tokenstringoptionalnot present
    • Removed

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  2. list-session-recordingsAddedAuthorityFAIL

    What changed

    • New tool list-session-recordings, declared with unknown effect.

    Why it could matter

    • Valyd could not determine this tool’s effect from its declared interface, so its authority is not known.

    What to verify

    • Read the tool’s documentation and schema before allowing agents to use it.
    Declared effect
    — → unknown

    Input schema

    PropertyPrevious (1.0.5)Current (2.0.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    countnot presentnumber, default=100, maximum=250optional
    • Added
    filtersnot presentobject, additionalProperties=falserequired
    • Added
    filters › browsernot presentarrayoptional
    • Added
    filters › browser › [items]not presentstring, enum (20)
    • Added
    filters › campaignnot presentarrayoptional
    • Added
    filters › campaign › [items]not presentstring
    • Added
    filters › channelnot presentarrayoptional
    • Added
    filters › channel › [items]not presentstring, enum (14)
    • Added
    filters › checkoutAbandonmentStepnot presentarrayoptional
    • Added
    filters › checkoutAbandonmentStep › [items]not presentstring
    • Added
    filters › citynot presentarrayoptional
    • Added
    filters › city › [items]not presentstring
    • Added
    filters › clickErrorsnot presentarrayoptional
    • Added
    filters › clickErrors › [items]not presentstring
    • Added
    filters › clickedTextnot presentstringoptional
    • Added
    filters › countrynot presentarrayoptional
    • Added
    filters › country › [items]not presentstring
    • Added
    filters › cumulativeLayoutShiftnot presentanyOf (2)required
    • Added
    filters › cursorMovementnot presentbooleanoptional
    • Added
    filters › datenot presentobject, additionalProperties=falserequired
    • Added
    filters › date › endnot presentstringrequired
    • Added
    filters › date › startnot presentstringrequired
    • Added
    filters › deadClickPresentnot presentbooleanoptional
    • Added
    filters › deviceTypenot presentarrayoptional
    • Added
    filters › deviceType › [items]not presentstring, enum (5)
    • Added
    filters › enteredTextPresentnot presentbooleanoptional
    • Added
    filters › entryUrlsnot presentarrayoptional
    • Added
    filters › entryUrls › [items]not present$ref="#/properties/filters/properties/visitedUrls/items"
    • Added
    filters › excessiveScrollPresentnot presentbooleanoptional
    • Added
    filters › exitUrlsnot presentarrayoptional
    • Added
    filters › exitUrls › [items]not present$ref="#/properties/filters/properties/visitedUrls/items"
    • Added
    filters › firstInputDelaynot presentanyOf (2)required
    • Added
    filters › hiddenPageDurationnot presentanyOf (2)required
    • Added
    filters › javascriptErrorsnot presentarrayoptional
    • Added
    filters › javascriptErrors › [items]not presentstring
    • Added
    filters › largestContentfulPaintnot presentanyOf (2)required
    • Added
    filters › mediumnot presentarrayoptional
    • Added
    filters › medium › [items]not presentstring
    • Added
    filters › osnot presentarrayoptional
    • Added
    filters › os › [items]not presentstring, enum (9)
    • Added
    filters › pageClickEventCountnot presentanyOf (2)required
    • Added
    filters › pageDurationnot presentanyOf (2)required
    • Added
    filters › pagesCountnot presentanyOf (2)required
    • Added
    filters › performanceScorenot presentanyOf (2)required
    • Added
    filters › productAvailabilitynot presentbooleanoptional
    • Added
    filters › productBrandnot presentarrayoptional
    • Added
    filters › productBrand › [items]not presentstring
    • Added
    filters › productNamenot presentstringoptional
    • Added
    filters › productPricenot presentanyOf (2)required
    • Added
    filters › productPurchasesnot presentbooleanoptional
    • Added
    filters › productRatingnot presentanyOf (2)required
    • Added
    filters › productRatingsCountnot presentanyOf (2)required
    • Added
    filters › quickbackClickPresentnot presentbooleanoptional
    • Added
    filters › rageClickPresentnot presentbooleanoptional
    • Added
    filters › referringUrlnot presentstringoptional
    • Added
    filters › resizeEventPresentnot presentbooleanoptional
    • Added
    filters › scrollDepthnot presentanyOf (2)required
    • Added
    filters › selectedTextPresentnot presentbooleanoptional
    • Added
    filters › sessionClickEventCountnot presentanyOf (2)required
    • Added
    filters › sessionDurationnot presentanyOf (2)required
    • Added
    filters › sessionIntentnot presentstring, enum (3)optional
    • Added
    filters › smartEventsnot presentarrayoptional
    • Added
    filters › smartEvents › [items]not presentstring
    • Added
    filters › sourcenot presentarrayoptional
    • Added
    filters › source › [items]not presentstring
    • Added
    filters › statenot presentarrayoptional
    • Added
    filters › state › [items]not presentstring
    • Added
    filters › userTypenot presentstring, enum (2)optional
    • Added
    filters › visiblePageDurationnot presentanyOf (2)required
    • Added
    filters › visitedUrlsnot presentarrayoptional
    • Added
    filters › visitedUrls › [items]not presentobject, additionalProperties=false
    • Added
    filters › visitedUrls › [items] › operatornot presentstring, enum (8)required
    • Added
    filters › visitedUrls › [items] › urlnot presentstringrequired
    • Added
    sortBynot presentstring, enum (8)required
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  3. query-analytics-dashboardAddedAuthorityFAIL

    What changed

    • New tool query-analytics-dashboard, declared with unknown effect.

    Why it could matter

    • Valyd could not determine this tool’s effect from its declared interface, so its authority is not known.

    What to verify

    • Read the tool’s documentation and schema before allowing agents to use it.
    Declared effect
    — → unknown

    Input schema

    PropertyPrevious (1.0.5)Current (2.0.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    querynot presentstringrequired
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  4. query-documentation-resourcesAddedAuthorityFAIL

    What changed

    • New tool query-documentation-resources, declared with unknown effect.

    Why it could matter

    • Valyd could not determine this tool’s effect from its declared interface, so its authority is not known.

    What to verify

    • Read the tool’s documentation and schema before allowing agents to use it.
    Declared effect
    — → unknown

    Input schema

    PropertyPrevious (1.0.5)Current (2.0.0)Change
    (schema root)not presentobject, additionalProperties=false
    • Added
    querynot presentstringrequired
    • Added

    No output schema is recorded for this tool in either release.

    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool

Evidence and provenance

Static findings
FAIL from Modelara’s automated analysis of the two declared interfaces. A policy outcome, not a security rating or a runtime test.
Human review
Pending human review. No reviewer decision is recorded for this comparison.
Published evidence
Part of Valyd’s published data generation listed in valyd-data-source.json. Published records are not rewritten.
Show provenance and exact files
Comparison
ms-clarity/1.0.5~2.0.0The published comparison identifier.
Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 15, 2026, 3:23 AM UTC.
Distribution
npm
Previous release
@microsoft/clarity-mcp-server@1.0.51 tools · published by the registry Jun 12, 2025, 1:21 PM UTCArtifact integritysha512-MP0MldUYakM/hMQ5MllaZtN264EpUo0nk0pQ6ggXIhUYBcYTPYFm3tdRTfGcXuCxNgZIAjXYn97xUX5sF+yYTg==Interface fingerprintsha256:40f1cd602c3517d11a2cffa1d87dc9bf384d15ddf31e0d08d4050944a5d26362Exact interface snapshot (JSON)
Current release
@microsoft/clarity-mcp-server@2.0.03 tools · published by the registry Sep 14, 2025, 6:21 AM UTCArtifact integritysha512-i4dvCBf7X9pSIzR29ntjNkkU7dALZXUVKsjpSjCLjgzV8jtq8Xddvxvfu0EmrbJ6pbSqOFDx9CVwmMGVD+VtMA==Interface fingerprintsha256:8d6d92fb1366d9660ea579ccafb1f8f08d96b20999c6c3e7ed7250e42516f293Exact interface snapshot (JSON)

The integrity value or digest identifies the exact artifact that was inspected; it does not show that the package is safe. The interface fingerprint identifies the declared tools and schemas Modelara recorded for that release.

MODELARA ANALYSIS OUTPUT

Interface findings

Analyzed with Modelara v0.1.8 · Nov 15, 2026

Policy failures

3 findings
  • list-session-recordingsFAILAdded

    New capability with unknown effect; the effect is unknown, so Modelara cannot establish that it is read-only

    Authority
    —UNKNOWN
  • query-analytics-dashboardFAILAdded

    New capability with unknown effect; the effect is unknown, so Modelara cannot establish that it is read-only

    Authority
    —UNKNOWN
  • query-documentation-resourcesFAILAdded

    New capability with unknown effect; the effect is unknown, so Modelara cannot establish that it is read-only

    Authority
    —UNKNOWN

Requires review

1 finding
  • get-clarity-dataREVIEWRemoved

    Capability removed; a workflow may depend on it

    Authority
    UNKNOWN—
What do these results mean?
PASS
No policy-significant interface change detected.
REVIEW
Interface changes require inspection.
FAIL
A policy-significant change was detected.
INVALID
The comparison could not be evaluated reliably.
← Back to Microsoft Clarity MCP release history