Observability MCP server

Microsoft Clarity MCP

Version history of discovered tools, schemas, and declared agent authority.

View watchlist

DistributionDistribution: npm
Package@microsoft/clarity-mcp-server
Latest analyzed version2.0.1
Current tool count3
Latest analysisNov 15, 2026
Package source

OBSERVED INTERFACE

Capability surface

Modelara’s observed declarations are shown separately from its derived effect classifications.

3 releases analyzed1.0.5 → 2.0.1Latest: 2.0.1
  • read3
  • write0
  • destructive0
  • unknown0

Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.

Package
@microsoft/clarity-mcp-server@2.0.1
Registry
npm
Published
Oct 28, 2025
Integrity
sha512-0T4vnPdoY7MDbsHWTQjRknS0ICcHjAZe7xGs7rh0hPhN8g809Ez1G6Kw/iuI+XdJ12CJUTsQSCpTaqRvH9gg6w==
Analyzer
modelara v0.1.8 · policy not recorded
Repository
https://github.com/microsoft/clarity-mcp-server

3 capabilities

CapabilityTypeDerived effectFirst observed in Valyd coverageLast changed
list-session-recordingsms-clarity:tool:list-session-recordings
Observed interface and hashes

List Microsoft Clarity session recordings based on specified filters. The filters allow you to narrow down the recordings by various criteria such as URLs, device types, browser, OS, country, city, and more. The date filter is required and must be in UTC ISO 8601 format.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "count": {
      "default": 100,
      "description": "The number of sample session recordings to return. Default is 100. Maximum is 250.",
      "maximum": 250,
      "type": "number"
    },
    "filters": {
      "additionalProperties": false,
      "description": "A set of filters that can be applied to the Microsoft Clarity to session recordings. This allows you to filter recordings based on various criteria such as URLs, device types, browser, OS, country, city, and more. The date filter is required and must be in UTC ISO 8601 format.",
      "properties": {
        "browser": {
          "description": "Filter by browser types.",
          "items": {
            "enum": [
              "Bot",
              "MiuiBrowser",
              "Chrome",
              "CoralWebView",
              "Edge",
              "Other",
              "Firefox",
              "IE",
              "Unknown",
              "Headless",
              "MobileApp",
              "Opera",
              "OperaMini",
              "Safari",
              "Samsung",
              "SamsungInternet",
              "Sogou",
              "UCBrowser",
              "YandexBrowser",
              "QQBrowser"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "campaign": {
          "description": "Filter by UTM campaign parameter values (e.g., ['summer_sale', 'product_launch'])",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "channel": {
          "description": "Filter by marketing channel classifications.",
          "items": {
            "enum": [
              "OrganicSearch",
              "Direct",
              "Email",
              "Display",
              "Social",
              "PaidSearch",
              "Other",
              "Affiliate",
              "Referral",
              "Video",
              "Audio",
              "SMS",
              "AITools",
              "PaidAITools"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "checkoutAbandonmentStep": {
          "description": "Filter by checkout abandonment steps/stages (e.g., ['cart', 'shipping', 'payment'])",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "city": {
          "description": "Filter by city names (e.g., ['New York', 'London', 'Tokyo'])",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "clickErrors": {
          "description": "Filter by click error patterns or messages. Use empty string '' to match any click error",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "clickedText": {
          "description": "Filter by specific text content that was clicked (partial match supported)",
          "type": "string"
        },
        "country": {
          "description": "Filter by country names (e.g., ['United States', 'Canada', 'United Kingdom'])",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "cumulativeLayoutShift": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by Cumulative Layout Shift web vital in seconds. Set to null to ignore this filter."
        },
        "cursorMovement": {
          "description": "Filter sessions with cursor/pointer movement activity. Set to true to include only sessions with cursor movement",
          "type": "boolean"
        },
        "date": {
          "additionalProperties": false,
          "properties": {
            "end": {
              "description": "The end date of the time interval in UTC ISO 8601 with milliseconds format (yyyy-MM-ddTHH:mm:ss.fffZ).",
              "type": "string"
            },
            "start": {
              "description": "The start date of the time interval in UTC ISO 8601 with milliseconds format (yyyy-MM-ddTHH:mm:ss.fffZ).",
              "type": "string"
            }
          },
          "required": [
            "start",
            "end"
          ],
          "type": "object"
        },
        "deadClickPresent": {
          "description": "Filter sessions containing dead clicks (clicks with no response). Set to true to include only sessions with dead clicks",
          "type": "boolean"
        },
        "deviceType": {
          "description": "Filter by device types.",
          "items": {
            "enum": [
              "Mobile",
              "Tablet",
              "PC",
              "Email",
              "Other"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "enteredTextPresent": {
          "description": "Filter sessions where text input events occurred. Set to true to include only sessions with text input",
          "type": "boolean"
        },
        "entryUrls": {
          "description": "Filter by entry/landing page URLs with pattern matching.",
          "items": {
            "$ref": "#/properties/filters/properties/visitedUrls/items"
          },
          "type": "array"
        },
        "excessiveScrollPresent": {
          "description": "Filter sessions with excessive scrolling behavior. Set to true to include only sessions with excessive scrolling",
          "type": "boolean"
        },
        "exitUrls": {
          "description": "Filter by exit page URLs with pattern matching.",
          "items": {
            "$ref": "#/properties/filters/properties/visitedUrls/items"
          },
          "type": "array"
        },
        "firstInputDelay": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by First Input Delay web vital in milliseconds. Set to null to ignore this filter."
        },
        "hiddenPageDuration": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by time spent on hidden/background pages in minutes. Set to null to ignore this filter."
        },
        "javascriptErrors": {
          "description": "Filter by JavaScript error messages or patterns. Use empty string '' to match any JavaScript error",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "largestContentfulPaint": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by Largest Contentful Paint web vital in seconds. Set to null to ignore this filter."
        },
        "medium": {
          "description": "Filter by UTM medium parameter values. Common values: ['organic', 'cpc', 'email', 'social', 'referral']",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "os": {
          "description": "Filter by operating systems.",
          "items": {
            "enum": [
              "BlackBerry",
              "Android",
              "ChromeOS",
              "iOS",
              "Linux",
              "MacOS",
              "Other",
              "Windows",
              "WindowsMobile"
            ],
            "type": "string"
          },
          "type": "array"
        },
        "pageClickEventCount": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by number of clicks per page. Set to null to ignore this filter."
        },
        "pageDuration": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by total page duration in minutes. Set to null to ignore this filter."
        },
        "pagesCount": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by number of pages visited in session. Set to null to ignore this filter."
        },
        "performanceScore": {
          "additionalProperties": false,
          "description": "Filter by overall performance score. Set to null to ignore this filter.",
          "properties": {
            "max": {
              "anyOf": [
                {
                  "maximum": 100,
                  "minimum": 0,
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "min": {
              "anyOf": [
                {
                  "maximum": 100,
                  "minimum": 0,
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "min",
            "max"
          ],
          "type": "object"
        },
        "productAvailability": {
          "description": "Filter by product availability status. Set to true to include only sessions with available products",
          "type": "boolean"
        },
        "productBrand": {
          "description": "Filter by product brand names (e.g., ['Nike', 'Apple', 'Samsung'])",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "productName": {
          "description": "Filter by product name (partial match supported using contains operator)",
          "type": "string"
        },
        "productPrice": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by product price range. Set to null to ignore this filter."
        },
        "productPurchases": {
          "description": "Filter sessions with checkout conversion/purchases. Set to true to include only sessions with purchases",
          "type": "boolean"
        },
        "productRating": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by product ratings (e.g., 1-5 stars). Set to null to ignore this filter."
        },
        "productRatingsCount": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by number of product ratings. Set to null to ignore this filter."
        },
        "quickbackClickPresent": {
          "description": "Filter sessions with quick back navigation clicks. Set to true to include only sessions with quick back clicks",
          "type": "boolean"
        },
        "rageClickPresent": {
          "description": "Filter sessions containing rage clicks (rapid repeated clicks). Set to true to include only sessions with rage clicks",
          "type": "boolean"
        },
        "referringUrl": {
          "description": "Filter by the referring URL that brought users to the site",
          "type": "string"
        },
        "resizeEventPresent": {
          "description": "Filter sessions where page resize events occurred. Set to true to include only sessions with resize events",
          "type": "boolean"
        },
        "scrollDepth": {
          "additionalProperties": false,
          "description": "Filter by maximum scroll depth percentage. Set to null to ignore this filter.",
          "properties": {
            "max": {
              "anyOf": [
                {
                  "maximum": 100,
                  "minimum": 0,
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "min": {
              "anyOf": [
                {
                  "maximum": 100,
                  "minimum": 0,
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "min",
            "max"
          ],
          "type": "object"
        },
        "selectedTextPresent": {
          "description": "Filter sessions where text selection events occurred. Set to true to include only sessions with text selection",
          "type": "boolean"
        },
        "sessionClickEventCount": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by total clicks per session. Set to null to ignore this filter."
        },
        "sessionDuration": {
          "$ref": "#/properties/filters/properties/visiblePageDuration",
          "description": "Filter by total session duration in minutes. Set to null to ignore this filter."
        },
        "sessionIntent": {
          "description": "Filter by session intention level/user behavior classification.",
          "enum": [
            "Low Intention",
            "Medium Intention",
            "High Intention"
          ],
          "type": "string"
        },
        "smartEvents": {
          "description": "Filter by smart event names/IDs. Can be user-defined events or Clarity auto events: 'Purchase', 'ContactUs', 'SubmitForm', 'AddToCart', 'RequestQuote', 'SignUp', 'BeginCheckout', 'Download', 'Login', 'Search', 'Play', 'Deposit', 'Schedule', 'Subscribe', 'FindLocation', 'OutboundClick', 'ShowMore', 'Book', 'RetryRefresh', 'Pay', 'Pause', 'Upload', 'CheckAvailability', 'Withdraw', 'Export', 'SeeReviews', 'AddPaymentMethod', 'AddToWishlist', 'NotifyMe', 'CheckIn', 'TransferMoney', 'Upgrade', 'ContinueAsGuest', 'Mute', 'Exchange', 'ApplyCoupon', 'Unsubscribe', 'AddToCalendar', 'Unmute', 'EnterFullScreen', 'DeleteAccount', 'AppInstall', 'Checkout', 'OrderSuccess'",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "source": {
          "description": "Filter by UTM source parameter values (e.g., ['google', 'facebook', 'direct'])",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "state": {
          "description": "Filter by state/province names (e.g., ['California', 'Ontario', 'Bavaria'])",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "userType": {
          "description": "Filter by user type. Accepted values: NewUser, ReturningUser",
          "enum": [
            "NewUser",
            "ReturningUser"
          ],
          "type": "string"
        },
        "visiblePageDuration": {
          "additionalProperties": false,
          "description": "Filter by time spent on visible pages in minutes. Set to null to ignore this filter.",
          "properties": {
            "max": {
              "type": [
                "number",
                "null"
              ]
            },
            "min": {
              "type": [
                "number",
                "null"
              ]
            }
          },
          "required": [
            "min",
            "max"
          ],
          "type": "object"
        },
        "visitedUrls": {
          "description": "Filter by URLs visited during the session with pattern matching.",
          "items": {
            "additionalProperties": false,
            "properties": {
              "operator": {
                "enum": [
                  "contains",
                  "startsWith",
                  "endsWith",
                  "excludes",
                  "isExactly",
                  "isExactlyNot",
                  "matchesRegex",
                  "excludesRegex"
                ],
                "type": "string"
              },
              "url": {
                "type": "string"
              }
            },
            "required": [
              "url",
              "operator"
            ],
            "type": "object"
          },
          "type": "array"
        }
      },
      "required": [
        "date"
      ],
      "type": "object"
    },
    "sortBy": {
      "default": "SessionStart_DESC",
      "description": "Sort option for session recordings. Default is SessionStart_DESC (newest first).",
      "enum": [
        "SessionStart_DESC",
        "SessionStart_ASC",
        "SessionDuration_ASC",
        "SessionDuration_DESC",
        "SessionClickCount_ASC",
        "SessionClickCount_DESC",
        "PageCount_ASC",
        "PageCount_DESC"
      ],
      "type": "string"
    }
  },
  "required": [
    "filters"
  ],
  "type": "object"
}
sha256:f2a63d0f19ff93e7974d413d7e8255b4eec914484adc1f9336ab816b7d68615d

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:81dd438a4683f7f126c59176042a691d20a9f557634e07f93cb36bf519054e54

Interface hash: sha256:f50b143095f8b09e8f580bfd67357b0cf6aac60006019c5c3077da59989bd5fa

Other observed Modelara metadata
{
  "id": "mcp:@microsoft/clarity-mcp-server/list-session-recordings",
  "title": "List Session Recordings",
  "source": {
    "type": "mcp",
    "server": "@microsoft/clarity-mcp-server",
    "operation": "list-session-recordings"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:5d1909b08c2e1710ca69dd97931393e110e0cdde556f7579ab09a9889fc0f4aa"
}
toolread2.0.02.0.1
query-analytics-dashboardms-clarity:tool:query-analytics-dashboard
Observed interface and hashes

Fetch Microsoft Clarity analytics data using a simplified natural language search query. The query should be focused on one specific data retrieval or aggregation task. Avoid complex multi-purpose queries. Time ranges should be explicitly specified when possible. If no time range is provided, prompt the user to specify one.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "query": {
      "description": "A natural language search query string for filtering and shaping analytics data. The query should be specific and include temporal constraints when available. (e.g., 'Top browsers last 3 days', 'The active time duration for mobile devices in United States last week'). Time ranges should be explicitly specified when possible. If no time range is provided, prompt the user to specify one.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
sha256:253033c7ed6dabee6e28e7415841cd127209fa8b2400fd08db780a7007c53288

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:5d4fa1c9606b6b55ac893cd6b76ce3d5c77cf238cdae1d84907c17830fda8030

Interface hash: sha256:5f196e0b691966ba5bda11f469ee4a7ecafcc993a1dd1469160521ad3e9c0a65

Other observed Modelara metadata
{
  "id": "mcp:@microsoft/clarity-mcp-server/query-analytics-dashboard",
  "title": "Query Analytics Dashboard",
  "source": {
    "type": "mcp",
    "server": "@microsoft/clarity-mcp-server",
    "operation": "query-analytics-dashboard"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:171594e7a229d4cda1506efc3221c618d8af45ca107be5cf6650dde1501fd7a8"
}
toolread2.0.02.0.1
query-documentation-resourcesms-clarity:tool:query-documentation-resources
Observed interface and hashes

Retrieve Microsoft Clarity documentation snippets for finding answers to user questions including step-by-step screenshots for setup guides, features, usage, troubleshooting, and integration instructions. The query should be focused on one specific documentation topic or question. Avoid complex multi-purpose queries.

Input schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "query": {
      "description": "A natural language search query string for filtering and shaping analytics data. The query should be specific and include temporal constraints when available. (e.g., 'Top browsers last 3 days', 'The active time duration for mobile devices in United States last week'). Time ranges should be explicitly specified when possible. If no time range is provided, prompt the user to specify one.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}
sha256:253033c7ed6dabee6e28e7415841cd127209fa8b2400fd08db780a7007c53288

Output schema

Not exposed in the analyzed interface.

sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1

Description hash: sha256:4e8ad0c3e133f8e277e4dffb7119dc0b2d62a5a2568e2e22b0556652aaf6456a

Interface hash: sha256:5c0d8e7f42172031f18e18f0ad965d028248f960a1aa68de2a611e2616ebd177

Other observed Modelara metadata
{
  "id": "mcp:@microsoft/clarity-mcp-server/query-documentation-resources",
  "title": "Query Documentation Resources",
  "source": {
    "type": "mcp",
    "server": "@microsoft/clarity-mcp-server",
    "operation": "query-documentation-resources"
  },
  "declared": {
    "read_only": "true",
    "destructive": "false",
    "idempotent": "false",
    "open_world": "false"
  },
  "safety": {
    "idempotent": "true",
    "retry_safe": "true"
  },
  "metadata": {
    "mcp.annotations": "present"
  },
  "fingerprint": "sha256:066ebe83bd3cb277ce6bb60af6adb237bd7b586403e798fd2a86115913cd6e02"
}
toolread2.0.02.0.1

STATIC COMPARISONS

Release history

2 release transitions
  1. 0 added0 removed1 schema0 write0 destructive0 unknown

    Nov 15, 2026· Pending human review

  2. 3 added1 removed0 schema0 write0 destructive3 unknown

    Nov 15, 2026· Pending human review