{"capabilities":{},"defaultInputModes":["application/json","text/plain"],"defaultOutputModes":["application/json","text/plain"],"description":"Pendo Analytics Agent provides live, account-specific product analytics data.\nThis agent must be used for any questions about actual usage, metrics, user behavior, or engagement.\n\nCapabilities include:\n- Usage analytics (page views, feature clicks, time spent)\n- User and account data with custom metadata\n- Product Engagement Score (adoption, stickiness, growth)\n- Guide reach, completion, and effectiveness\n- Segmentation by predefined user and account segments\n- Discovery of pages, features, guides, and track events\n- Session replay lookup and filtering","iconUrl":"https://cdn.pendo.io/img/pendo-chevron.png","name":"Pendo Analytics Agent","preferredTransport":"JSONRPC","protocolVersion":"0.3.0","provider":{"organization":"Pendo","url":"https://www.pendo.io"},"security":[{"oauth2":["pendo.mcp"]}],"securitySchemes":{"oauth2":{"type":"oauth2","description":"OAuth 2.0 authorization code flow","flows":{"authorizationCode":{"authorizationUrl":"https://app.pendo.io/oauth/authorize","refreshUrl":"https://app.pendo.io/oauth/v1/token","scopes":{"pendo.mcp":"Access to Pendo analytics via MCP/A2A"},"tokenUrl":"https://app.pendo.io/oauth/v1/token"}}}},"skills":[{"description":"\nReturn the set of metadata fields available for accounts. Each key is a dot-separated metadata field name. Each value includes the field's Type and a Historical flag indicating whether the field supports historical (event-time) filtering.\n\nFor string fields with at least one value, the response also includes cardinality info to help build correct metadataFilter values instead of guessing:\n- \"cardinality\" is the total number of distinct values the field takes.\n- If cardinality is below 50, \"values\" contains every distinct value the field takes.\n- Otherwise, \"sample\" contains up to 10 example values.\n- The cardinality fields is omitted for fields with high cardinality (more than 500 distinct values).\n\nExample return value:\n\n{\n    \"account.custom.ARR\"          : {\"type\": \"float\", \"historical\": false},\n    \"account.salesforce.arr__c\"   : {\"type\": \"float\", \"historical\": true},\n    \"account.salesforce.industry\" : {\"type\": \"string\", \"historical\": true, \"cardinality\": 4, \"values\": [\"finance\", \"healthcare\", \"retail\", \"technology\"]}\n}\n\nA field where historical is true can be decomposed into (kind, group, field) - for \"account.salesforce.arr__c\", that is kind=\"account\", group=\"salesforce\", field=\"arr__c\".\n","examples":["{\"skill\":\"accountMetadataSchema\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"accountMetadataSchema","inputModes":["application/json"],"name":"accountMetadataSchema","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Count new visitors or accounts per period - users whose first-ever interaction with the app (scope='app'), a specific page or feature (scope='page' or 'feature'), or a track event (scope='trackEvent') falls within the analysis window. 'New' means firstTime within the window; this measures acquisition, not retention. The window is the most recent periodCount periods of size periodType (e.g. the last 6 months). Cohorts are returned oldest to newest.\n\nUSE FOR: Growth and acquisition questions - e.g. 'how many new accounts did we gain last month?', 'what's our new visitor trend?'.\n\nEXAMPLES:\n- How many new accounts did we gain last month?\n- What's our new visitor trend over the last 6 months?\n- How many new users signed up this quarter?\n- Show me account acquisition for this feature over the last 8 weeks\n\nRETURNS:\n- scope, entityId, unit, periodType: echoed query parameters\n- acquisition: list of {cohortLabel, newCount} per period, sorted oldest to newest\n- summary: {totalNew, peakCohort, peakCount}","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"entityId\":\"\\u003centityId\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"periodCount\":\"\\u003cperiodCount\\u003e\",\"periodType\":\"\\u003cperiodType\\u003e\",\"scope\":\"\\u003cscope\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"acquisitionTrend\",\"subId\":\"\\u003csubId\\u003e\",\"unit\":\"\\u003cunit\\u003e\"}"],"id":"acquisitionTrend","inputModes":["application/json"],"name":"acquisitionTrend","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Returns key aggregate metrics for AI agent conversations with period-over-period comparison. Includes: conversations, visitors, accounts, prompts, rage prompt rates (per-prompt and per-conversation), visitorIds, accountIds, and visitor retention. All metrics include previous-period equivalents for trend analysis.\n\nUSE FOR: Getting a high-level summary of AI agent usage and engagement. Use when the user asks about overall agent performance, conversation volume, visitor engagement, rage prompt rates, or retention for a specific agent.\n\nEXAMPLES:\n- How many conversations has my ABC agent had in the last 30 days?\n- What is the rage prompt rate for Acme agent this month?\n- Show me key metrics and trends for my chat agent over the past 2 weeks.\n- How many unique visitors have used my chat agent recently?\n\nNOT FOR: Use listUseCases for topic/cluster analysis. Use listAiAgentIssues for issue detection. Use listAiAgents to get agent IDs and names first when the user has not specified an agent.\n\nRETURNS:\n- Current period: numConversations, numPrompts, numVisitors, numAccounts, numRagePrompts, ragePromptsRate, ragePromptsConversationRate, retention (retentionRate, retained, visitors), visitorIds, and accountIds.\n- Previous period (same duration, immediately prior): prevNumConversations, prevNumPrompts, prevNumVisitors, prevNumAccounts, prevNumRagePrompts, prevRagePromptsRate, prevRagePromptsConversationRate, prevRetention.\n- Also includes conversationsWithRagePrompts and prevConversationsWithRagePrompts.\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"agentAnalyticsKeyMetrics\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"agentAnalyticsKeyMetrics","inputModes":["application/json"],"name":"agentAnalyticsKeyMetrics","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Rank pages, features, or track events by aggregate usage over a date range, or measure a named set of them as one population. Entities are identified by ID, never by name. Returns {meta, summary, rows}; which part answers the question depends on which of the two was asked.\nWHOLE TYPE - omit items and name the entityType. Ranks every entity of that type, shaped by sortBy, sortOrder and limit. By default only entities WITH activity are ranked, so sortOrder='asc' gives the least-used among the USED ones; add includeUnused=true when the question is about entities getting no use at all. Two cautions: a named entity missing from the rows may simply have fallen outside limit, so to ask whether one specific entity was used, scope to it with items instead; and the summary here covers every entity of the type, not only the rows returned, so it is not a total for the top N.\nA NAMED SET - pass items to scope to exactly the entities listed, which may span entity types in ONE call; that is the only way to measure a set crossing them. Read the SUMMARY for the set as a whole: it treats the set as one deduplicated population and is independent of limit, so limit=1 still summarises everything in scope, while the rows give the breakdown within it. An entity with no activity is absent from the rows rather than ranked last, but the rows are still capped by limit - so take absence to mean 'no activity' only when limit is at least as large as the list, or set includeUnused=true (single-type lists only) to get an explicit all-zero row for every entity in the scope. Add minEvents to count only the visitors whose events across the set reach a threshold - 'how many people used this bundle at least N times'. Supply exactly one of entityType or items; both together is rejected.\nNEVER add rows together for a set-wide figure, and use the summary instead. Counts of distinct things - uniqueVisitors, uniqueAccounts, and their current_/prior_ forms in comparison mode - count a visitor active on several entities ONCE in the summary but once per row, so summing them silently inflates the answer and the rows do not carry the overlap needed to correct it. Only the additive totals - totalEvents and the frustration counts - match the sum of the rows; avgTimePerVisitor is an average and does not.\nWhere entityUsage returns per-visitor rows for one known entity, this returns one row per entity showing how an entire cohort, optionally scoped by a segment, uses each of them.\nCOMPARISON MODE - supply compareToDateRange to rank by how usage CHANGED between two periods rather than by level: dateRange is the current period, compareToDateRange the earlier baseline. Sort by a change_ column (ascending = biggest drop-off, descending = biggest growth). The ranking happens in the aggregation, so no per-entity cross-referencing is needed. includeUnused is ignored when comparing.\n\nUSE FOR: Ranking or comparing entities by usage (top pages by views, most-clicked features, features associated with a page, least-used track events), or measuring a named bundle of them - including one spanning entity types - as one population.\n\nEXAMPLES:\n- Top 5 features by clicks last month\n- Which page had the most views in the last 30 days?\n- Which features have the most rage clicks this quarter?\n- Which features associated with page X were clicked most in the last 30 days?\n- Least-used track events over the last week\n- Which pages got no views at all in the last 30 days?\n- Which features were never used by visitors in segment X last month?\n- Which pages in product area X have zero activity from visitors in segment Y?\n- Which pages dropped off in usage the most this month versus last month?\n- Which features grew the most in the last 30 days compared to the prior 30 days?\n- How many people used any of these three features last month?\n- How many visitors used our premium tier - these 4 features, this page and these 2 track events - at least twice last month?\n- How many visitors used these three features at least twice in the last 30 days?\n- How did usage of this bundle of pages change this quarter versus last?\n\nNOT FOR: Resolving an entity name to an ID. Single-entity questions where per-visitor rows are wanted, such as 'which people viewed Page X and how long did each spend'.\n\nWORKFLOW: For usage analytics about one named page, feature, or track event, call listCountables to resolve the name to an entity ID, then use entityUsage with that ID. Use aggregateEntityUsage only when the user asks to rank or compare multiple entities, or to analyse a named group of them together via items. When the user names several entities as a set ('the three features in our premium tier'), resolve each name to an ID and pass them all as items in ONE call - do not make a call per entity and add the results up, which double-counts every visitor active on more than one of them. This holds when the set crosses entity types: group the ids by type into one items list rather than issuing a call per type.\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD); meta.compareToDateRange when comparing\n- summary: the whole scoped set as one deduplicated population - totalEvents, uniqueVisitors, uniqueAccounts (pages/features also: totalErrorClickCount, totalRageClickCount, totalDeadClickCount; pages also: totalUTurnCount, avgTimePerVisitor). Independent of limit, and not the sum of the rows. In comparison mode it carries the same current_/prior_/change_/pctChange_ columns the rows do. When items spans entity types the summary carries the three shared metrics only, and its uniqueVisitors counts a visitor once across the whole bundle even when they were active on entities of different kinds\n- rows: one per entity with entityId, entityName, appId, totalEvents (page views / feature clicks / track-event counts - report it with the word matching the entity type rather than the generic 'events', including the current_/prior_/change_ forms when comparing), uniqueVisitors, uniqueAccounts (pages/features also: totalErrorClickCount, totalRageClickCount, totalDeadClickCount; pages also: totalUTurnCount, avgTimePerVisitor). Track events carry none of the frustration or time metrics, so none of those columns can rank them. With includeUnused=true, unused entities appear with all-zero metrics. In comparison mode the headline metrics (totalEvents, uniqueVisitors, uniqueAccounts) are split into current_\u003cm\u003e, prior_\u003cm\u003e, change_\u003cm\u003e and pctChange_\u003cm\u003e, while the other metrics (frustration counts, avgTimePerVisitor) carry change_\u003cm\u003e only. Prefer change_ for mover/drop-off rankings (pctChange is noisy on small baselines and null when prior is 0). When items spans entity types each row adds entityType ('page', 'feature' or 'trackEvent') and carries the three shared metrics only - read totalEvents as views, clicks or event counts according to that row's entityType, and do not compare it across rows of different types as if it were one unit","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"compareToDateRange\":\"\\u003ccompareToDateRange\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"entityType\":\"\\u003centityType\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"includeUnused\":\"\\u003cincludeUnused\\u003e\",\"items\":\"\\u003citems\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"minEvents\":\"\\u003cminEvents\\u003e\",\"pageId\":\"\\u003cpageId\\u003e\",\"productAreaId\":\"\\u003cproductAreaId\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"aggregateEntityUsage\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"aggregateEntityUsage","inputModes":["application/json"],"name":"aggregateEntityUsage","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Rank guides by aggregate usage over a date range, returning one row per guide. Where guideMetrics analyses a single known guide in depth, this tool compares an entire cohort's usage across every guide. Each row has entityId, entityName, appId, totalViews, totalCompletions, totalDismissals, uniqueVisitors, uniqueAccounts, and viewsPerUser. totalViews excludes continue-resumed guideSeen events to match the guide-details UI. Deleted guides surface with entityName \"(Deleted Guide)\".\n\nUSE FOR: Cross-guide ranking - e.g. top guides by views, which guides have the most dismissals, least-used guides.\n\nEXAMPLES:\n- Top 10 guides by views last month\n- Which guides have the most dismissals?\n- Show me the least-completed guides over the last 30 days\n- Rank guides by unique visitors this quarter\n- Top public tooltips by views\n- Compare views for these three guides\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- rows: one per guide with entityId, entityName, appId, totalViews, totalCompletions, totalDismissals, uniqueVisitors, uniqueAccounts, viewsPerUser\n\nFILTERING OPTIONS:\n- guideIds: restrict the ranking to specific guide IDs\n- status: guide state - public, staged, scheduled, draft, pendingReview, inactive\n- guideType: guide type - banner, tooltip, lightbox, walkthrough, whatsnew, building-block, group, training, launcher, mobile-lightbox\n- activation: launch method - auto (automatic), api, badge, dom (element click), embed, launcher (resource center), page, feature, form, track\n- productAreaIds / guideCategoryIds: guides belonging to those product areas or guide categories\n- pageIds: guides whose first step is on one of those pages (\"sitewide\" matches guides with no page)\n- appId, accountId, segmentPipeline: scope the underlying guide activity\n- Note: any filter other than guideIds resolves guides from their current metadata, so deleted guides drop out of the results.","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"activation\":\"\\u003cactivation\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"guideCategoryIds\":\"\\u003cguideCategoryIds\\u003e\",\"guideIds\":\"\\u003cguideIds\\u003e\",\"guideType\":\"\\u003cguideType\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"pageIds\":\"\\u003cpageIds\\u003e\",\"productAreaIds\":\"\\u003cproductAreaIds\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"aggregateGuideMetrics\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"aggregateGuideMetrics","inputModes":["application/json"],"name":"aggregateGuideMetrics","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Lists and ranks individual AI agent conversations with per-conversation metrics. Returns one row per conversation with: conversationId, visitorId, accountId, startTime, numRagePrompts, numErrors, and firstPromptContent. Supports filtering to a specific set of conversations and sorting by rage prompt count, error count, or date.\n\nUSE FOR: Drilling down from aggregate metrics to individual conversation-level investigation - surfacing which specific conversations are driving a metric such as a high rage-prompt rate. When conversationIds are provided, the list is narrowed to a specific cluster (e.g. conversations associated with a detected issue or a use case).\n\nEXAMPLES:\n- Show me the conversations with the most rage prompts for my chat agent\n- Which conversations had the most errors this week?\n- List the most recent conversations for agent X\n- Show me these specific conversations: [id1, id2, id3]\n\nNOT FOR: Aggregate volume metrics for an agent. Diagnosing an issue cluster (explanations, tools invoked, response patterns). Discovering or clustering use cases.\n\nRETURNS:\n- [conversations]: one row per conversation with conversationId, visitorId, accountId, startTime, numRagePrompts, numErrors, firstPromptContent.\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"conversationIds\":\"\\u003cconversationIds\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"agentAnalyticsConversationAnalysis\",\"sortBy\":\"\\u003csortBy\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"agentAnalyticsConversationAnalysis","inputModes":["application/json"],"name":"agentAnalyticsConversationAnalysis","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Requires startDate and endDate (YYYY-MM-DD); there is no default range. Returns issue diagnoses, flagged response tool/model usage, and user prompt content for the events of a specific detected issue cluster in AI Agent Analytics. Executes a single aggregation with two parallel spawn branches: (1) agenticConversationEvents filtered by conversationIds - deduplicated visitorIds/accountIds and sampled explanations; (2) agenticEvents - tools/models from flagged response eventIds, and prompt content from issue conversationIds.\n\nUSE FOR: Diagnosing a specific detected issue cluster when agentId, conversationIds, and eventIds are already known. Use when the user wants to understand why conversations were flagged, see patterns in user prompts that triggered the issue, or identify which tools and models were involved in the flagged responses.\n\nEXAMPLES:\n- What patterns exist among instances of the 'incorrect answers' issue?\n- Which tools were called in instances of the 'timeout error' issue?\n- Show me what users said in conversations flagged as the 'authentication failure' issue\n- Why does the 'formatting problem' issue keep occurring in my agent?\n\nNOT FOR: Discovering or listing issue clusters (this tool diagnoses a cluster whose conversationIds and eventIds are already provided). Aggregate volume metrics for an agent. Topic analysis or use-case clustering of conversations (this tool is scoped to a single detected issue, not to open-ended topic modeling).\n\nRETURNS:\n- Four labeled CSV sections:\n- [issue_instances]: visitorIds, accountIds - one summary row with deduplicated lists.\n- [explanations]: explanation - one row per sampled issue explanation (capped for MCP size).\n- [flagged_response_events]: issueToolsUsed, issueModelsUsed - one summary row with deduplicated lists.\n- [user_prompts]: content - one row per sampled user prompt message (capped for MCP size).\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"conversationIds\":\"\\u003cconversationIds\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"eventIds\":\"\\u003ceventIds\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"agentAnalyticsIssueAnalysis\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"agentAnalyticsIssueAnalysis","inputModes":["application/json"],"name":"agentAnalyticsIssueAnalysis","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Deep-dives into a single tracked issue in AI Agent Analytics for a specific AI agent, surfacing the visitors and accounts, sampled issue explanations from detected issue clusters, the tools and models the agent invoked, and a sample of the user prompts associated with the tracked issue.\n\nUSE FOR: Deep-diving into a specific tracked issue - call directly if agentId is known and conversationIds, eventIds, and trackedIssueId are passed. Use when the user wants to understand what prompts users sent for a tracked problem, which tools and models the agent invoked, or which visitors and accounts are associated with a tracked issue.\n\nEXAMPLES:\n- What are users actually saying when they hit the 'incorrect answer' tracked issue?\n- Which tools does my agent use when the 'timeout error' tracked issue occurs?\n- Who are the visitors affected by this tracked issue?\n- Show me sample prompts from this tracked issue.\n\nNOT FOR: Aggregate volume metrics, or diagnosing detected (auto-clustered) issues rather than a specific tracked issue.\n\nRETURNS:\n- Four labeled CSV sections:\n- [tracked_issue_summary]: visitorIds, accountIds - one summary row with deduplicated lists.\n- [explanations]: explanation - one row per sampled issue explanation from detected issue clusters (capped for MCP size).\n- [tools_used]: toolsUsed, modelsUsed - one summary row with deduplicated lists.\n- [prompt_samples]: content - one row per sampled user prompt message (capped for MCP size).\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"conversationIds\":\"\\u003cconversationIds\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"eventIds\":\"\\u003ceventIds\\u003e\",\"name\":\"\\u003cname\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"agentAnalyticsTrackedIssueAnalysis\",\"subId\":\"\\u003csubId\\u003e\",\"trackedIssueId\":\"\\u003ctrackedIssueId\\u003e\"}"],"id":"agentAnalyticsTrackedIssueAnalysis","inputModes":["application/json"],"name":"agentAnalyticsTrackedIssueAnalysis","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Deep-dives into a single tracked use case in AI Agent Analytics for a specific AI agent, surfacing the visitors and accounts, the tools and models the agent invoked, sampled explanations, and a sample of the user prompts associated with the tracked use case.\n\nUSE FOR: Deep-diving into a specific tracked use case - call directly if agentId is known and conversationIds, eventIds, and trackedUseCaseId are passed. Use when the user wants to understand what prompts users sent for a tracked topic, which tools and models the agent invoked, or which visitors and accounts are associated with a tracked use case.\n\nEXAMPLES:\n- What are users actually asking in the 'dashboard help' tracked use case?\n- Which tools does my agent use when handling this tracked use case?\n- Who are the visitors in this tracked use case?\n- Show me sample prompts from this tracked use case.\n\nNOT FOR: Aggregate volume metrics across use cases, or issue diagnosis - this tool deep-dives a single tracked use case.\n\nRETURNS:\n- Four labeled CSV sections:\n- [tracked_use_case_summary]: visitorIds, accountIds - one summary row with deduplicated lists.\n- [explanations]: explanation - one row per sampled explanation (capped for MCP size).\n- [tools_used]: toolsUsed, modelsUsed - one summary row with deduplicated lists.\n- [prompt_samples]: content - one row per sampled user prompt message (capped for MCP size).\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"conversationIds\":\"\\u003cconversationIds\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"eventIds\":\"\\u003ceventIds\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"agentAnalyticsTrackedUseCaseAnalysis\",\"subId\":\"\\u003csubId\\u003e\",\"trackedUseCaseId\":\"\\u003ctrackedUseCaseId\\u003e\"}"],"id":"agentAnalyticsTrackedUseCaseAnalysis","inputModes":["application/json"],"name":"agentAnalyticsTrackedUseCaseAnalysis","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get app-level usage metrics over time. Groups events into buckets of the requested period (daily/weekly/monthly) and returns one row per bucket with app-wide totals: active visitors, active accounts, events, average active time (a duration object {seconds, display}), and the four frustration counts (totalErrorClickCount, totalRageClickCount, totalUTurnCount, totalDeadClickCount). The average metric matches the requested period: avgDailyActiveTime, avgWeeklyActiveTime, or avgMonthlyActiveTime. Audience can be scoped via an inline segmentPipeline; scope can also be narrowed to a single app via appId. minEvents restricts every bucket to the visitors with at least that many events in that bucket, applied independently per bucket, so one call tracks an engagement threshold across the whole range. It counts events rather than visits, so it is not a returning-visitor measure.\n\nUSE FOR: Trend questions about whole-app usage over a window - e.g. 'how did active visitors trend over the last 12 weeks?', 'are rage clicks across our apps trending up?'. With minEvents, tracks a per-bucket event threshold over time - e.g. 'visitors with at least 2 events per month'.\n\nEXAMPLES:\n- How did active visitors trend over the last 12 weeks?\n- Total events per week across all apps over the last quarter\n- Are rage clicks across our apps trending up over the last 30 days?\n- How many visitors had at least 2 events in each of the last twelve months?\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- meta.period: echoed bucket size (daily|weekly|monthly)\n- meta.metrics: list of metric names returned per bucket\n- rows: one entry per time period, containing a 'bucket' string (YYYY-MM-DD or YYYY-MM), a startTime (epoch ms), and metric values; numeric metrics zero-fill for empty buckets","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"minEvents\":\"\\u003cminEvents\\u003e\",\"period\":\"\\u003cperiod\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"appUsageTimeSeries\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"appUsageTimeSeries","inputModes":["application/json"],"name":"appUsageTimeSeries","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get per-visitor or per-account app usage metrics for a date range. Returns {summary, rows}: summary has total active visitors/accounts, total events across the selected app scope, average daily time on apps, and totals for the four frustration counts (totalErrorClickCount, totalRageClickCount, totalUTurnCount, totalDeadClickCount); rows are per-visitor or per-account breakdowns with daysActive, totalTime and avgTimePerDay (duration objects {seconds, display}), totalEvents, and the same four frustration totals, sorted and limited. When groupBy=\"account\" each row also includes numVisitors - the count of distinct visitors from that account who were active during the window. Optionally include metadata fields for each returned visitor or account with select. Audience can be scoped via an inline segmentPipeline; scope can also be narrowed to a single app via appId, or to a single product area via productAreaId. When productAreaId is supplied the same summary and rows describe headline usage metrics for that product area, measured over its page, feature, and track-event activity. minEvents restricts every summary total and every row to visitors with at least that many events over the date range, counting events rather than visits - so it identifies heavy users, not returning ones; with groupBy=\"account\" it returns the accounts containing at least one such visitor, and their metrics cover only those visitors' events.\n\nUSE FOR: Per-visitor or per-account app-level usage (events, time, days active) AND top-N ranking over a window across every app, or one app when appId is supplied, or one product area when productAreaId is supplied (headline usage metrics for that area). Also counts visitors above an event threshold over the window via minEvents.\n\nEXAMPLES:\n- Who uses our apps the most in the last 30 days?\n- Top 50 accounts by app usage last quarter\n- Which visitors rage-click the most across our apps last week?\n- Top 20 visitors by total time in app X last month\n- Headline usage metrics for product area X over the last 30 days\n- Top 20 accounts by usage of product area X last quarter\n- Show the top 20 accounts by app usage last quarter with their ARR and company size\n- How many visitors generated at least 10 events last month?\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- summary: totalNumVisitors or totalNumAccounts, totalNumEvents, avgDailyActiveTime (duration object {seconds, display}), totalErrorClickCount, totalRageClickCount, totalUTurnCount, totalDeadClickCount\n- rows: daysActive, totalTime, totalEvents, avgTimePerDay, totalErrorClickCount, totalRageClickCount, totalUTurnCount, totalDeadClickCount per visitor or account; per-account rows also include numVisitors; select adds requested metadata fields","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"groupBy\":\"\\u003cgroupBy\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"minEvents\":\"\\u003cminEvents\\u003e\",\"productAreaId\":\"\\u003cproductAreaId\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"select\":\"\\u003cselect\\u003e\",\"skill\":\"appUsage\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"appUsage","inputModes":["application/json"],"name":"appUsage","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"buildPendoSegment:\n    Purpose: Describe one visitor segment by visitor or account ID, activity on Pages, Features, TrackEvents, Guides, Poll responses, the\n        elements inside a guide, segment membership, or metadata.\n    Input shape: pass definition as an array of rule groups. Top-level groups are ANDed together; rules within\n        a group are ORed together. For one ANDed rule, wrap it in a single-item group.\n\n    SINGLE CALL CONTRACT (important):\n        The ENTIRE segment, including every AND clause and every OR clause, MUST be built with ONE call to this\n        tool. Never split a segment across multiple calls. Combine all clauses into a single definition array and\n        pass it once. Calling the tool more than once produces multiple unrelated segments, NOT one combined\n        segment, so the AND/OR logic between the calls is lost.\n\n        Mapping a request to a single definition:\n            - Split the request into top-level AND clauses.\n            - Each AND clause becomes one group (one inner array) in the definition.\n            - Inside a clause, every OR alternative becomes one rule object in that group.\n            - A clause with no OR is a group containing a single rule object.\n\n        CLAUSE COVERAGE (important):\n            Account for EVERY clause in the request. Before returning, count the AND clauses in the request and\n            confirm the definition has exactly that many top-level groups, then confirm every OR alternative\n            inside each clause is present as a rule object. Never drop, merge, or skip a clause. If the request\n            mentions a page rule, a feature rule, and a track event rule joined by AND/OR, all of them must\n            appear. A request like \"(X OR Y) AND Z\" has 2 top-level groups (one for \"X OR Y\", one for \"Z\") and\n            3 rule objects total; returning fewer groups or rules is wrong.\n\n    Full example (combining AND and OR in one call):\n        Request: \"(visitors who spent \u003e 15 minutes on page A in May OR have NOT seen page B in the last year)\n                  AND triggered track event C on fewer than 5 days in the last 7 days\"\n        Correct single definition (one tool call):\n            [\n                [\n                    { \"entityType\": \"page\", \"entityId\": \"A\", \"metric\": \"eventTime\", \"operator\": \"\u003e\", \"threshold\": 15, \"condition\": \"between\", \"first\": \"2026-05-01\", \"last\": \"2026-05-31\" },\n                    { \"entityType\": \"page\", \"entityId\": \"B\", \"metric\": \"notseen\", \"condition\": \"withinLast\", \"lookbackAmount\": 12, \"granularity\": \"months\" }\n                ],\n                [\n                    { \"entityType\": \"trackEvent\", \"entityId\": \"C\", \"metric\": \"daysActive\", \"operator\": \"\u003c\", \"threshold\": 5, \"condition\": \"withinLast\", \"lookbackAmount\": 7, \"granularity\": \"days\" }\n                ]\n            ]\n        The first group (the two page rules) is ORed together; that group is then ANDed with the second group\n        (the track event rule). This is ONE call, not two.\n\n    REQUIRED FIELDS AND CONDITION CHOICE (important):\n        Activity metrics with non-empty supportedConditions MUST include an explicit \"condition\" field. It is the\n        discriminator that selects which time/frequency fields apply, and it is NOT optional for those metrics.\n        Always choose condition from the chosen metric's supportedConditions.\n        Do NOT rely on the presence of first/last, lookbackAmount/granularity, or date to imply the condition;\n        you must still set condition explicitly for activity metrics. For example:\n            - first + last present        =\u003e you MUST also set condition: \"between\"\n            - lookbackAmount + granularity =\u003e you MUST also set condition: \"withinLast\"\n            - date present                 =\u003e you MUST also set condition: \"since\"\n\n        Segment membership metrics are the exception:\n            - isMemberOfSegment and isNotMemberOfSegment have supportedConditions: [] by design.\n            - For these metrics, omit \"condition\" entirely. Do NOT add \"ever\" or infer any default condition.\n            - supportedConditions: [] means \"no condition field\", not \"choose a default condition\".\n\n\tVisitor and account ID rules are conditionless and metricless:\n\t\t- Use entityType: \"visitor\" or \"account\".\n\t\t- Use operator: one of \"==\", \"!=\", \"contains\", \"!contains\", \"empty\", \"!empty\". Omit it to default to \"==\".\n\t\t- Use entityId for the comparison value with \"==\", \"!=\", \"contains\", and \"!contains\".\n\t\t- Use an empty entityId with \"empty\" and \"!empty\".\n\t\t- Example: { \"entityType\": \"visitor\", \"entityId\": \"bob@example.com\" }.\n\t\t- Example: { \"entityType\": \"visitor\", \"entityId\": \"@example.com\", \"operator\": \"contains\" }.\n\t\t- Example: { \"entityType\": \"account\", \"entityId\": \"acme-corp\" }.\n\n\tMetadata rules are also conditionless and metricless:\n\t\t- Use entityType: \"metadata\".\n\t\t- Use entityId for the full metadata key, e.g. \"visitor.agent.job_role\".\n\t\t- Use operator: one of \"==\", \"!=\", \"\u003e=\", \"\u003c=\", \"contains\", \"!contains\", \"empty\", \"!empty\".\n\t\t- Use value for \"==\", \"!=\", \"\u003e=\", \"\u003c=\", \"contains\", and \"!contains\". Omit value for \"empty\" and \"!empty\".\n\t\t- Time and date metadata values may use ISO 8601, e.g. \"2025-12-31T23:59:59Z\".\n\t\t- Example: { \"entityType\": \"metadata\", \"entityId\": \"visitor.agent.job_role\", \"operator\": \"==\", \"value\": \"Software engineer\" }.\n\n\tEvent-property filters narrow page, feature, or track-event aggregation rules by a property on each event:\n\t\t- Add one eventProperty object with property, operator, and (except for empty/!empty) value.\n\t\t- For a custom event property, use its plain property name. Custom properties are supported on feature and trackEvent rules.\n\t\t- For historical metadata captured on an event, use kind.group.field, e.g. \"visitor.agent.user_job_role\".\n\t\t  Historical metadata is supported on page, feature, and trackEvent rules.\n\t\t- Event properties require an aggregation metric such as eventCount or daysActive; they cannot be added to seen/used counter metrics.\n\t\t- Use listCountables eventPropertyNames to discover custom properties. Historical metadata must currently be promoted.\n\t\t- Example: visitors who ran a report with the \"source\" filter in the last 30 days:\n\t\t  [\n\t\t    [\n\t\t      { \"entityType\": \"trackEvent\", \"entityId\": \"\u003creportRanTrackEventId\u003e\", \"metric\": \"eventCount\", \"operator\": \"\u003e=\", \"threshold\": 1, \"condition\": \"withinLast\", \"lookbackAmount\": 30, \"granularity\": \"days\", \"eventProperty\": { \"property\": \"filter\", \"operator\": \"==\", \"value\": \"source\" } }\n\t\t    ]\n\t\t  ]\n\n\tGuide element rules cover clicks on one button, link or close icon inside a guide:\n\t\t- Use entityType: \"guideElement\".\n\t\t- Use entityId for the GUIDE id, stepId for the step the element sits on, and elementId for the\n\t\t  element's uiElementId, e.g.\n\t\t  { \"entityType\": \"guideElement\", \"entityId\": \"\u003cguideId\u003e\", \"stepId\": \"\u003cguideStepId\u003e\",\n\t\t    \"elementId\": \"pendo-button-a1b2c3d4\", \"metric\": \"eventCount\", \"operator\": \"\u003e=\", \"threshold\": 1,\n\t\t    \"condition\": \"withinLast\", \"lookbackAmount\": 30, \"granularity\": \"days\" }.\n\t\t- One getEntity call gives both ids: steps[].stepId and the\n\t\t  steps[].elements[].uiElementId nested under it. Never guess either.\n\t\t- eventCount is the only supported metric, and it counts clicks on that element in the chosen window:\n\t\t\t- \"clicked it\"       =\u003e operator \"\u003e=\", threshold 1\n\t\t\t- \"did not click it\" =\u003e operator \"==\", threshold 0\n\t\t\t- click counts       =\u003e any operator, e.g. \"clicked it more than 3 times\" is operator \"\u003e\", threshold 3\n\t\t- stepId does not narrow the count.\n\t\t- Only withinLast and between are available, so a click rule is always scoped to a window.\n\n\tPoll response rules select visitors by a numeric poll response:\n\t\t- Use entityType: \"poll\", entityId for the guide id, and pollId for its poll.\n\t\t- Resolve pollId from getEntity's guide steps[].polls[] output; select the poll whose type is the poll type.\n\t\t  Never guess a pollId.\n\t\t- Use metric: \"response\", a numeric operator and threshold, plus a supported condition.\n\t\t- Conditions ever, since (with date), withinLast, and between are supported. A response range requires two separate top-level AND groups, not one OR group. For example, responses from 7 through 10 in the last 30 days:\n\t\t  [\n\t\t    [{ \"entityType\": \"poll\", \"entityId\": \"\u003csurveyGuideId\u003e\", \"pollId\": \"\u003cpollId\u003e\", \"metric\": \"response\", \"operator\": \"\u003e=\", \"threshold\": 7, \"condition\": \"withinLast\", \"lookbackAmount\": 30, \"granularity\": \"days\" }],\n\t\t    [{ \"entityType\": \"poll\", \"entityId\": \"\u003csurveyGuideId\u003e\", \"pollId\": \"\u003cpollId\u003e\", \"metric\": \"response\", \"operator\": \"\u003c=\", \"threshold\": 10, \"condition\": \"withinLast\", \"lookbackAmount\": 30, \"granularity\": \"days\" }]\n\t\t  ]\n\n    Resolution steps\n        1. Choose entityType from EntityTypes.\n\t\t2. For visitor or account, use entityId + optional operator and stop here.\n\t\t3. For metadata, use entityId + operator + optional value and stop here.\n        4. For activity and segment entities, choose metric from EntityTypes[entityType].supportedMetrics.\n        5. Look up Metrics[metric].\n        6. If Metrics[metric].supportedConditions is non-empty, choose condition from that list and look up\n           Conditions[condition].\n        7. The final rule fields are:\n            EntityTypes[entityType].requiredFields\n            + Metrics[metric].requiredFields\n            + Conditions[condition].requiredFields, only when a condition is required.\n\n    Time phrase resolution examples:\n        - \"this year\" / \"so far this year\" / \"year to date\" =\u003e condition: \"since\", date: \"2026-01-01\"\n        - \"this month\" / \"month to date\" =\u003e condition: \"since\", date: \"2026-06-01\"\n        - \"since 2026-01-01\" =\u003e condition: \"since\", date: \"2026-01-01\"\n\t\t- \"last year\" =\u003e condition: \"between\", first: \"2025-01-01\", last: \"2025-12-31\"\n\t\t- \"in the last year\" =\u003e condition: \"withinLast\", lookbackAmount: 12, granularity: \"months\"\n        - \"between 2026-01-01 and 2026-06-05\" =\u003e condition: \"between\", first: \"2026-01-01\", last: \"2026-06-05\"\n        - \"in March\" =\u003e condition: \"between\", first: \"2026-03-01\", last: \"2026-03-31\"\n\t\t- \"last 3 weeks\" =\u003e condition: \"withinLast\", lookbackAmount: 3, granularity: \"weeks\"\n\t\t- \"last 7 days\" =\u003e condition: \"withinLast\", lookbackAmount: 7, granularity: \"days\"\n\n    CONDITION CHOICE FOR TIME PHRASES (important):\n        - Use \"since\" (set only date) for any open-ended period running from a start date up to now:\n          \"this year\", \"this month\", \"year to date\", \"so far\", \"since \u003cdate\u003e\". Do NOT express these as\n          \"between ... today\".\n        - Use \"between\" (set first + last) ONLY for a closed range whose end is a specific past date or the last\n          day of a named calendar period (e.g. \"in March\", \"last year\", \"between X and Y\").\n        - Use \"withinLast\" (set lookbackAmount + granularity) for rolling windows: \"last N days/weeks/months\".\n        - Set ONLY the fields the chosen condition requires. Never combine date with first/last in one rule.\n\n    A segment should be just as valid in a week's time as it is today, so never hardcode today's date as an\n    endpoint. For a fixed/named calendar period (e.g. \"in March\") use \"between\" spanning the entire period even\n    if it has not finished yet. For an open-ended current period (e.g. \"this year\", \"this month\") use \"since\"\n    with the period's start date, which stays valid going forward.\nEntityTypes:\n    visitor:\n        requiredFields:\n            entityType: \"visitor\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    account:\n        requiredFields:\n            entityType: \"account\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    page:\n        requiredFields:\n            entityType: \"page\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"deadClicks\", \"errorClicks\", \"rageClicks\", \"daysActive\", \"uTurns\", \"eventTime\", \"seen\", \"notseen\", \"lastSeen\"]\n\n    feature:\n        requiredFields:\n            entityType: \"feature\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"deadClicks\", \"errorClicks\", \"rageClicks\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\n    trackEvent:\n        requiredFields:\n            entityType: \"trackEvent\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\n    guide:\n        requiredFields:\n            entityType: \"guide\"\n            entityId: String\n        supportedMetrics:\n            [\"seen\", \"lastSeen\", \"notSeen\"]\n\n    poll:\n        requiredFields:\n            entityType: \"poll\"\n            entityId: String\n            pollId: String  // the poll nested under the guide\n        supportedMetrics:\n            [\"response\"]\n\n    guideElement:\n        requiredFields:\n            entityType: \"guideElement\"\n            entityId: String\n            stepId: String     // the guide step the element sits on\n            elementId: String  // the element's uiElementId, e.g. \"pendo-button-a1b2c3d4\"\n        supportedMetrics:\n            [\"eventCount\"]\n\n    segment:\n        requiredFields:\n            entityType: \"segment\"\n            entityId: String\n        supportedMetrics:\n            [\"isMemberOfSegment\", \"isNotMemberOfSegment\"]\n\n    metadata:\n        requiredFields:\n            entityType: \"metadata\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    agent:\n        requiredFields:\n            entityType: \"agent\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\nMetrics:\n    eventCount:\n        description: Number of events for the selected entity.\n        requiredFields:\n            metric: \"eventCount\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    deadClicks:\n        description: Number of dead clicks for the selected page or feature.\n        requiredFields:\n            metric: \"deadClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    errorClicks:\n        description: Number of error clicks for the selected page or feature.\n        requiredFields:\n            metric: \"errorClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    rageClicks:\n        description: Number of rage clicks for the selected page or feature.\n        requiredFields:\n            metric: \"rageClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    daysActive:\n        description: Number of active days for the selected entity.\n        requiredFields:\n            metric: \"daysActive\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    uTurns:\n        description: Number of u-turns for the selected page.\n        requiredFields:\n            metric: \"uTurns\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    eventTime:\n        description: Time in minutes spent on the selected page.\n        requiredFields:\n            metric: \"eventTime\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    response:\n        description: Numeric poll response. Use two ANDed rules for a range.\n        requiredFields:\n            metric: \"response\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"between\"]\n\n    used:\n        description: Whether the selected feature or track event was used, optionally with a frequency threshold.\n        requiredFields:\n            metric: \"used\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"atLeast\", \"atMost\"]\n\n    notused:\n        description: Whether the selected feature or track event was not used.\n        requiredFields:\n            metric: \"notused\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\"]\n\n    lastused:\n        description: When the selected feature or track event was last used.\n        requiredFields:\n            metric: \"lastused\"\n        supportedConditions:\n            [\"since\", \"withinLast\", \"between\"]\n\n    seen:\n        description: Whether the selected page was seen, optionally with a frequency threshold. For checking withinLast\n        requiredFields:\n            metric: \"seen\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"atLeast\", \"atMost\"]\n\n    notseen:\n        description: Whether the selected page was not seen.\n        requiredFields:\n            metric: \"notseen\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\"]\n\n    lastSeen:\n        description: When the selected page was last seen.\n        requiredFields:\n            metric: \"lastSeen\"\n        supportedConditions:\n            [\"since\", \"withinLast\", \"between\"]\n\n    isMemberOfSegment:\n        description: Whether the visitor is a member of the selected segment.\n        requiredFields:\n            metric: \"isMemberOfSegment\"\n        supportedConditions:\n            []\n\n    isNotMemberOfSegment:\n        description: Whether the visitor is not a member of the selected segment.\n        requiredFields:\n            metric: \"isNotMemberOfSegment\"\n        supportedConditions:\n            []\n\nConditions:\n    ever:\n        description: The metric happened at any time.\n        requiredFields:\n            condition: \"ever\"\n\n    since:\n        description: The metric happened on or after a specific date.\n        requiredFields:\n            condition: \"since\"\n            date: DateString(\"yyyy-mm-dd\")\n\n    withinLast:\n        description: The metric happened within a rolling time window.\n        requiredFields:\n            condition: \"withinLast\"\n            lookbackAmount: Integer\n            granularity: Enum[\"days\", \"weeks\", \"months\"]\n\n    between:\n        description: The metric happened within an inclusive date range.\n        requiredFields:\n            condition: \"between\"\n            first: DateString(\"yyyy-mm-dd\")\n            last: DateString(\"yyyy-mm-dd\")\n\n    atLeast:\n        description: The metric happened at least threshold times ever\n        requiredFields:\n            condition: \"atLeast\"\n            threshold: Integer\n\n    atMost:\n        description: The metric happened at most threshold times ever\n        requiredFields:\n            condition: \"atMost\"\n            threshold: Integer\n\n","examples":["{\"definition\":\"\\u003cdefinition\\u003e\",\"skill\":\"buildPendoSegment\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"buildPendoSegment","inputModes":["application/json"],"name":"buildPendoSegment","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Accepts a DOM payload, stores it server-side and returns a domHandle that refers to the provided DOM, handle can be used in other tagging tools.\n\nUSE FOR: Step 1 of the tagging workflow - the only way to provide a DOM for tag suggestions.\n\nWORKFLOW: 1. captureDomForTagging - upload the page's DOM and receive a domHandle. 2. processPageAndFeatureSuggestions - generate suggestions for the captured DOM(s), referencing each capture by its domHandle; returns a sessionId and manifest. 3. getSuggestedFeatureBatch - retrieve the feature suggestions in batches, choosing sections and batch sizes as you see fit.\n\nRETURNS:\n- domHandle - `cap_\u003c32 hex\u003e` reference to the stored DOM.\n- bytes - size of the stored DOM\n- expiresAt - when the capture expires","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"dom\":\"\\u003cdom\\u003e\",\"skill\":\"captureDomForTagging\",\"subId\":\"\\u003csubId\\u003e\",\"url\":\"\\u003curl\\u003e\"}"],"id":"captureDomForTagging","inputModes":["application/json"],"name":"captureDomForTagging","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","enableTagWithLeo"]},{"description":"Applies selected page and feature tag suggestions from a processPageAndFeatureSuggestions session, creating and updating the corresponding Pendo tags. Suggestions are selected per section by (pageUrl, actionType); pass sections exactly as listed in the manifest. Only CREATE and UPDATE take effect - DELETE, MERGE and MATCH are returned as advisory-only and are not applied. A CREATE feature whose page does not exist yet is only applied if that page is included in `pages`; otherwise it is skipped.\n\nUSE FOR: Applying the tag suggestions the user has chosen to accept.\n\nNOT FOR: Generating or fetching suggestions - use processPageAndFeatureSuggestions and getSuggestedFeatureBatch.\n\nWORKFLOW: Step 4 of the tagging workflow, after reviewing suggestions via getSuggestedFeatureBatch: apply the chosen CREATE/UPDATE page and feature suggestions from a processPageAndFeatureSuggestions session.\n\nRETURNS:\n- pages - per-page apply results with status and message\n- features - per-feature apply results with status and message (advisory items included)\n- partialFailure - true when some items succeeded and others failed","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"edits\":\"\\u003cedits\\u003e\",\"pageIdMap\":\"\\u003cpageIdMap\\u003e\",\"pages\":\"\\u003cpages\\u003e\",\"sections\":\"\\u003csections\\u003e\",\"sessionId\":\"\\u003csessionId\\u003e\",\"skill\":\"acceptPageAndFeatureSuggestions\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"acceptPageAndFeatureSuggestions","inputModes":["application/json"],"name":"acceptPageAndFeatureSuggestions","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","enableTagWithLeo","mcpWriteTools","destructive"]},{"description":"Compute a retention curve for an app (scope='app'), a specific page or feature (scope='page' or 'feature'), a track event (scope='trackEvent'), or a whole product area (scope='productArea'). For track events: measures how many accounts/visitors continue firing the event over time. Supports visitor-level or account-level retention (unit) and all vs first cohort modes (cohortMode='all' for all active users, 'first' for first-time users only - best for onboarding effectiveness).\n\nFor scope='productArea', a user counts as active in a period if they used any page, feature, or track event in that area; guides in the area are not counted. Omit appId when the entity or area spans multiple applications - passing one restricts the curve to that application.\n\nCall this tool ONCE per question. A single call returns all periods at once - do NOT call it multiple times with different periodCount values. The analysis window is anchored to now() and works backwards.\n\nDo NOT pre-filter for 'new users in the last N days' via segmentPipeline - pass cohortMode='first' instead, which restricts to users whose all-time first interaction falls within the analysis window (truly new users, not returning users re-entering the window).\n\nPeriod 0 = '\u003c 1 Month' is the % of cohort active more than once in their first period - a real metric, NOT a 100% baseline (typical rates 25-60%). Period N = % of cohort still active N periods later. activeCount at higher periods decreases because users too new to have reached that period are excluded from the denominator (dynamic denominator - correct, not missing data). summary.finalRetentionRate is the most important single number - it represents the durable retained core.\n\nUSE FOR: Retention and churn questions - e.g. 'what % of users return after 3 months?', 'show me our retention curve', 'what's our churn rate?'. Not for acquisition questions ('how many new accounts did we gain?') - this tool measures continued activity of existing cohorts, not new-user counts.\n\nEXAMPLES:\n- What % of users return after 3 months?\n- Show me our retention curve\n- What's our account churn rate over the last 6 months?\n- How often do accounts that created a dashboard keep creating dashboards?\n- How well do we retain first-time users of this feature?\n- What's the retention curve for our Onboarding product area?\n\nRETURNS:\n- scope, entityId, cohortMode, unit, periodType: echoed query parameters\n- retentionCurve: list of {period, periodLabel, activeCount, multiSession, retentionRate} sorted by period\n- summary: {totalCohortSize, avgRetentionRate, finalRetentionRate}","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"cohortMode\":\"\\u003ccohortMode\\u003e\",\"entityId\":\"\\u003centityId\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"offsetDays\":\"\\u003coffsetDays\\u003e\",\"periodCount\":\"\\u003cperiodCount\\u003e\",\"periodType\":\"\\u003cperiodType\\u003e\",\"scope\":\"\\u003cscope\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"cohortRetentionCurve\",\"subId\":\"\\u003csubId\\u003e\",\"unit\":\"\\u003cunit\\u003e\"}"],"id":"cohortRetentionCurve","inputModes":["application/json"],"name":"cohortRetentionCurve","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Lists the Command Center SaaS portfolio - both managed apps and event-discovered (shadow-IT) apps - with each app's cost, estimated cost, license count, owner, renewal date, category, AI/shadow-IT signals, admin notes, itStatus (the app's recorded IT governance status, e.g. sanctioned or restricted, distinct from discovery lifecycle status), active-user count, license usage (percentage plus a noInfo/low/healthy/high/overLimit status), and potential annual savings from unused licenses for the requested date range. Each row carries appType (managed or discovery). notes holds admin-entered notes from Application.About (managed) or DiscoveryApplication.Description (discovered), not manifest descriptions, advise text, or shadow-IT reason fields; notes is null rather than an empty string when a managed app has no About text set. Verified and estimated cost are returned as separate fields and are never blended; an app with no cost is returned with no cost value rather than a fabricated zero. licenseUsage is 0 (status noInfo) rather than a computed percentage when license count is null or zero. A managed app can instead be configured with named license types (e.g. viewer, editor, admin); such an app returns multipleLicenses true and a licenseTypes list whose entries each hold displayName (the type's label), type (the visitor metadata value that assigns an employee to that type - not a category or tier of license), quantity (its seats), and cost (its annual cost, null when no price is recorded), plus licenseMetadataField, the visitor metadata field holding those type values. licenseTypes is configuration only - per-type active users and utilization are not reported yet, so do not infer them. Because these apps hold their seats per type rather than app-wide, they report no app-level licenseCount, licenseUsage, usageStatus, or potentialSavings - those are null or absent, never 0 - so read seats from licenseTypes and treat app-wide utilization as unavailable rather than as zero or unused. potentialSavings is a possible license-reclamation opportunity for the window - not a realized, forecasted, or currently-attributed saving - and is omitted unless usage is 60% or lower, an annual cost is available, and license count is positive. Discovered apps are event-gated: only those with activity in the window appear. The summary also reports averageCostPerEmployee: total annual cost across all rows divided by the portfolio-wide distinct active-employee count (an employee using multiple apps is counted once, not once per app), 0 when there are no active employees, and omitted when it could not be computed for the window. An optional segment scopes only the visitor-derived numbers: activeUsers per app and the averageCostPerEmployee denominator. Cost, licenseCount, owner, renewalDate, itStatus and the licenseTypes configuration are subscription-wide and are never segment-scoped, so with a segment applied licenseUsage, usageStatus and potentialSavings compare that segment's users against the app's full seat count - report them as usage within the segment, never as portfolio-wide utilization or reclaimable spend. A segment also narrows which discovered apps appear, since those are event-gated, while every managed app is still returned and reports activeUsers 0 when no one in the segment used it - that 0 means \"unused by this segment\", not \"unused\".\n\nUSE FOR: Listing the managed and discovered SaaS portfolio and reading per-app cost, license count, owner, renewal date, category, AI/shadow-IT flags, notes, active users, license usage status, potential license-reclamation savings, which license types an app is configured with and their seats and cost, and the portfolio's average annual cost per employee for a date range, optionally scoping the active-user numbers to a segment such as a department, region, or business unit.\n\nEXAMPLES:\n- List our SaaS apps (managed and discovered) with their cost and active users.\n- Which shadow-IT apps are employees using this month?\n- How many active users did each app have last month?\n- Which apps have no verified cost?\n- Who owns each managed app?\n- What's the average annual SaaS cost per employee?\n- What license types is Figma configured with, and how many seats does each have?\n- Which apps have more than one license type?\n- How many people in the Engineering segment used each SaaS app last month?\n\nNOT FOR: Cost-per-active-user rankings across apps, usage-frequency bands or adoption time-series, how many employees are on each license type or how well a single license type is utilized, and AI-agent conversation issue rates (use the Agent Analytics tools).","examples":["{\"dateRange\":\"\\u003cdateRange\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"commandCenterApps\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"commandCenterApps","inputModes":["application/json"],"name":"commandCenterApps","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","commandCenterMcp","read-only"]},{"description":"Updates the editable Command Center fields on a single managed or discovered app: annual cost and license count, renewal date, full-replacement notes, a shadow-IT override, and IT governance status. Before calling this tool, repeat back to the user the app, the field(s) you will change, and their current values, and get confirmation that nothing else will change - this write applies immediately. For renewal date, the confirmation must state whether the date is being added, replaced, or cleared. commandCenterApps returns renewalDate as epoch milliseconds; convert it to YYYY-MM-DD before presenting the confirmation or calling this tool. For shadowIt, the confirmation must state that this overrides the risk level shown for the app (catalogue-derived for discovered apps, or the stored classification for managed apps), not just that the value is changing. The write executes as the calling user and requires Command Center subscription-admin permission; setting cost marks it verified. An app with no cost, license count, renewal date, or shadow-IT override yet can still be set, so a current value of null is not a reason to refuse. An app with no IT status set is treated as \"new\", matching what commandCenterApps and the Command Center UI show for it.\n\nUSE FOR: Correcting an app's annual cost (marking it verified), updating its license count, replacing an app's notes, changing its renewal date, overriding an app's shadow-IT risk level, or setting its IT governance status - one app per call, after confirming the change with the user.\n\nEXAMPLES:\n- Set this shadow-IT app's annual cost to 24000 and mark it verified.\n- Update the license count for that discovered app to 50.\n- We pay 12000 a year for that managed app - record it.\n- Replace this managed app's notes with the updated procurement discussion.\n- Set this discovered app's renewal date to 2027-03-15.\n- Clear the renewal date on this managed app.\n- Override this discovered app's shadow-IT risk to Low.\n- Override this managed app's shadow-IT risk to Medium.\n- Mark this managed app as sanctioned.\n- Mark this discovered app as restricted.\n- Mark these five discovered apps as restricted.\n- Update the annual cost for each app in this list.\n\nNOT FOR: Changing owner, category, labels, or group; lifecycle (manage/unmanage/promote); or URL match patterns.\n\nWORKFLOW: A request covering several apps is served by calling this tool once per app - that is the supported path, and a set may freely mix managed and discovered apps. (1) Read current values with a SINGLE commandCenterApps call for the whole set, using a limit large enough to cover it (up to 4000) and a date range wide enough to surface discovered apps, which are event-gated and appear only when they had activity in the window; do not call the read once per app. Convert its epoch-millis renewalDate to YYYY-MM-DD. (2) Take each app's appType from that read, or from a list the user supplied; never infer it from the shape of the appId and never default it, since a managed id sent as discovery - or the reverse - fails. (3) Get the user's approval ONCE, before the first write, and wait for it: state how many apps are affected, the field(s) changing, and their current values - list every app for a small set, or a representative sample plus the total for a large one - and call out any app whose current values the read could not resolve. That one approval authorizes every write in the run, however many turns it takes, and replaces the per-app confirmation described above: once you have it, do not ask for approval again - not per app, not per batch, and not to settle how to proceed. (4) Then call this tool once per app. Stop at the first error and report which apps were already updated, because each call commits on its own and earlier writes are not rolled back. (5) Apply at most 45 apps per turn - that is as many single-app write calls as reliably fit before hitting the model's own per-turn processing limit. A set of 45 or fewer is just the whole run; do not turn its size back into a question for the user, since the confirmation in (3) already covers it. For a larger set, state the total up front, work through the first 45 in order, then stop - do not wait for a processing-limit cutoff to stop you. (6) After every batch of up to 45, report which apps were applied, failed, or skipped, and which app to resume from next; continue on a following turn without re-confirming until the whole set is done.\n\nRETURNS:\n- status: updated when the change was applied.\n- changes: each changed field with its priorValue and newValue; a null priorValue means cost, license count, renewal date, or shadowIt was never configured, while notes use an empty string when unset or cleared. Renewal dates use YYYY-MM-DD and a cleared newValue is null. commandCenterItStatus is the exception: its priorValue is \"new\" rather than null when never configured, matching the Command Center UI's display fallback.\n- appId: the app that was updated.","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"appType\":\"\\u003cappType\\u003e\",\"commandCenterItStatus\":\"\\u003ccommandCenterItStatus\\u003e\",\"cost\":\"\\u003ccost\\u003e\",\"licenseCount\":\"\\u003clicenseCount\\u003e\",\"notes\":\"\\u003cnotes\\u003e\",\"renewalDate\":\"\\u003crenewalDate\\u003e\",\"shadowIt\":\"\\u003cshadowIt\\u003e\",\"skill\":\"updateCommandCenterApp\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"updateCommandCenterApp","inputModes":["application/json"],"name":"updateCommandCenterApp","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","commandCenterMcp"]},{"description":"Creates a new feedback item in this subscription's qualitative customer feedback system. Returns the ID of the created feedback item. Before calling this tool, you should list product areas, and assign the feedback to the appropriate product area. Then, before submitting the feedback, repeat all non-empty fields back to the user for confirmation, resolving IDs to human-readable names.\n\nUSE FOR: When the user explicitly asks you to submit product feedback, feature requests, bug reports, etc. on behalf of a customer to the qualitative customer feedback system\n\nEXAMPLES:\n- Create feedback for this: [paste text]\n- Log a feature request for dark mode support\n- Submit feedback that the export CSV button is confusing\n- Capture this bug report about broken pagination\n- Record this customer's request for a Slack integration\n\nRETURNS:\n- ID of the created feedback item","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"description\":\"\\u003cdescription\\u003e\",\"productAreaId\":\"\\u003cproductAreaId\\u003e\",\"skill\":\"createFeedbackItem\",\"sourceUrl\":\"\\u003csourceUrl\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"title\":\"\\u003ctitle\\u003e\",\"visitorId\":\"\\u003cvisitorId\\u003e\"}"],"id":"createFeedbackItem","inputModes":["application/json"],"name":"createFeedbackItem","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools"]},{"description":"Creates a new Pendo visitor segment and returns its id. Confirm the segment name and the human-readable summary of every AND/OR clause with the user before submitting. Pendo does not enforce unique segment names - if the user cares about uniqueness, check existing segments first.\n\nUSE FOR: Only call this when the user wants a persistent segment saved to Pendo. Do not call this to preview a segment or to scope a one-off analytics query.\n\nEXAMPLES:\n- Create a segment named \"Power users\" for visitors active in the last 30 days.\n- Save this as a segment called \"Trial churn risk\".\n\nRETURNS:\n- id: the created segment's id. Can be used as a segmentId in downstream tools (segment-membership rules, list filters, etc.).\n- summary: plain-English description of the persisted segment rules with entity names resolved. Reflects what was actually stored after compile-time normalization (e.g. strict \u003e operators become \u003e= with adjusted thresholds).\n\nEntityTypes:\n    visitor:\n        requiredFields:\n            entityType: \"visitor\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    account:\n        requiredFields:\n            entityType: \"account\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    page:\n        requiredFields:\n            entityType: \"page\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"deadClicks\", \"errorClicks\", \"rageClicks\", \"daysActive\", \"uTurns\", \"eventTime\", \"seen\", \"notseen\", \"lastSeen\"]\n\n    feature:\n        requiredFields:\n            entityType: \"feature\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"deadClicks\", \"errorClicks\", \"rageClicks\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\n    trackEvent:\n        requiredFields:\n            entityType: \"trackEvent\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\n    guide:\n        requiredFields:\n            entityType: \"guide\"\n            entityId: String\n        supportedMetrics:\n            [\"seen\", \"lastSeen\", \"notSeen\"]\n\n    poll:\n        requiredFields:\n            entityType: \"poll\"\n            entityId: String\n            pollId: String  // the poll nested under the guide\n        supportedMetrics:\n            [\"response\"]\n\n    guideElement:\n        requiredFields:\n            entityType: \"guideElement\"\n            entityId: String\n            stepId: String     // the guide step the element sits on\n            elementId: String  // the element's uiElementId, e.g. \"pendo-button-a1b2c3d4\"\n        supportedMetrics:\n            [\"eventCount\"]\n\n    segment:\n        requiredFields:\n            entityType: \"segment\"\n            entityId: String\n        supportedMetrics:\n            [\"isMemberOfSegment\", \"isNotMemberOfSegment\"]\n\n    metadata:\n        requiredFields:\n            entityType: \"metadata\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    agent:\n        requiredFields:\n            entityType: \"agent\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\nMetrics:\n    eventCount:\n        description: Number of events for the selected entity.\n        requiredFields:\n            metric: \"eventCount\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    deadClicks:\n        description: Number of dead clicks for the selected page or feature.\n        requiredFields:\n            metric: \"deadClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    errorClicks:\n        description: Number of error clicks for the selected page or feature.\n        requiredFields:\n            metric: \"errorClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    rageClicks:\n        description: Number of rage clicks for the selected page or feature.\n        requiredFields:\n            metric: \"rageClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    daysActive:\n        description: Number of active days for the selected entity.\n        requiredFields:\n            metric: \"daysActive\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    uTurns:\n        description: Number of u-turns for the selected page.\n        requiredFields:\n            metric: \"uTurns\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    eventTime:\n        description: Time in minutes spent on the selected page.\n        requiredFields:\n            metric: \"eventTime\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    response:\n        description: Numeric poll response. Use two ANDed rules for a range.\n        requiredFields:\n            metric: \"response\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"between\"]\n\n    used:\n        description: Whether the selected feature or track event was used, optionally with a frequency threshold.\n        requiredFields:\n            metric: \"used\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"atLeast\", \"atMost\"]\n\n    notused:\n        description: Whether the selected feature or track event was not used.\n        requiredFields:\n            metric: \"notused\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\"]\n\n    lastused:\n        description: When the selected feature or track event was last used.\n        requiredFields:\n            metric: \"lastused\"\n        supportedConditions:\n            [\"since\", \"withinLast\", \"between\"]\n\n    seen:\n        description: Whether the selected page was seen, optionally with a frequency threshold. For checking withinLast\n        requiredFields:\n            metric: \"seen\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"atLeast\", \"atMost\"]\n\n    notseen:\n        description: Whether the selected page was not seen.\n        requiredFields:\n            metric: \"notseen\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\"]\n\n    lastSeen:\n        description: When the selected page was last seen.\n        requiredFields:\n            metric: \"lastSeen\"\n        supportedConditions:\n            [\"since\", \"withinLast\", \"between\"]\n\n    isMemberOfSegment:\n        description: Whether the visitor is a member of the selected segment.\n        requiredFields:\n            metric: \"isMemberOfSegment\"\n        supportedConditions:\n            []\n\n    isNotMemberOfSegment:\n        description: Whether the visitor is not a member of the selected segment.\n        requiredFields:\n            metric: \"isNotMemberOfSegment\"\n        supportedConditions:\n            []\n\nConditions:\n    ever:\n        description: The metric happened at any time.\n        requiredFields:\n            condition: \"ever\"\n\n    since:\n        description: The metric happened on or after a specific date.\n        requiredFields:\n            condition: \"since\"\n            date: DateString(\"yyyy-mm-dd\")\n\n    withinLast:\n        description: The metric happened within a rolling time window.\n        requiredFields:\n            condition: \"withinLast\"\n            lookbackAmount: Integer\n            granularity: Enum[\"days\", \"weeks\", \"months\"]\n\n    between:\n        description: The metric happened within an inclusive date range.\n        requiredFields:\n            condition: \"between\"\n            first: DateString(\"yyyy-mm-dd\")\n            last: DateString(\"yyyy-mm-dd\")\n\n    atLeast:\n        description: The metric happened at least threshold times ever\n        requiredFields:\n            condition: \"atLeast\"\n            threshold: Integer\n\n    atMost:\n        description: The metric happened at most threshold times ever\n        requiredFields:\n            condition: \"atMost\"\n            threshold: Integer\n\n","examples":["{\"definition\":\"\\u003cdefinition\\u003e\",\"description\":\"\\u003cdescription\\u003e\",\"name\":\"\\u003cname\\u003e\",\"shared\":\"\\u003cshared\\u003e\",\"skill\":\"createSegment\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"createSegment","inputModes":["application/json"],"name":"createSegment","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools"]},{"description":"Creates a new draft Pendo guide from raw HTML content. Each entry in rawHtmls becomes one step in the guide. Returns the guide ID and a direct URL to edit the guide in Pendo.\n\nUSE FOR: When the user has generated HTML guide content (e.g. from the pendo-guide-creator skill) and wants to create a real Pendo guide from it\n\nEXAMPLES:\n- Create a guide from this HTML\n- Send this guide to Pendo\n- Publish these HTML files as a Pendo guide\n- Turn my generated guide steps into a real Pendo guide\n\nNOT FOR: Listing, searching, or querying existing guides - use listGuides or searchEntities instead\n\nRETURNS:\n- Guide ID of the newly created draft guide\n- Direct URL to the guide in the Pendo UI","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"guideName\":\"\\u003cguideName\\u003e\",\"layoutType\":\"\\u003clayoutType\\u003e\",\"rawHtmls\":\"\\u003crawHtmls\\u003e\",\"skill\":\"createGuideFromHtml\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"createGuideFromHtml","inputModes":["application/json"],"name":"createGuideFromHtml","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools"]},{"description":"Creates a new product idea - a product enhancement or new feature request - for this subscription, and returns the ID of the created idea. Every idea must be associated with at least one application; if the user hasn't said which, resolve the correct appId(s) first. Optionally assign the idea to one or more product areas by their IDs. Before submitting the idea, repeat all non-empty fields back to the user for confirmation, resolving IDs to human-readable names.\n\nUSE FOR: When the user explicitly asks you to log a product idea or feature concept into the ideas backlog\n\nEXAMPLES:\n- Create an idea for this: [paste text]\n- Log a product idea for a dark mode theme\n- Add an idea to support CSV exports on the reports page\n- Capture this idea about a bulk-edit workflow\n\nRETURNS:\n- ID of the created idea","examples":["{\"appIds\":\"\\u003cappIds\\u003e\",\"description\":\"\\u003cdescription\\u003e\",\"effort\":\"\\u003ceffort\\u003e\",\"impact\":\"\\u003cimpact\\u003e\",\"productAreaIds\":\"\\u003cproductAreaIds\\u003e\",\"skill\":\"createIdeaItem\",\"subId\":\"\\u003csubId\\u003e\",\"title\":\"\\u003ctitle\\u003e\"}"],"id":"createIdeaItem","inputModes":["application/json"],"name":"createIdeaItem","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools"]},{"description":"Fetch raw devlog events for a visitor or session, including HTTP request/response details, log levels, messages, and stack traces. Supports cross-tab replays via recordingSessionIds (array) to fetch devlogs across multiple browser tabs. Accepts a clipId or the individual fields (recordingSessionId, appId, visitorId, accountId, startTime, endTime) that identify a recording. When clipId is provided, the tool looks up the clip to resolve visitorId, accountId, appId, recordingSessionId, and time range automatically. If the user provides a session replay URL, parse the recordingSessionId from the URL path and query parameters (startTime, endTime, visitorId, accountId, appId) before calling this tool; for cross-tab replays, also parse the comma-separated crossTabSessions query parameter and pass the path ID plus those values in recordingSessionIds.\n\nUSE FOR: Investigating developer console logs, network errors, or HTTP activity captured during a session replay. Use when the user provides a session replay URL (parse the URL yourself to extract params), a clip ID, or when the recordingSessionId, appId, visitorId, accountId, and time range for a session are already known. For cross-tab replays, pass the path recordingSessionId plus the comma-separated crossTabSessions query-param values as recordingSessionIds to fetch devlogs across all tabs in a single call.\n\nEXAMPLES:\n- Show me devlogs for this session replay: https://\u003chostname\u003e/s/123/replay/player/abc\n- Show network requests captured in clip https://\u003chostname\u003e/s/123/replay/clip/saved/xyz\n- What HTTP errors occurred during visitor john's session?\n- Fetch devlogs for clip ID abc-123\n- Find devlog errors for account acme-corp\n- What API calls did this visitor make during their session?\n\nNOT FOR: Listing or discovering session replays. General page/feature/track-event analytics unrelated to a specific session recording.\n\nRETURNS:\n- Devlog events including subType (console/network), log level, message, stack trace, HTTP method, request URL, status code, request/response headers and bodies, recordingSessionId, and recordingId for cross-tab attribution. Limited to 100 events.\n\nThe maximum time range for this tool is 31 days.","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"clipId\":\"\\u003cclipId\\u003e\",\"endTime\":\"\\u003cendTime\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"logLevels\":\"\\u003clogLevels\\u003e\",\"logType\":\"\\u003clogType\\u003e\",\"recordingSessionId\":\"\\u003crecordingSessionId\\u003e\",\"recordingSessionIds\":\"\\u003crecordingSessionIds\\u003e\",\"skill\":\"devlogEvents\",\"startTime\":\"\\u003cstartTime\\u003e\",\"statusCodes\":\"\\u003cstatusCodes\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"visitorId\":\"\\u003cvisitorId\\u003e\"}"],"id":"devlogEvents","inputModes":["application/json"],"name":"devlogEvents","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get usage of a page, feature, or track event over time. Groups events into buckets of the requested period (daily/weekly/monthly) and returns one row per bucket with all available metrics. Pages get the full set (visitors, accounts, events, timeOnEntity, averageTimeOnEntityPerVisitor (duration object {seconds, display}), errorClickCount, rageClickCount, uTurnCount, deadClickCount). Features drop the time-derived metrics and uTurnCount. Track events drop all click-level frustration counts. minEvents restricts every bucket to the visitors with at least that many events on the entity in that bucket, applied independently per bucket. For a specific entity, the query can filter or group by custom event properties or event-time historical metadata. For whole-app usage over time (not a specific entity), use the appUsageTimeSeries tool instead.\n\nUSE FOR: Trend questions over a window - e.g. 'how did feature X usage change over the last 12 weeks?', 'are rage clicks on page X trending up?'. With minEvents, tracks a per-bucket event threshold over time - e.g. 'visitors using feature X at least twice a month'.\n\nEXAMPLES:\n- How did feature X usage change over the last 12 weeks?\n- Are rage clicks on page X trending up over the last 30 days?\n- How did visitor counts trend for this account last month?\n- Total page views per week across all pages over the last quarter\n- How many visitors used feature X at least twice in each of the last six months?\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- meta.period: echoed bucket size (daily|weekly|monthly)\n- meta.metrics: list of metric names returned per bucket\n- rows: one entry per time bucket with bucket (YYYY-MM-DD or YYYY-MM), startTime (timestamp object {iso, display}), and metric values; numeric metrics zero-fill and averageTimeOnEntityPerVisitor (duration object {seconds, display}) defaults to 0s for empty buckets\n- property-grouped rows contain propertyValues, with one stable range-ranked group set zero-filled across every bucket\n- sumEventProperty optionally adds a numeric event-property total per bucket and property group, zero-filled for empty buckets","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"entityId\":\"\\u003centityId\\u003e\",\"entityType\":\"\\u003centityType\\u003e\",\"groupByProperties\":\"\\u003cgroupByProperties\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"minEvents\":\"\\u003cminEvents\\u003e\",\"period\":\"\\u003cperiod\\u003e\",\"propertyFilters\":\"\\u003cpropertyFilters\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"entityUsageTimeSeries\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"sumEventProperty\":\"\\u003csumEventProperty\\u003e\"}"],"id":"entityUsageTimeSeries","inputModes":["application/json"],"name":"entityUsageTimeSeries","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get usage analytics for one known page, feature, or track event ID over a date range, including page views, feature clicks, event counts, and unique visitor ('people') and account counts. Returns {summary, rows}: summary has total events, unique visitors, unique accounts (and for pages/features, frustration counts; pages also include uTurnCount); rows are per-visitor or per-account breakdowns with events, time on entity, and days active, sorted and limited. Optionally filter or group by custom event properties, event-time historic metadata, or current visitor/account metadata. Optionally include metadata fields for each returned visitor or account with select. Audience can be scoped via visitorIds OR an inline segmentPipeline (mutually exclusive), and/or filtered to a single accountId.\n\nUSE FOR: Scalar 'how many people viewed/clicked/used it' totals and top-N visitor or account questions over a window for one known page, feature, or track event ID.\n\nEXAMPLES:\n- How many page views did page X get last month?\n- Top 20 visitors by time on page X in the last 30 days\n- Top 50 accounts by usage of feature Y last quarter\n- How many rage clicks did feature Y have last week?\n- Show the top 20 visitors by time on page X last month with their email and role\n\nNOT FOR: Looking up an entity ID from its name, or ranking multiple entities against each other.\n\nWORKFLOW: When the user names a page, feature, or track event but does not provide its ID, call listCountables to resolve the name to an ID, then call entityUsage with that ID. Do not substitute aggregateEntityUsage for this lookup: its limited ranking may omit the named entity.\n\nRETURNS:\n- summary: totalNumEvents, totalNumVisitors, totalNumAccounts (pages/features also: totalErrorClickCount, totalRageClickCount, totalDeadClickCount; pages also: totalUTurnCount)\n- rows: events, timeOnEntityInMinutes, daysActive per visitor or account (pages/features also: errorClickCount, rageClickCount, deadClickCount; pages also: uTurnCount); per-account rows also include numVisitors; select adds requested metadata fields\n- property-grouped rows include propertyValues plus events, visitors, and accounts\n- sumEventProperty optionally adds the numeric event-property total to summary and every row, independent of the row limit for summary","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"entityId\":\"\\u003centityId\\u003e\",\"entityType\":\"\\u003centityType\\u003e\",\"groupBy\":\"\\u003cgroupBy\\u003e\",\"groupByProperties\":\"\\u003cgroupByProperties\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"propertyFilters\":\"\\u003cpropertyFilters\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"select\":\"\\u003cselect\\u003e\",\"skill\":\"entityUsage\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"sumEventProperty\":\"\\u003csumEventProperty\\u003e\",\"visitorIds\":\"\\u003cvisitorIds\\u003e\"}"],"id":"entityUsage","inputModes":["application/json"],"name":"entityUsage","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Generates AI-clustered topics from customer feedback matching the given filters. Each topic contains a name, description, and count of related insights. Use this for high-level overviews of the most common themes in a feedback subset.","examples":["{\"filters\":\"\\u003cfilters\\u003e\",\"skill\":\"generateFeedbackTopics\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"generateFeedbackTopics","inputModes":["application/json"],"name":"generateFeedbackTopics","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","enableListenAIInsights","read-only"]},{"description":"Returns the configuration for a given AI agent: its name, description (a human-authored summary of the agent's role and purpose, not its LLM system prompt), model preset, type, and the tool names and descriptions it has used in the specified date range. The agent config section comes from the stored agent record. The tools section is derived from runtime events in the date range and may be empty if the agent had no activity.\n\nUSE FOR: Fetching the static configuration and runtime tool inventory of an AI agent. Use before analyzing issues or generating fix briefs to understand what the agent is configured to do and which tools it calls.\n\nEXAMPLES:\n- What is my agent's configured role and purpose?\n- Which tools does my agent have access to?\n- What model does agent X use?\n- Show me the full config for this agent before I debug it\n\nNOT FOR: The agent's actual LLM system prompt - this tool does not have access to that. Aggregated usage metrics, issue clusters, or conversation analysis - use the agent analytics tools for those.\n\nRETURNS:\n- Two labeled CSV sections:\n- [agent_config]: name, description (human-authored role/purpose summary, not the LLM system prompt), preset (model), type - one row.\n- [tools]: toolName, toolDescription - one row per tool seen in the date range; empty section if no activity found.\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"skill\":\"getAgentConfig\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getAgentConfig","inputModes":["application/json"],"name":"getAgentConfig","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Fetches a grounding document that describes the current contents of a Pendo product resource so the LLM can reason about it. Today the only supported resource is a Pendo Space - a collaborative canvas of product artifacts (pages, features, guides, notes, etc.) curated by a team. Pass `resourceType` (e.g. \"space\") and `resourceId` (the id of that resource, e.g. a space id) to retrieve the document. Call `listSpaces` first if you need to discover a space id. The response is JSON returned by the Spaces service and typically contains a markdown `body` plus a `schema` describing the resource's contents; do not assume a shape beyond what the response declares. Use `frameId` to scope a space's context to a single frame on the canvas (and items whose parent is that frame) - useful when the user's UI is focused on that frame; omit `frameId` for the full space.","examples":["{\"frameId\":\"\\u003cframeId\\u003e\",\"resourceId\":\"\\u003cresourceId\\u003e\",\"resourceType\":\"\\u003cresourceType\\u003e\",\"skill\":\"getAgentContext\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getAgentContext","inputModes":["application/json"],"name":"getAgentContext","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get the configuration details of one page, feature, track event, or guide by ID. Does not include any usage or metrics.\n\nUSE FOR: Understanding an entity before querying or acting on it. The name of any entity, reading a page's URL rules, the element a feature targets and the page it sits on, or a countable's event properties.For a guide, get its steps in order, each with its step ID and the interactive elements on it.\n\nEXAMPLES:\n- What is the page with ID abc123 and what URLs does it match?\n- Which element does feature xyz789 target, and what page is it on?\n- What event properties can I break down track event def456 by?\n- What are the step IDs and element IDs for guide ghi789?\n- Which buttons are on the second step of this guide and what do they do?\n\nNOT FOR: Usage, metrics or counts of any kind. Searching for an entity when you don't know its ID.\n\nRETURNS:\n- id, type, name, description, appIds, createdAt, lastUpdatedAt for every entity type.\n- eventPropertyNames: names of event properties attached to pages, features and track events.\n- page: rules and excludeRules (the URL rules that define the page).\n- feature: elementPathRules (CSS selector rules identifying the tagged element), and the pageId and pageName it is scoped to.\n- trackEvent: trackTypeRules (the event names that count towards it).\n- guide: state, launchMethod, and steps in the order they appear. Each step has id, name, and the pageId and elementPathRule it attaches to when it targets one.\n- guide steps[].polls: id, question and type ('PickList', 'NumberScale', 'FreeForm', 'NPSPoll', ...) per poll. For the answers given, use guidePollResponses.\n- guide steps[].elements: the buttons, close buttons and links on the step, each with uiElementId, text and actions ('Next Step', 'Dismiss Guide', 'External URL', 'Go to Step (2)', ...).","examples":["{\"entityId\":\"\\u003centityId\\u003e\",\"entityType\":\"\\u003centityType\\u003e\",\"skill\":\"getEntity\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getEntity","inputModes":["application/json"],"name":"getEntity","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Retrieves key customer feedback insights extracted from raw feedback matching the given filters. Each item includes a summary, explanation, and supporting quote. Use this when the user wants to see actionable feedback insights which have been distilled from the raw customer feedback. Note: insights can also be referred to as 'highlights'","examples":["{\"filters\":\"\\u003cfilters\\u003e\",\"skill\":\"getFeedbackInsights\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getFeedbackInsights","inputModes":["application/json"],"name":"getFeedbackInsights","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","enableListenAIInsights","read-only"]},{"description":"\n\tChanges the state/status of a guide (public, staged, draft, disabled, archived).\n\n\tSetting a guide to 'public' makes it live to end users.\n\tSetting a guide to 'archived' hides it from the guide list and is not shown to end users.\n\tBefore calling this tool, always tell the user the guide's name and the exact state change (current -\u003e target) and get explicit confirmation.\n\t\n\nUSE FOR: When the user explicitly asks to publish, unpublish, disable, stage, draft, or set the state of a specific guide.\n\nEXAMPLES:\n- Publish the xxx guide\n- Disable guide xxx\n- Set this guide back to draft\n\nRETURNS:\n- A confirmation of the guide and its new state, or an error describing why the change was rejected.","examples":["{\"guideId\":\"\\u003cguideId\\u003e\",\"skill\":\"setGuideState\",\"state\":\"\\u003cstate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"setGuideState","inputModes":["application/json"],"name":"setGuideState","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","destructive"]},{"description":"\n\tChanges the segment (audience) a guide is targeted to.\n\n\tAssigning a segment restricts the guide to visitors in that segment; leaving the segment empty targets all visitors.\n\tBefore calling this tool, always tell the user the guide's name and the exact segment change (current -\u003e target) and get explicit confirmation.\n\t\n\nUSE FOR: When the user explicitly asks to assign, change, or clear the segment/audience of a specific guide.\n\nEXAMPLES:\n- Target the xxx guide to the yyy segment\n- Change guide xxx to segment yyy\n- Show this guide to everyone\n\nRETURNS:\n- A confirmation of the guide and its new segment, or an error describing why the change was rejected.","examples":["{\"guideId\":\"\\u003cguideId\\u003e\",\"segmentId\":\"\\u003csegmentId\\u003e\",\"skill\":\"setGuideSegment\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"setGuideSegment","inputModes":["application/json"],"name":"setGuideSegment","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","destructive"]},{"description":"Retrieves the original, raw customer feedback matching the given filters. Each item includes id, title, description, status, and info about the account and visitor which gave the feedback. status is an object with id, name, and color fields. account is an object with id and name. visitor information is available via the createdBy and onBehalfOf objects. Each item also includes: assignee (email of the assigned user); labels, apps, and productAreas (each a list of {id, name} objects); productAreas identify the product areas the feedback is tagged to; lastUpdatedAt (epoch milliseconds, same format as createdAt); linkedIdeas (a list of the ids of ideas the feedback is linked to); importance ('Must Have', 'Nice to Have', or 'Not Interested'); and source (where the feedback originated, e.g. Portal, Salesforce, NPS). Use this when the user wants the full raw feedback, as opposed to the extracted insights or clustered topics. A maximum of 30 items will be returned, however there may be more matching the filter set.","examples":["{\"filters\":\"\\u003cfilters\\u003e\",\"skill\":\"getFeedbackItems\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getFeedbackItems","inputModes":["application/json"],"name":"getFeedbackItems","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","enableListenAIInsights","read-only"]},{"description":"Retrieves product ideas submitted by internal product employees which describe product enhancements and new features matching the given filters. Each item includes: id, title, description, createdAt, status, effort, impact, voteCount, accountVoteCount, and votes. Each item also includes: assignee (email of the assigned user); labels, apps, and productAreas (each a list of {id, name} objects); lastUpdatedAt (epoch milliseconds, same format as createdAt); and linkedFeedbackItems (list of feedback item IDs linked to this idea). status is an object with id, name, and color fields. voteCount is the number of positive votes cast for the idea ('Must Have' and 'Nice to Have') - use this as the primary signal of demand when ranking or comparing ideas. accountVoteCount is the number of unique accounts that cast positive votes - use this to indicate breadth of interest across customers; when accountVoteCount is much lower than voteCount, it means a small number of accounts voted multiple times. 'Not Interested' votes are excluded from voteCount, accountVoteCount, and the votes list by default. Pass includeNotInterestedVotes=true when the user asks to see 'Not Interested' votes or wants all vote counts including 'Not Interested'. Each vote includes: importance ('Must Have' or 'Nice to Have'; 'Not Interested' when includeNotInterestedVotes is true); voterId (the ID of the person who cast the vote); voterType ('Visitor' in most cases, 'User' for internal users - only mention this to the user when the value is 'User'); accountId (the account associated with the vote). A maximum of 30 items will be returned, however there may be more matching the filter set.","examples":["{\"filters\":\"\\u003cfilters\\u003e\",\"includeNotInterestedVotes\":\"\\u003cincludeNotInterestedVotes\\u003e\",\"skill\":\"getIdeas\",\"subId\":\"\\u003csubId\\u003e\",\"votesLimit\":\"\\u003cvotesLimit\\u003e\"}"],"id":"getIdeas","inputModes":["application/json"],"name":"getIdeas","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Returns a single Pendo visitor segment by ID, including its name, definition in LLM-friendly DSL form, and optionally the guides, Orchestrate journeys, reports, compound segments, and session-replay apps that reference it.\n\nUSE FOR: Inspect or read a saved segment's rules. Use when you need the current definition before modifying it, or when you need to know where a segment is in use.\n\nEXAMPLES:\n- Show me the definition of segment abc123.\n- What guides are using segment xyz789?\n\nRETURNS:\n- id: the segment ID.\n- name: human-readable segment name.\n- description: optional segment description (omitted if empty).\n- shared: whether the segment is publicly shared.\n- summary: plain-English description of the segment rules with entity names resolved.\n- definition: the segment rules in DSL form - same format accepted by create and update Segment tools. Omitted for segments authored outside the agent workflow that use features the DSL can't represent, and for segments with no rule-based definition (e.g. segment-flag or auto-managed segments).\n- note: only set when definition is omitted; explains why the segment can't be represented as DSL. Such segments are readable but not editable via the agent's update path.\n- usedBy: guides, Orchestrate journeys, reports, compound segments, and session-replay apps that reference this segment. Only present when includeUsedBy is true.","examples":["{\"id\":\"\\u003cid\\u003e\",\"includeUsedBy\":\"\\u003cincludeUsedBy\\u003e\",\"skill\":\"getSegment\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getSegment","inputModes":["application/json"],"name":"getSegment","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tGet performance metrics for a single Orchestrate email.\n\n\tReturns delivery, unique opens, unique clicks, bounces, unsubscribes, and spam complaints\n\tfor Pendo emails within the requested date range. Matches Orchestrate email overview metrics in the UI.\n\tEmail-level aggregates only: this tool does not return per-visitor metrics or identify which visitors sent, opened, clicked, bounced, or unsubscribed.\n\tFor per-visitor engagement use getOrchestrateEmailVisitors.\n\tUse listOrchestrateEmails to discover email IDs.\n\t\n\nUSE FOR: Analyzing Orchestrate email performance when you already have the email ID. Questions about sends, delivery rate, open rate, click rate, or bounces.\n\nEXAMPLES:\n- How did email abc perform last month?\n- Show delivery and open rates for orchestrate email 123\n- Get email metrics for email 123 between 2025-01-01 and 2025-01-31\n\nNOT FOR: Listing emails without an ID (use listOrchestrateEmails). Per-visitor email engagement (who opened, clicked, bounced, or unsubscribed - use getOrchestrateEmailVisitors). Journey-level metrics (use getOrchestrateJourneyMetrics). Per-step metrics for every step of a journey at once (use getOrchestrateJourneyStepMetrics). Email configuration (use getOrchestrateEmail).\n\nWORKFLOW: Call listOrchestrateEmails to discover email IDs, then call this tool with emailId and a date range.\n\nRETURNS:\n- Top-level emailId, startDate, endDate, plus metrics: unique-visitor counts (sent, delivered, opened, clicked, bounced, unsubscribed, complaint) and rates (deliveryRate, openRate, clickRate, clickToOpenRate, bounceRate, unsubscribeRate, complainRate). No rows or visitorId.\n- Rates as percentages: openRate and clickRate are % of delivered; deliveryRate, bounceRate, unsubscribeRate, and complainRate are % of sent; clickToOpenRate is % of opened. Bounce counts reflect hard bounces only (Permanent).\n\nThe maximum time range for this tool is 367 days.","examples":["{\"blacklist\":\"\\u003cblacklist\\u003e\",\"emailId\":\"\\u003cemailId\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"getOrchestrateEmailMetrics\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getOrchestrateEmailMetrics","inputModes":["application/json"],"name":"getOrchestrateEmailMetrics","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tList per-visitor email engagement for one Orchestrate email in a date range. Returns { meta, summary, rows } (see RETURNS).\n\n\tEach row is visitorId plus integer sent/delivered/opened/clicked/bounced/unsubscribed/complaint counts (events\n\tmatching that type in range for that visitor). Counts can exceed 1 for opens/clicks; summary.numVisitors is still\n\tthe distinct-visitor count for eventType, not a sum of row counts. Timestamps, URLs, and per-link click detail are\n\tunbounded and omitted. Bounce counts reflect hard bounces only (Permanent). eventType filters which visitors\n\tappear in rows (default opened); each row still includes all event-type counts. Use getOrchestrateEmailMetrics\n\tfor email-level unique-visitor totals and rates without per-visitor rows.\n\t\n\nUSE FOR: Listing which visitors had a sent, delivered, opened, clicked, bounced, unsubscribed, or complaint event on a specific Orchestrate email, or filtering to one visitorId.\n\nEXAMPLES:\n- Who opened orchestrate email abc last month?\n- List visitors who were sent email abc last month\n- List visitors who clicked email 123 in January\n- Did visitor X open email abc?\n- Which visitors bounced on email abc last month?\n\nNOT FOR: Email-level aggregate counts without visitor breakdown (use getOrchestrateEmailMetrics). Unlike getOrchestrateEmailMetrics (flat emailId, startDate, endDate, metrics), this tool wraps scope in meta with summary and rows.\n\nWORKFLOW: Call listOrchestrateEmails for emailId, then call with emailId, startDate, endDate, and optional eventType (default opened; use sent or delivered for recipient lists). Optional visitorId narrows to one visitor. Optional segmentPipeline scopes the audience; optional blacklist controls blacklist filtering (default apply).\n\nRETURNS:\n- meta: { emailId, startDate, endDate, eventType } echo of request scope\n- summary.numVisitors: distinct visitors with at least one event matching eventType (defaults to opened when omitted); computed before the row limit and not capped by limit; may exceed len(rows)\n- rows[]: { visitorId, sent, delivered, opened, clicked, bounced, unsubscribed, complaint } non-negative integer event counts; sorted by visitorId; truncated at limit (default 200, max 5000); no pagination - rows are not a complete visitor list when summary.numVisitors exceeds len(rows)\n\nThe maximum time range for this tool is 367 days.","examples":["{\"blacklist\":\"\\u003cblacklist\\u003e\",\"emailId\":\"\\u003cemailId\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"eventType\":\"\\u003ceventType\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"getOrchestrateEmailVisitors\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"visitorId\":\"\\u003cvisitorId\\u003e\"}"],"id":"getOrchestrateEmailVisitors","inputModes":["application/json"],"name":"getOrchestrateEmailVisitors","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tGet per-step performance metrics for a single Orchestrate journey by ID.\n\n\tReturns one entry per message step in execution-flow order, matching the per-step columns on the\n\tOrchestrate journey metrics page. Every count is scoped to journey entrants - visitors who entered THIS\n\tjourney within the requested date range - not campaign- or guide-wide activity, so the numbers reconcile\n\twith the journey metrics page. Email steps include delivery, unique opens, unique clicks, bounces,\n\tunsubscribes, and spam complaints among those entrants. Guide steps include the journey-page guide\n\tengagement columns: viewed (entrants who saw the guide) and clicked (entrants who interacted with it),\n\tplus the derived clickRate. Other step types carry no metrics and a metricUnavailableReason instead.\n\tUse getOrchestrateJourneySteps for the full step graph, getOrchestrateEmailMetrics for a single\n\tstandalone email, getOrchestrateJourneyMetrics for journey-level goal attainment, and guideMetrics for\n\tdeep single-guide analytics (completions, dismissals, polls, NPS, goal adoption).\n\t\n\nUSE FOR: Comparing how each step of an Orchestrate journey performed side by side: email delivery/open/click rates and guide viewed/clicked engagement per step, as shown on the journey metrics page.\n\nEXAMPLES:\n- How did each step in orchestrate journey 123 perform last month?\n- Show per-step open and click rates for orchestrate journey abc between 2025-01-01 and 2025-01-31\n- Which email step in this orchestrate journey had the best open rate?\n- Compare guide view and click counts across the steps of orchestrate journey 123\n\nNOT FOR: The journey step graph or message IDs without metrics (use getOrchestrateJourneySteps). Metrics for a single email by ID (use getOrchestrateEmailMetrics). Deep single-guide analytics like completions, dismissals, polls, NPS, or goal adoption (use guideMetrics). Journey-level rollup metrics or per-step journey-goal attainment (use getOrchestrateJourneyMetrics). Per-visitor engagement (who opened, clicked, bounced, completed, or dismissed).\n\nWORKFLOW: Call listOrchestrateJourneys to discover journey IDs, then call this tool with journeyId and a date range to get per-step metrics.\n\nRETURNS:\n- steps: an array of message steps in execution-flow order. Each step has: stepId, stepType, position, messageId, messageType, provider (plus the per-step metric fields below)\n- steps[].position: 0-based index of the step in the journey's execution flow across ALL nodes (start/exit/condition nodes also consume positions, so message-step positions are non-contiguous); cross-reference with getOrchestrateJourneySteps\n- steps[].email: per-step email metrics among journey entrants (sent, delivered, opened, clicked, bounced, unsubscribed, complaint and the derived rates; openRate/clickRate are of delivered); present only for email steps. The page surfaces opened and clicked per step; the remaining counts are the same entrant-scoped events\n- steps[].guide: per-step guide engagement matching the journey metrics page - viewed (journey entrants with a guide-seen event), clicked (journey entrants with a guide-interaction event), and clickRate (clicked/viewed %); present only for guide steps. Completions, dismissals, polls, NPS, and goal adoption are not per-step here - use guideMetrics\n- steps[].metricUnavailableReason: present when both email and guide are null - step_type_not_supported (unsupported step type) or message_not_found (linked email/guide missing)\n- steps[]: every count is scoped to visitors who entered this journey within [startDate, endDate]; a step the caller cannot access (no view permission on the message's application) returns a zero-valued metrics block, not an error or a missing step, matching the journey metrics page\n- journeyId, name, status, startDate, endDate, and stepCount (number of message steps returned) are top-level fields for orientation\n\nThe maximum time range for this tool is 367 days.","examples":["{\"endDate\":\"\\u003cendDate\\u003e\",\"journeyId\":\"\\u003cjourneyId\\u003e\",\"skill\":\"getOrchestrateJourneyStepMetrics\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getOrchestrateJourneyStepMetrics","inputModes":["application/json"],"name":"getOrchestrateJourneyStepMetrics","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tGet full details for a single Orchestrate email campaign by ID.\n\n\tReturns any orchestrate email the caller can access, including journey message emails when you already have the email ID.\n\tUse list_orchestrate_emails to discover orchestrate email campaigns; use this tool when you have a specific email ID.\n\t\n\nUSE FOR: Inspecting an Orchestrate email's configuration, status, schedule, audience, and template-level fields when you already have the email ID (standalone or journey-linked).\n\nEXAMPLES:\n- Get email details for email 123\n- Show orchestrate email config for abc\n- What is email xyz?\n- Show me full details for this orchestrate email\n- Get email campaign by ID\n\nNOT FOR: Listing or searching emails without an ID (use list_orchestrate_emails). Email performance metrics like sends, opens, or clicks (use get_orchestrate_email_metrics). Journey configuration without a journey ID (use list_orchestrate_journeys or get_orchestrate_journey).\n\nWORKFLOW: Call list_orchestrate_emails to discover email IDs, then call this tool with emailId.\n\nRETURNS:\n- Orchestrate email campaign configuration for agents: name, status (UI lifecycle label for standalone emails), subject, provider (Pendo, HubSpot, Marketo, or Eloqua), email settings, audience, schedule start time, and lifecycle timestamps (publishedAt, triggeredAt, executedAt)\n- attributes includes journeyId when the email belongs to a journey\n- Integration IDs (HubSpot, Marketo, Eloqua) when the email uses an external provider","examples":["{\"emailId\":\"\\u003cemailId\\u003e\",\"skill\":\"getOrchestrateEmail\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getOrchestrateEmail","inputModes":["application/json"],"name":"getOrchestrateEmail","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tGet journey-level performance metrics for a single Orchestrate journey.\n\n\tCovers visitor entry and exit counts and - for journeys with a goal - goal attainment. Returns\n\tjourney-wide aggregates only: no per-step, per-message, or per-visitor breakdown.\n\t\n\nUSE FOR: Analyzing overall Orchestrate journey performance when you already have the journey ID. Questions about visitors entered, visitors completed, or (for journeys with a configured goal) goal attainment.\n\nEXAMPLES:\n- How is orchestrate journey 123 performing?\n- How many visitors entered and exited orchestrate journey abc?\n- What is the goal attainment rate for this orchestrate journey?\n- Show journey metrics for journey 123 between 2025-01-01 and 2025-01-31\n\nNOT FOR: Per-step or per-message metrics within the journey (use getOrchestrateJourneyStepMetrics). The journey step graph or structure (use getOrchestrateJourneySteps). Metrics for a single email by ID (use getOrchestrateEmailMetrics). Per-visitor journey membership (which visitors entered or exited). Listing journeys without an ID (use listOrchestrateJourneys). Journey configuration (use getOrchestrateJourney).\n\nWORKFLOW: Call listOrchestrateJourneys to discover journey IDs, then call this tool with journeyId, optionally with startDate and endDate.\n\nRETURNS:\n- visitorsEntered: unique visitors who entered the journey\n- visitorsCompleted: unique entered visitors who finished the journey by reaching an Exit step or aging out (for required-goal journeys, achieving the goal also marks completion). This is a journey-exit count, NOT goal attainment - use visitorsAchievedGoal for that. For optional-goal journeys, achieving the goal does not by itself mark a visitor completed, so an achiever is counted here only once they later reach an Exit or age out\n- visitorsAchievedGoal: unique entered visitors who achieved the journey goal, computed independently of completion tagging (omitted for journeys with no goal). Because attainment is tracked separately from completion, this can briefly exceed visitorsCompleted while achievers are still in-flight - it is not a stable relationship\n- goalAttainmentRate: visitorsAchievedGoal as a percentage of visitorsEntered (omitted for journeys with no goal or when no visitors entered)\n- goal: the journey goal definition (type, itemType, itemId, isGoalOptional); omitted for journeys with no goal\n- When startDate and endDate are provided, visitorsEntered and visitorsCompleted are limited to entry/exit within that range; otherwise cumulative totals are returned\n- visitorsAchievedGoal and goalAttainmentRate are always cumulative (the backend goal-achievement definition is not time-bounded) and are omitted when a date range is provided; request without a date range to retrieve them\n\nThe maximum time range for this tool is 367 days.","examples":["{\"endDate\":\"\\u003cendDate\\u003e\",\"journeyId\":\"\\u003cjourneyId\\u003e\",\"skill\":\"getOrchestrateJourneyMetrics\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getOrchestrateJourneyMetrics","inputModes":["application/json"],"name":"getOrchestrateJourneyMetrics","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tGet the ordered step graph (nodes and edges) for a single Orchestrate journey by ID.\n\n\tReturns the journey's structure only: each step's type, position, and linked message IDs, plus the\n\tedges connecting the steps. Does NOT return per-step metrics (sends, opens, clicks); use\n\tgetOrchestrateJourneyStepMetrics for those.\n\tUse listOrchestrateJourneys to discover journey IDs and getOrchestrateJourney for journey-level config.\n\t\n\nUSE FOR: Inspecting the ordered steps of an Orchestrate journey: step types (start, message, condition, exit), the order/position of each step, the message ID and message sub-type (email or guide) of each message step, durationInDays (Email: days until the next step; Guide: days the guide stays active/eligible), and the edges that connect the steps.\n\nEXAMPLES:\n- Show the steps of orchestrate journey 123\n- What messages are in this orchestrate journey?\n- List the steps and their order for orchestrate journey xyz\n- What is the structure of this orchestrate journey?\n- Which guide/email is sent at each step of orchestrate journey 123?\n\nNOT FOR: Per-step performance metrics like sends, opens, or clicks (use getOrchestrateJourneyStepMetrics). Journey-level configuration such as audience, goal, or scheduling (use getOrchestrateJourney). Listing journeys without an ID (use listOrchestrateJourneys). Email content (use getOrchestrateEmail).\n\nWORKFLOW: Call listOrchestrateJourneys to discover journey IDs, then call this tool with journeyId to retrieve the journey's steps and how they connect.\n\nRETURNS:\n- steps: journey nodes in execution-flow order (same order the Orchestrate editor renders, walking from the start node; a condition's Yes branch precedes its No branch). position is the 0-based index in that flow order\n- name: for message steps this is the linked email/guide's display name (as shown in the Orchestrate editor); for other steps it is the node's label and may be empty\n- message steps additionally include messageId, messageType (Email | Guide), provider, durationInDays (Email: days until the next step; Guide: days the guide stays active/eligible for the visitor)\n- edges: the connections between steps (from, to, edgeType where edgeType is Regular for linear steps or Yes/No for condition branches)\n- startNodeId and stepCount (number of message steps) for quick orientation","examples":["{\"journeyId\":\"\\u003cjourneyId\\u003e\",\"skill\":\"getOrchestrateJourneySteps\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getOrchestrateJourneySteps","inputModes":["application/json"],"name":"getOrchestrateJourneySteps","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tGet full details for a single Orchestrate journey by ID.\n\n\tReturns curated journey configuration including audience, status, scheduling, and goal.\n\tDoes not include the step graph, linked message/email IDs, or email settings (those live on each email; use getOrchestrateEmail).\n\tUse listOrchestrateJourneys to discover journey IDs.\n\t\n\nUSE FOR: Inspecting an Orchestrate journey's configuration, audience, status, scheduling, and goal when you already have the journey ID.\n\nEXAMPLES:\n- Get orchestrate journey details for journey 123\n- Show me the full config for this orchestrate journey\n- What is orchestrate journey xyz?\n- Get orchestrate journey campaign by ID\n\nNOT FOR: Listing or searching orchestrate journeys without an ID (use list_orchestrate_journeys). Email campaign details or email settings (use get_orchestrate_email). Journey step graph or linked message/email IDs (use get_orchestrate_journey_steps).\n\nWORKFLOW: Call list_orchestrate_journeys to discover journey IDs, then call this tool with journeyId.\n\nRETURNS:\n- Journey configuration for agents: name, status (UI lifecycle label), audience, goal, and scheduling\n- Lifecycle timestamps (createdAt, updatedAt, publishedAt, firstPublishedAt)\n- App IDs, step count, audience targeting, and control-group settings","examples":["{\"journeyId\":\"\\u003cjourneyId\\u003e\",\"skill\":\"getOrchestrateJourney\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getOrchestrateJourney","inputModes":["application/json"],"name":"getOrchestrateJourney","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Fetches one batch of the generated feature suggestions. Suggestions are grouped into sections keyed by (pageUrl, actionType) as listed in the suggestions manifest; pass pageUrl exactly as it appears there, including the sitewide pseudo-URL entry. Results expire with the session (24 hours).\n\nUSE FOR: Step 3 of the tagging workflow: paging through the feature suggestions of a section listed in the processPageAndFeatureSuggestions manifest.\n\nWORKFLOW: 1. captureDomForTagging - upload the page's DOM and receive a domHandle. 2. processPageAndFeatureSuggestions - generate suggestions for the captured DOM(s), referencing each capture by its domHandle; returns a sessionId and manifest. 3. getSuggestedFeatureBatch - retrieve the feature suggestions in batches, choosing sections and batch sizes as you see fit.\n\nRETURNS:\n- features - one batch of feature tag suggestions\n- total - total number of suggestions in the section","examples":["{\"actionType\":\"\\u003cactionType\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"pageUrl\":\"\\u003cpageUrl\\u003e\",\"sessionId\":\"\\u003csessionId\\u003e\",\"skill\":\"getSuggestedFeatureBatch\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"getSuggestedFeatureBatch","inputModes":["application/json"],"name":"getSuggestedFeatureBatch","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","enableTagWithLeo","read-only"]},{"description":"Dashboard-consistent, visitor-weighted Guide Effectiveness metrics for every guide, with optional comparison across up to 4 segments. Returns one row per guide plus an overview summary of averages across the matched set. Rates are visitor-weighted exactly as the Guide Effectiveness dashboard computes them: engagement = distinct visitors who interacted / distinct visitors who viewed; completion = distinct visitors who reached the last step / distinct visitors who reached the first step (multi-step guides only); goal adoption = converted visitors / total visitors (guides with a conversion goal only). Every rate ships with its raw numerator and denominator so sample size is visible. Aggregates cover the whole date range (no time-series buckets). Use sortBy to rank guides by a chosen metric, ascending or descending. IMPORTANT: When presenting results to the user, always state the active filters alongside the data: date range, app (if specified), segment(s), status filter, and activation filter. This lets users verify exactly which data scope produced the numbers.\n\nUSE FOR: Reporting guide effectiveness that matches the Guide Effectiveness dashboard (engagement %, completion %, goal-adoption %), and comparing those rates across up to 4 segments.\n\nEXAMPLES:\n- How effective are our guides over the last 30 days?\n- Compare guide engagement and completion between the power-users and trial segments\n- Which guides have the lowest completion rate this month?\n- Show goal adoption for guides that have a conversion goal\n\nNOT FOR: Simple cross-guide ranking by raw views/dismissals (use aggregateGuideMetrics). Deep single-guide analysis with polls, NPS, or step funnels (use guideMetrics).\n\nRETURNS:\n- meta: resolved dateRange (startDate/endDate), the segments compared, and guideCount\n- summary: per-segment overview - totalViews, totalFirstTimeViews, totalVisitors, engagementRate, completionRate, goalAdoptionRate\n- rows: one per guide with entityId, entityName, state, launchMethod, and per-segment metric blocks (rate + raw numerator/denominator). completionRate is null for single-step guides; goalAdoptionRate is null for guides without a conversion goal","examples":["{\"activation\":\"\\u003cactivation\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"guideCategoryIds\":\"\\u003cguideCategoryIds\\u003e\",\"guideIds\":\"\\u003cguideIds\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"pageIds\":\"\\u003cpageIds\\u003e\",\"productAreaIds\":\"\\u003cproductAreaIds\\u003e\",\"segments\":\"\\u003csegments\\u003e\",\"skill\":\"guideEffectivenessMetrics\",\"sortBy\":\"\\u003csortBy\\u003e\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"guideEffectivenessMetrics","inputModes":["application/json"],"name":"guideEffectivenessMetrics","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get per-poll response distribution and per-visitor response rows for a guide's non-NPS polls. Returns {meta, summary, rows}: summary.polls lists each poll with its question and response distribution; rows are visitor-keyed and pivoted - one column per poll, null where a visitor did not respond. limit (default 10, max 200) applies to the pivoted visitor rows after joining across all polls.\n\nUSE FOR: Answering questions about how visitors responded to polls in a guide: response distributions, individual visitor answers, and per-poll breakdowns. Not for NPS guide score metrics.\n\nEXAMPLES:\n- What were the responses to the poll in the onboarding guide?\n- Show me the response distribution for guide X polls\n- Which visitors answered 'Yes' to the helpfulness poll?\n- What did visitors respond to the polls in guide G last month?\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- summary.polls: array of {pollId, question, distribution: [{response, count}]} for each poll. For free-text polls (open-ended responses), freeText is true and distribution is omitted because every response is unique - refer to the per-visitor rows instead.\n- rows: per-visitor with visitorId, browserTime, and one column per pollId (null if no response)","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"guideId\":\"\\u003cguideId\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"pollIds\":\"\\u003cpollIds\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"guidePollResponses\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"guidePollResponses","inputModes":["application/json"],"name":"guidePollResponses","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get per-visitor or per-account usage breakdown for a single guide, with time-on-guide and new vs returning viewers. totalViews excludes continue-resumed guideSeen events to match the Pendo guide-details UI. For poll guides, includes per-poll response counts and response rate in summary.\n\nUSE FOR: Per-visitor or per-account guide engagement - e.g. top visitors by time on guide, which accounts are completing vs dismissing, new vs returning viewer counts. With includeElements=true, also attributes each step's clicks to the individual buttons/links on it.\n\nEXAMPLES:\n- Top 20 visitors by time on guide X in the last 30 days\n- Which accounts are dismissing the onboarding guide most?\n- How many new vs returning viewers did the walkthrough have this month?\n- Show me per-visitor completion data for the tooltip guide\n- Is drop-off at step 3 happening via the CTA or by dismissing the guide?\n- Which button on the last step of the onboarding guide gets clicked most?\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- summary: totalViews, completions, dismissals, uniqueVisitors, uniqueAccounts, completionRate, dismissalRate, viewsPerUser, avgTimeOnGuide, medianTimeOnGuide (duration objects {seconds, display}), newViewers, returningViewers, isPoll\n- summary.polls (poll guides only): per-pollId uniqueResponseCount and totalResponseCount\n- rows: per-visitor or per-account rows with views, completions, dismissals, daysActive, lastSeen (timestamp object {iso, display}), timeOnGuide (duration object {seconds, display}) (per-account rows also include uniqueVisitors), sorted and limited\n- steps (only when includeSteps or includeElements is true): per-step array in guide step order, each with stepId, name, uniqueVisitors, viewCount. Single-step guides return one entry; step views include continue-resumed views to match the Pendo step funnel.\n- steps[].elements (only when includeElements=true): the step's clicked buttons/links, highest clicks first, each with uiElementId, text, type ('Button', 'Close Button', 'Link', 'Task Item', 'Image', 'Swiped Left', 'Swiped Right' or 'Unknown'), actions (what the click does, e.g. 'Next Step', 'Dismiss Guide', 'External URL', 'Go to Step (2)'), clicks, uniqueVisitors, percentOfStepClicks. Compare an element's uniqueVisitors against its step's uniqueVisitors to attribute drop-off. Only clicked elements appear, and elements since removed from the step are still counted.\n\nThe maximum time range for this tool is 367 days.","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"groupBy\":\"\\u003cgroupBy\\u003e\",\"guideId\":\"\\u003cguideId\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"includeElements\":\"\\u003cincludeElements\\u003e\",\"includeSteps\":\"\\u003cincludeSteps\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"guideUsage\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"guideUsage","inputModes":["application/json"],"name":"guideUsage","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Links an existing feedback item to an existing idea, associating the customer evidence with the feature request. Votes from the feedback item are propagated to the idea's vote count.\n\nUSE FOR: When the user explicitly asks to link, connect, or associate a feedback item with an idea, or vice versa\n\nEXAMPLES:\n- Link feedback abc123 to idea xyz456\n- Connect this feedback to that idea\n- Associate idea xyz456 with feedback abc123\n\nRETURNS:\n- Confirmation that the idea and feedback item have been linked","examples":["{\"feedbackItemId\":\"\\u003cfeedbackItemId\\u003e\",\"ideaId\":\"\\u003cideaId\\u003e\",\"skill\":\"linkIdeaAndFeedback\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"linkIdeaAndFeedback","inputModes":["application/json"],"name":"linkIdeaAndFeedback","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools"]},{"description":"List the accounts that match a segment or fuzzy-search account display names or IDs. Segment mode (the default) defines the cohort with a segmentPipeline - either a saved Pendo segment reference or a full inline pipeline produced by the segment-builder tool. Search mode fuzzy-matches both the configured account display-name field and account ID.\n\nUSE FOR: Listing the accounts in a segment/cohort, getting the account total, reading account metadata fields for those accounts, or resolving a named account to its ID without an application ID.\n\nEXAMPLES:\n- List the accounts in segment X\n- Which accounts match these metadata criteria?\n- How many accounts are in this segment?\n- Show me accounts in segment X with their ARR and company size\n- Find the account called Acme Inc\n\nRETURNS:\n- summary: numAccounts (the full segment total in segment mode; the number of returned matches in search mode)\n- rows in both modes: accountId, name, description when available, and requested fields in a metadata object keyed by metadata path (for example, \"metadata.auto.lastvisit\"), capped by limit\n- Search rows also include relevance. Only sufficiently relevant fuzzy matches are returned; unrelated accounts are omitted","examples":["{\"limit\":\"\\u003climit\\u003e\",\"mode\":\"\\u003cmode\\u003e\",\"search\":\"\\u003csearch\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"select\":\"\\u003cselect\\u003e\",\"skill\":\"listAccounts\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listAccounts","inputModes":["application/json"],"name":"listAccounts","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Lists detected (emergent) issues in AI agent conversations with instance counts and conversation counts. Returns a table of issue name (clusterName), summary, instance count, and conversation count per issue, plus a sample of conversationIds/eventIds for deep-diving via agentAnalyticsIssueAnalysis. It also returns visitorIds and accountIds who experienced the issue.\n\nUSE FOR: Finding what problems or issues users encountered when using AI agents (e.g., incorrect answers, refusals, errors). Use when the user asks about common issues, problems, or failures with a specific agent. Refer to an issue by its clusterName, never its numeric clusterId.\n\nEXAMPLES:\n- What are the common issues my users are encountering using my ABC agent in the last 30 days?\n- What problems have users been encountering when using Acme agent in my Acme application lately?\n- Have we seen reduced occurrences of issues with incorrect answers in our fooBar agent since last month?\n- What models are most often used when users face problems with the chat agent in ScramCorp app?\n\nNOT FOR: Use listUseCases for topic/cluster analysis of conversations. Use listAiAgents to get agent IDs and names first when the user has not specified an agent.\n\nRETURNS:\n- Table of issues: summary, instance count, conversation count, agentId, appId, visitorIds, and accountIds.\n- Sorted by conversation count descending. Limited to 500 rows.\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"granularity\":\"\\u003cgranularity\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"listAiAgentIssues\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listAiAgentIssues","inputModes":["application/json"],"name":"listAiAgentIssues","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\nLists all AI agents that the user has access to. AI agents are conversational assistants that can be deployed on specific pages or app-wide.\n\nAI agents have the ability to collect conversations, cluster prompts by topics/use cases, and calculate metrics like conversation counts and rage prompt detection.\n\nThis tool returns agent ids and names for usage with other related agent tools.\n","examples":["{\"skill\":\"listAiAgents\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listAiAgents","inputModes":["application/json"],"name":"listAiAgents","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\nPendo data is split into subscriptions, which share a set of visitors and accounts. Each subscription is split into separate applications. This call returns a list of all\nthe names and ids of all the subscriptions this user has access to, along with the names and ids of all of the applications in that subscription.\n\nMost tools for this mcp require at least a subscription id; many also require an application id. Application ids are not unique across different subscriptions.","id":"listAllApplications","inputModes":["application/json"],"name":"listAllApplications","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tlistCountables is a tool to find, search, look up, or list pages, features, or track events by name and return their entity IDs.\n\tThese entities are collectively called \"countables\" - the tagged elements and custom events that Pendo\n\ttracks in your application. Use the type parameter to select which kind to list.\n\n\tThis is the entity lookup tool to use before single-page, single-feature, or single-track-event usage\n\tanalytics when the user provides a name instead of an ID. Relevant analytics questions include page views,\n\tfeature clicks, event counts, unique visitor or \"people\" counts, unique account counts, time on page,\n\tfrustration clicks, and other entity usage metrics.\n\n\tThe trackEvent type corresponds to what other tools call trackType or TrackType.\n\n\tSupports search via the search param with a searchType selector: \"semantic\" for natural-language queries\n\tranked by meaning, \"fuzzy\" for keyword matching on names and descriptions, or \"substring\" for\n\tcase-insensitive containment match on name. Both search and searchType are required together.\n\tFor features, pageId restricts discovery to features associated with one known page.\n\tOffset is ignored when search is used; use limit to control result count.\n\t\n\nUSE FOR: Resolving a named page, feature, or track event to its ID before calling entityUsage; listing features associated with a page; listing or browsing countables by name; auditing what is tagged in an app; semantic, fuzzy, or substring search for countable entities.\n\nEXAMPLES:\n- List all pages\n- Show me features for this app\n- Which features are associated with page X?\n- List track events matching 'checkout'\n- Find pages with 'dashboard' in the name\n- What track events are defined?\n- Find features related to user onboarding\n- Search for pages about checkout flow\n- Find the ID for 'Page X' before checking how many people viewed it\n\nNOT FOR: Listing guides. Listing product areas. Usage analytics, click counts, visitor counts, or activity rankings.\n\nWORKFLOW: For analytics about one named entity, search here first. Prefer searchType='substring' with the entity name exactly as the user supplied it; if that finds no match, retry with searchType='fuzzy' or 'semantic'. Then pass the matching ID to entityUsage. Do not conclude that the entity does not exist merely because it was absent from an aggregateEntityUsage ranking, which returns only a limited set of ranked entities.\n\nRETURNS:\n- Summary info for each matching entity: ID, name, description, and eventPropertyNames (custom property names attached to the countable). Pages also include URL rules and exclude rules. Features include pageId and elementPathRules (CSS selector rules identifying the tagged UI element).\n- When search is used: results include a relevance score","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"pageId\":\"\\u003cpageId\\u003e\",\"productAreaId\":\"\\u003cproductAreaId\\u003e\",\"search\":\"\\u003csearch\\u003e\",\"searchType\":\"\\u003csearchType\\u003e\",\"skill\":\"listCountables\",\"subId\":\"\\u003csubId\\u003e\",\"type\":\"\\u003ctype\\u003e\"}"],"id":"listCountables","inputModes":["application/json"],"name":"listCountables","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"List a subscription's designated business OBJECTS - the custom event properties that have been marked as analyzable business entities (e.g. 'dashboardId', 'venueId', 'orderId'). Returns each object's underlying event property name (its field) and kind, which are exactly the objectProperty argument the objectAnalytics* tools take, plus its customer-facing displayName/description when an admin has set them. Objects are NOT pages, features, or track events.\n\nUSE FOR: Discovering which business objects a subscription has, and grounding an ambiguous entity name before an objectAnalytics* call. Use it when a name could mean either a business object or a page/feature (e.g. 'dashboards') to confirm the object exists and get the exact objectProperty.field to pass to objectAnalyticsActiveCount or objectAnalyticsBreakdown. The search term matches the object's field name, displayName, or description, so a customer-facing label (e.g. 'Reports') resolves even when it doesn't textually overlap the underlying field key (e.g. 'rp_obj_4471').\n\nEXAMPLES:\n- What business objects can I analyze in this subscription?\n- Is 'dashboard' a business object or a page?\n- List the custom objects available for Object Analytics\n- Which object property identifies venues?\n\nNOT FOR: Listing pages, features, or track events - use listCountables. Counting or ranking objects, or any per-object metric - use objectAnalyticsActiveCount or objectAnalyticsBreakdown. This returns only the object property definitions, never metrics. Confirming whether a METADATA TERM (e.g. 'size', 'region', 'category') actually belongs to a specific object's own schema - use resolveBusinessObject.\n\nWORKFLOW: To resolve a specific object by name, prefer searchType='substring' with the name as the user gave it; if that returns no match, retry with searchType='fuzzy' to survive a misspelling or a loosely-worded label. Choosing the mode is your call - the server never falls back automatically. If the question references metadata terms rather than - or in addition to - one of the object names returned here, do not assume a term belongs to whichever object seems closest. Pick the most likely candidate object from this list (asking the user first if more than one plausibly fits) and call resolveBusinessObject with that object's field (and kind/group/metadataKind for historical objects) plus the terms, to confirm they're actually part of its schema before running an objectAnalytics* query.\n\nRETURNS:\n- One entry per designated object property: field (the event property name to pass as objectProperty.field, e.g. 'dashboardId'), and kind ('event' or 'historical').\n- displayName and description: the customer-facing label and description set by an admin, when present. Absent when never set.\n- For historical (promoted visitor/account/parentAccount metadata) objects, group and metadataKind are also included.\n- promotedAt (epoch milliseconds): when the property became an analyzable object. This is the activation floor the objectAnalytics* tools apply internally - events before it are excluded - so use it to caveat data availability or pick a start date that postdates promotion.\n- matchedFields (substring search only): which of field/displayName/description the term matched, so you can see why an object was returned. A match on field or displayName is a strong signal; a description-only match is weaker (descriptions are free-form sentences, so the term may appear incidentally) - prefer field/displayName matches when ranking candidates.\n- relevance (fuzzy search only): a similarity score for ranking - higher means a closer match to the search term. Rank candidates by it; matchedFields is absent in this mode.","examples":["{\"search\":\"\\u003csearch\\u003e\",\"searchType\":\"\\u003csearchType\\u003e\",\"skill\":\"listCustomObjects\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listCustomObjects","inputModes":["application/json"],"name":"listCustomObjects","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Check whether metadata or property terms mentioned in a question (e.g. 'size', 'region', 'category') actually belong to one already-identified designated business OBJECT (see listCustomObjects), by matching them against that object's own declared metadata schema (the fields customers send on metadata events for that object, e.g. 'type', 'isShared' - the same schema accountMetadataSchema/visitorMetadataSchema expose for accounts/visitors). Returns status 'confirmed' when at least one term matches, or 'noMatch' when none do - including when the object has no declared metadata schema at all.\n\nUSE FOR: Before calling objectAnalyticsActiveCount, objectAnalyticsBreakdown, or objectEventBreakdown with metadata terms drawn from the user's question, once you have a specific candidate object in mind (its name is unambiguous, or you already narrowed it down via listCustomObjects) but are not certain those terms are actually part of its schema.\n\nEXAMPLES:\n- The user asked to break down 'reports' by 'type' - confirm 'type' is part of the reportId object's schema before querying\n- Does the 'venue' object have a 'region' field?\n\nNOT FOR: Figuring out WHICH object a question is about when more than one could plausibly apply - use listCustomObjects to see what's available and pick (or ask the user to pick) a candidate first, then call this tool to confirm its terms. Simply listing the objects that exist - use listCustomObjects directly. Ranking or counting objects, or computing any metric - use objectAnalyticsActiveCount, objectAnalyticsBreakdown, or objectEventBreakdown once the object and terms are confirmed.\n\nRETURNS:\n- status: 'confirmed' (at least one term matched) or 'noMatch' (none did).\n- field, kind, group/metadataKind (historical objects only): the object identifier that was checked, echoed back exactly as it should be passed to objectAnalyticsActiveCount, objectAnalyticsBreakdown, or objectEventBreakdown.\n- matchedTerms: which input terms matched the object's declared metadata schema (exact, case-insensitive).\n- metadataSchema: type/cardinality/sample values for each matched term (keyed by its normalized field name), when the customer has sent metadata events for it - use these to know its value type and possible values when filtering or breaking down by it.\n- unmatchedTerms: input terms that matched nothing. Even when status is 'confirmed', a non-empty unmatchedTerms means part of the question wasn't understood - do not silently drop it; surface it or ask the user what they meant by it.\n- suggestions: for each unmatched term that has one, declared field names it's a substring of or contains (e.g. 'type' suggesting 'reportType') - keyed by the original term. Offer these to the user as a correction ('did you mean X?') rather than guessing silently or giving up. Absent when no unmatched term has a substring match - that does not rule out a misspelling; call listBusinessObjectMetadata to see every declared field and check for one yourself.","examples":["{\"objectProperty\":\"\\u003cobjectProperty\\u003e\",\"skill\":\"resolveBusinessObject\",\"subId\":\"\\u003csubId\\u003e\",\"terms\":\"\\u003cterms\\u003e\"}"],"id":"resolveBusinessObject","inputModes":["application/json"],"name":"resolveBusinessObject","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"List every metadata field declared on one already-identified designated business OBJECT (see listCustomObjects) - the fields customers send on metadata events for that object (e.g. 'type', 'isShared'), the same schema accountMetadataSchema/visitorMetadataSchema expose for accounts/visitors. Empty metadataSchema means the customer has never sent metadata events for this object.\n\nUSE FOR: The user asks what metadata fields, properties, or dimensions are available on a business object; or resolveBusinessObject reported a term as unmatched (with or without a suggestion) and you need the full set of declared fields to find the right one, e.g. to offer the user a corrected choice.\n\nEXAMPLES:\n- What metadata fields are available on the 'reportId' object?\n- resolveBusinessObject said 'type' doesn't match reportId's schema - what fields does it actually have?\n\nNOT FOR: Checking whether SPECIFIC terms from a question belong to the object - use resolveBusinessObject, which also fuzzy-suggests close matches for an unmatched term without needing the full list. Listing which business objects exist in the first place - use listCustomObjects. Any per-object metric - use objectAnalyticsActiveCount, objectAnalyticsBreakdown, or objectEventBreakdown.\n\nRETURNS:\n- field, kind, group/metadataKind (historical objects only): the object identifier that was checked, echoed back exactly as it should be passed to objectAnalyticsActiveCount, objectAnalyticsBreakdown, or objectEventBreakdown.\n- metadataSchema: every declared metadata field on this object, keyed by its normalized field name, with type/cardinality/sample values - empty when the customer has never sent metadata events for it.","examples":["{\"objectProperty\":\"\\u003cobjectProperty\\u003e\",\"skill\":\"listBusinessObjectMetadata\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listBusinessObjectMetadata","inputModes":["application/json"],"name":"listBusinessObjectMetadata","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Returns all guide categories for a subscription - their IDs, names, and platform (web or mobile). Each category exists as a paired web+mobile variant with distinct IDs; use the platform filter to narrow results.\n\nUSE FOR: Finding a guide category ID to associate a guide with a category, or enumerating which categories exist for a subscription. Pair with listGuides to see which guides belong to each category.\n\nEXAMPLES:\n- What guide categories are set up for this subscription?\n- List all guide categories\n- Show me web guide categories\n- Which mobile guide categories exist?\n- What are the available guide categories and their IDs?\n\nNOT FOR: Guide analytics or engagement metrics - use guideMetrics or guideUsage instead. To search or list guides themselves, use listGuides.\n\nRETURNS:\n- Array of guide categories, each with: id, name, platform (web or mobile)","examples":["{\"limit\":\"\\u003climit\\u003e\",\"platform\":\"\\u003cplatform\\u003e\",\"search\":\"\\u003csearch\\u003e\",\"skill\":\"listGuideCategories\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listGuideCategories","inputModes":["application/json"],"name":"listGuideCategories","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tList guide experiments (guide A/B tests) and return their IDs.\n\n\tA guide experiment splits an audience across two or more variants to compare which performs better. Each\n\tvariant is either a guide or the control group (no guide, shown as isControl). Experiments move through\n\tstates: draft (not started), active (running), needsReview (finished, awaiting a decision), completed.\n\n\tThis is the lookup tool for resolving an experiment name to its ID, and for finding which experiment a guide\n\tis part of - filter by guideIds to answer \"is this guide being A/B tested?\". It returns experiment\n\tconfiguration only, not experiment results.\n\t\n\nUSE FOR: Listing or browsing guide experiments; resolving an experiment name to its ID; checking which experiment a guide belongs to (guideIds); listing experiments in a given state, such as which experiments are currently running.\n\nEXAMPLES:\n- What guide experiments do we have?\n- Which guide experiments are currently running?\n- Is guide abc123 part of an experiment?\n- Show me guide experiments that have completed\n- List guide experiments for app 12345\n\nNOT FOR: Guide content, targeting, or scheduling - use listGuides. Guide views, completion, or conversion metrics - use guideEffectivenessMetrics or aggregateGuideMetrics. Experiment results, audience rules, conversion goals, or which variant won - this tool returns configuration only.\n\nRETURNS:\n- Array of experiments with: id, name, description, state, appId, startTime, endTime\n- variants per experiment: variant name, guideId, groupSize (percentage of the audience assigned to the variant, summing to 100), and isControl for the control group, which has no guide\n\nFILTERING OPTIONS:\n- guideIds: only experiments that have one of these guides as a variant\n- state: only experiments in this state - draft, active, needsReview, completed\n- appId: only experiments scoped to that application","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"guideIds\":\"\\u003cguideIds\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"skill\":\"listGuideExperiments\",\"state\":\"\\u003cstate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listGuideExperiments","inputModes":["application/json"],"name":"listGuideExperiments","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tList the guide delivery order (\"throttle order\") for an app.\n\n\tWhen multiple guides are eligible to show at the same time, the delivery order determines which guide takes precedence. This tool returns the ordered list of guides for the given app. An app with no ordering set returns an empty list.\n\n\tGuides are capped by limit (default 50). totalGuides is the full ordering length; offset and returned describe the slice in guides. When returned \u003c totalGuides the result is truncated - tell the user which range they're seeing (e.g. \"showing 1-50 of 120\") and use offset to page through the rest.\n\n\tPRESENTATION (follow exactly):\n\tFor EVERY guide, show ALL SIX of these columns, always in this order:\n\t  Guide Name | Status | Segment | Page | Guide Category | Product Area\n\tShow every column even when most guides share a value and even when a column has no values. Segment is the readable segment name (e.g. \"Everyone\", \"Browser: Chrome\"). Page is \"Sitewide\" when the guide targets no specific page.\n\n\tDo NOT show the raw guideId to the user. It is for your context only, to reference guides in follow-up tool calls.\n\t\n\nEXAMPLES:\n- What is the guide delivery order for app xxx?\n- Which guide shows first when several are eligible?\n- Show me the throttle ordering for app xxx\n\nRETURNS:\n- appId, appName, totalGuides, offset, returned, and the ordered guides for the app\n- totalGuides/offset/returned: the full ordering length and the returned slice - surface the range to the user when truncated\n- guides: in delivery order. Always display these six columns per guide: Guide Name, Status, Segment, Page, Guide Category, Product Area\n- guideId is context-only - never shown to the user","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"skill\":\"listGuideOrdering\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listGuideOrdering","inputModes":["application/json"],"name":"listGuideOrdering","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tList and filter in-app guides, or fetch a single guide's full content.\n\n\tThree modes:\n\t1. **List mode** (default): Returns summary info (ID, name, state, type, scheduling) for each matching guide.\n\t2. **Expanded list mode** (expand=true): Returns detailed guide metadata for each matching guide, including steps (type, advance method, targeting), polls, scheduling, recurrence, conversion tracking, and translation languages and statuses. Does not include guide content text - use guideId for that.\n\t3. **Single guide content mode** (guideId=\u003cid\u003e): Fetches one guide by ID and returns its full structured content - step-by-step text extracted from the guide's building blocks, plus an activation URL which can be used to launch the guide if eligible. Use this when you need to read what a guide actually says to the user.\n\n\tSupports search via the search param with a searchType selector: \"semantic\" for natural-language queries ranked by meaning, or \"fuzzy\" for keyword matching on guide names and descriptions.\n\tOffset is ignored when search is used; use limit to control result count.\n\n\tGuides are interactive in-app experiences (tooltips, walkthroughs, banners, lightboxes, etc.) that\n\tguide end-users through tasks in their application.\n\t\n\nEXAMPLES:\n- List all public guides\n- Show me draft guides\n- Find all walkthrough guides\n- Which guides are set to launch automatically?\n- List guides that have expired\n- Show me all tooltip guides that are currently staged\n- Show me the full details for all banner guides (use expand=true)\n- What does guide xyz say to the user? (use guideId)\n- Find guides about onboarding new users\n- Search for guides related to single sign-on setup\n\nRETURNS:\n- List mode: summary info per guide (ID, name, description, state, type, launch method, scheduling timestamps)\n- Expanded mode: detailed guide metadata per guide (steps, polls, scheduling, recurrence, conversion, translation languages and statuses - no internal plumbing)\n- Single guide mode: guide metadata plus per-step structured content (step name, index, extracted text) and activation URL if eligible\n- When search is used: results include relevance score and searchType (semantic or fuzzy)\n\nFILTERING OPTIONS:\n- status: Filter by guide state - public, staged, draft, _pendingReview_, disabled\n- guideType: Filter by guide type - banner, tooltip, lightbox, walkthrough, whatsnew, building-block, group, training, launcher, mobile-lightbox\n- activation: Filter by launch method - auto (automatic/app launch), api (programmatic), badge, dom (element click), embed (embedded), launcher (guide/resource center), page (page view), feature (element click, mobile), form, track (track event)\n- expiration: Filter by expiration status - active (not expired), expired (past expiration date)","examples":["{\"activation\":\"\\u003cactivation\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"expand\":\"\\u003cexpand\\u003e\",\"expiration\":\"\\u003cexpiration\\u003e\",\"guideId\":\"\\u003cguideId\\u003e\",\"guideType\":\"\\u003cguideType\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"search\":\"\\u003csearch\\u003e\",\"searchType\":\"\\u003csearchType\\u003e\",\"skill\":\"listGuides\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listGuides","inputModes":["application/json"],"name":"listGuides","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tList Orchestrate email campaigns and their high-level metadata.\n\n\tIncludes standalone and journey-linked orchestrate emails (VoC emails excluded).\n\tWhen a user asks to list emails or orchestrate emails, use this tool.\n\t\n\nUSE FOR: Listing or browsing Orchestrate email campaigns. Discovering email IDs before calling get_orchestrate_email. Filtering by status (draft, public, scheduled, sent, review, disabled), appId, or name substring.\n\nEXAMPLES:\n- List all emails\n- List all standalone emails\n- List all orchestrate emails\n- List all omnichannel emails\n- Show orchestrate email campaigns\n- What email campaigns do we have?\n- Show sent emails\n- Show scheduled orchestrate emails\n- What orchestrate emails are in draft?\n- List email campaigns for this subscription\n- List orchestrate emails for app 12345\n- Find orchestrate emails named welcome\n\nNOT FOR: VoC email updates. In-app guides (use listGuides). Journey configuration and metadata without a journey ID (use list_orchestrate_journeys or get_orchestrate_journey).\n\nWORKFLOW: Use this tool to discover email IDs, then call get_orchestrate_email for full campaign configuration.\n\nRETURNS:\n- Orchestrate email identifiers and names (standalone and journey-linked)\n- Status and lifecycle timestamps (publishedAt, triggeredAt, executedAt); status is a UI lifecycle label for standalone emails (scheduled vs public follows the same start-time rule as the Orchestrate UI)\n- Subject and created/updated timestamps","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"name\":\"\\u003cname\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"skill\":\"listOrchestrateEmails\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listOrchestrateEmails","inputModes":["application/json"],"name":"listOrchestrateEmails","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tList Orchestrate journeys and their high-level metadata.\n\n\tUse this tool to discover journey IDs before calling getOrchestrateJourney or to browse journey lifecycle status.\n\t\n\nUSE FOR: Listing or browsing Orchestrate journeys. Discovering journey IDs before calling getOrchestrateJourney. Filtering by status (draft, review, scheduled, active, paused, completed, disabled).\n\nEXAMPLES:\n- List all orchestrate journeys\n- Show active orchestrate journeys\n- Show scheduled orchestrate journeys\n- What orchestrate journeys are paused?\n- List orchestrate journey campaigns for this subscription\n\nNOT FOR: Standalone or journey-linked email details without a journey ID (use listOrchestrateEmails or getOrchestrateEmail). In-app guides (use listGuides).\n\nWORKFLOW: Use this tool to discover journey IDs, then call getOrchestrateJourney for journey configuration and metadata (audience, goal, scheduling, step count).\n\nRETURNS:\n- Journey identifiers and names\n- status (UI lifecycle label; scheduled vs active follows the same start-date rule as the Orchestrate UI)\n- Lifecycle timestamps and primary appId","examples":["{\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"skill\":\"listOrchestrateJourneys\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listOrchestrateJourneys","inputModes":["application/json"],"name":"listOrchestrateJourneys","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tList Orchestrate journey templates shown in the UI template chooser (intent and layout metadata).\n\n\tThese ids mirror UI layouts - many include guides not yet supported by MCP journey create tools.\n\tFor MCP create: use createOrchestrateJourneyFromTemplate with templateId mcpSingleEmailJourneyTemplate, or build a custom graph via createOrchestrateJourneyFromJson (email steps and Conditional Split nodes; segment targeting, send schedule, and the condition of each Conditional Split are configured in the Orchestrate UI).\n\tProvide appId to filter to templates shown for that application platform (web vs mobile).\n\t\n\nUSE FOR: Discovering UI journey layout options and intent labels before discussing journey structure with the user.\n\nEXAMPLES:\n- What journey templates does Orchestrate offer?\n- List orchestrate journey templates for app 12345\n- Show welcome and onboarding journey template options\n\nNOT FOR: Listing existing journeys (use listOrchestrateJourneys). Creating a journey (use createOrchestrateJourneyFromTemplate or createOrchestrateJourneyFromJson). Assuming every listed id works with MCP create. Journey step graph for an existing journey (use getOrchestrateJourneySteps).\n\nWORKFLOW: Use to explain UI template options to the user. For built-in template create use createOrchestrateJourneyFromTemplate with templateId mcpSingleEmailJourneyTemplate; for custom graphs use createOrchestrateJourneyFromJson.\n\nRETURNS:\n- Template id, label, description, category, graphSummary, and platform support\n- UI layout catalog - not all ids are MCP-creatable; four platform-filtered entries when appId is provided","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"skill\":\"listOrchestrateJourneyTemplates\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listOrchestrateJourneyTemplates","inputModes":["application/json"],"name":"listOrchestrateJourneyTemplates","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\n\tCreates a draft Orchestrate journey from a built-in templateId and returns journeyId.\n\n\tSupply templateId only - the server applies a fixed messageGraph; do not send templateJson.\n\tSupported templateId values are listed in the templateId parameter enum in this tool's inputSchema.\n\tFor custom multi-email journeys, use createOrchestrateJourneyFromJson (templateJson inputSchema on that tool).\n\n\tAfter create, call getOrchestrateJourneySteps to verify the draft graph.\n\tThis tool only selects which built-in graph to apply. Segment targeting, send schedule, conversion goals, and email HTML body are not set here - configure them in the Orchestrate UI after create.\n\t\n\nUSE FOR: Creating a draft Orchestrate journey from a built-in template (single email today).\n\nEXAMPLES:\n- Create a draft Orchestrate journey named 'Welcome email' with templateId mcpSingleEmailJourneyTemplate for app 12345\n\nNOT FOR: Custom multi-email journeys (use createOrchestrateJourneyFromJson). UI layout ids from listOrchestrateJourneyTemplates. Updating graph after create. Setting segment targeting, send schedule, conversion goal, or email HTML content. Activating a journey.\n\nWORKFLOW: 1. Confirm single built-in template is enough (not createOrchestrateJourneyFromJson). 2. Call with a templateId from inputSchema enum. 3. getOrchestrateJourneySteps to verify.\n\nRETURNS:\n- journeyId: id of the created draft journey\n- journeyUrl: direct URL to the journey in the Pendo UI\n- status: draft\n- validationReport: graph validation summary","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"name\":\"\\u003cname\\u003e\",\"skill\":\"createOrchestrateJourneyFromTemplate\",\"subId\":\"\\u003csubId\\u003e\",\"templateId\":\"\\u003ctemplateId\\u003e\"}"],"id":"createOrchestrateJourneyFromTemplate","inputModes":["application/json"],"name":"createOrchestrateJourneyFromTemplate","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"\n\tCreates a draft Orchestrate journey from templateJson and returns journeyId.\n\n\tUse when the user wants a custom multi-email journey that createOrchestrateJourneyFromTemplate cannot express (single built-in template only).\n\tBuild templateJson to match the JSON Schema on the templateJson parameter in this tool's inputSchema.\n\n\tAfter create, call getOrchestrateJourneySteps to verify the draft graph.\n\tThis tool creates the graph layout (email steps, Conditional Split nodes with Yes and No branches, wait days between steps). Segment targeting, send schedule, conversion goals, email HTML body, and the condition of each Conditional Split are not set here - configure them in the Orchestrate UI after create.\n\t\n\nUSE FOR: Creating a draft Orchestrate journey when the user wants a custom multi-email journey with Conditional Splits.\n\nEXAMPLES:\n- User wants a welcome email then a follow-up email 3 days later: read templateJson inputSchema, build messageGraph with two Message nodes, set messageData.durationInDays to 3 on the first Message node (the wait before the follow-up) and durationInDays to 1 on the last Message node, call createOrchestrateJourneyFromJson for app 12345\n- User wants email A then a Conditional Split where the Yes branch goes to email B and the No branch to exit: add a nodeType Condition node with edgeType Yes and edgeType No edges after email A; configure the condition in the Orchestrate UI\n- User wants an initial email, then a Conditional Split where the Yes branch sends email 1 and the No branch sends email 2: build Start -\u003e Message (initial) -\u003e Condition with edgeType Yes to a Message named email 1 and edgeType No to a Message named email 2, each branch ending at its own Exit node; set messageData on all three Message nodes; configure the condition in the Orchestrate UI\n\nNOT FOR: Built-in single-email create (use createOrchestrateJourneyFromTemplate). Guide nodes. Updating graph after create. Setting segment targeting, send schedule, conversion goal, email HTML content, or the condition of a Conditional Split in templateJson. Activating a journey.\n\nWORKFLOW: 1. Confirm multi-email need (not createOrchestrateJourneyFromTemplate). 2. Construct templateJson from templateJson inputSchema. 3. Create. 4. getOrchestrateJourneySteps to verify.\n\nRETURNS:\n- journeyId: id of the created draft journey\n- journeyUrl: direct URL to the journey in the Pendo UI\n- status: draft\n- validationReport: graph validation summary","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"name\":\"\\u003cname\\u003e\",\"skill\":\"createOrchestrateJourneyFromJson\",\"subId\":\"\\u003csubId\\u003e\",\"templateJson\":\"\\u003ctemplateJson\\u003e\"}"],"id":"createOrchestrateJourneyFromJson","inputModes":["application/json"],"name":"createOrchestrateJourneyFromJson","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"\n\tSets the start date on an existing Orchestrate journey schedule.\n\n\tOnly startDate can be changed via MCP. Timezone always comes from the subscription. Existing endDate, constraints, and ignoreThrottling are preserved.\n\tCannot update schedule on active, paused, completed, or disabled journeys.\n\t\n\nUSE FOR: Updating when a draft or review Orchestrate journey should start after createOrchestrateJourneyFromTemplate or createOrchestrateJourneyFromJson.\n\nEXAMPLES:\n- Set journey abc123 to start on March 15, 2026 at 9:00 AM subscription time\n- Schedule journey xyz to start next Monday\n\nNOT FOR: Creating a journey (use createOrchestrateJourneyFromTemplate or createOrchestrateJourneyFromJson). Changing end date, delivery constraints, or ignoreThrottling (use the Orchestrate UI).\n\nRETURNS:\n- journeyId: updated journey id\n- journeyUrl: direct URL to the journey in the Pendo UI\n- status: journey lifecycle label after update","examples":["{\"journeyId\":\"\\u003cjourneyId\\u003e\",\"skill\":\"setOrchestrateJourneySchedule\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"setOrchestrateJourneySchedule","inputModes":["application/json"],"name":"setOrchestrateJourneySchedule","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"\n\tSets or clears the conversion goal on an existing Orchestrate journey.\n\n\tOnly the goal fields change. Works on draft and review journeys only.\n\tCannot update goal on active, paused, completed, or disabled journeys.\n\t\n\nUSE FOR: Updating the journey conversion goal after createOrchestrateJourneyFromTemplate or createOrchestrateJourneyFromJson.\n\nEXAMPLES:\n- User wants goal 'home page': listCountables or searchEntities on journey app, one match -\u003e setOrchestrateJourneyGoal with that id\n- User wants goal 'Settings', search returns Account Settings and App Settings -\u003e ask user which one, then setOrchestrateJourneyGoal with the chosen id only\n- Clear the conversion goal on journey xyz (itemType noGoal, no itemId)\n\nNOT FOR: Creating a journey (use createOrchestrateJourneyFromTemplate or createOrchestrateJourneyFromJson). Changing audience, schedule, or graph. Setting a goal without calling listCountables or searchEntities first (never invent or guess itemId). Calling this tool when search returned multiple matches but the user has not picked one (never auto-pick the first result).\n\nWORKFLOW: 1. Load the journey (getOrchestrateJourney or create response) to get journeyId and appId. 2. For Page, Feature, or TrackType goals, call listCountables or searchEntities first with the user's phrase (e.g. \"home page\") and appId scoped to the journey app - do not guess itemId. 3. If exactly one match, use its id. If two or more matches, STOP: list each candidate (id and name) and ask the user which one is the goal - do not call setOrchestrateJourneyGoal until they choose; never default to the first result. If zero matches, tell the user and refine search or ask for a different name. 4. Call setOrchestrateJourneyGoal with itemType and the chosen id. 5. To clear, call with itemType noGoal and omit itemId.\n\nRETURNS:\n- journeyId: updated journey id\n- journeyUrl: direct URL to the journey in the Pendo UI\n- status: journey lifecycle label after update","examples":["{\"itemId\":\"\\u003citemId\\u003e\",\"itemType\":\"\\u003citemType\\u003e\",\"journeyId\":\"\\u003cjourneyId\\u003e\",\"skill\":\"setOrchestrateJourneyGoal\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"setOrchestrateJourneyGoal","inputModes":["application/json"],"name":"setOrchestrateJourneyGoal","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"\n\tSets journey audience from a saved segment id on an existing Orchestrate journey.\n\n\tRequires segmentId from segmentList - not inline audience JSON. Allowed on draft, review, and paused journeys only (same as Orchestrate UI segment card). Cannot update on active (includes UI scheduled journeys), completed, or disabled journeys.\n\tOptional reachInactiveVisitors and retainVisitorsAfterEntry preserve existing journey values when omitted.\n\t\n\nUSE FOR: Updating the journey audience after createOrchestrateJourneyFromTemplate or createOrchestrateJourneyFromJson.\n\nEXAMPLES:\n- User wants audience 'power users': segmentList with substring power users, one match -\u003e setOrchestrateJourneySegment with that id\n- User wants 'Active accounts', segmentList returns Active accounts (sub) and Active accounts (prod) -\u003e ask user which one, then setOrchestrateJourneySegment with the chosen id only\n- Update journey xyz segment and enable reachInactiveVisitors\n- Set journey xyz audience to seg-123 and turn on retain visitors after entry (retainVisitorsAfterEntry: true)\n\nNOT FOR: Creating a journey (use createOrchestrateJourneyFromTemplate or createOrchestrateJourneyFromJson). Changing goal, schedule, or graph. Inline or custom audience JSON. Setting noOne audience. Setting audience without calling segmentList first (never invent or guess segmentId). Calling this tool when segmentList returned multiple matches but the user has not picked one (never auto-pick the first result).\n\nWORKFLOW: 1. Load the journey (getOrchestrateJourney or create response) to get journeyId. 2. Call segmentList first with substring set to the user's segment name or phrase (e.g. \"power users\") - do not guess segmentId and do not pass a segment name as segmentId. 3. If exactly one match, use its id. If two or more matches, STOP: list each candidate (id and name) and ask the user which one is the audience segment - do not call setOrchestrateJourneySegment until they choose; never default to the first result. If zero matches, tell the user and refine substring or ask for a different name. 4. Call setOrchestrateJourneySegment with journeyId and the chosen segmentId. Pass reachInactiveVisitors or retainVisitorsAfterEntry only when the user explicitly asked to change them; otherwise omit them.\n\nRETURNS:\n- journeyId: updated journey id\n- journeyUrl: direct URL to the journey in the Pendo UI\n- status: journey lifecycle label after update","examples":["{\"journeyId\":\"\\u003cjourneyId\\u003e\",\"reachInactiveVisitors\":\"\\u003creachInactiveVisitors\\u003e\",\"retainVisitorsAfterEntry\":\"\\u003cretainVisitorsAfterEntry\\u003e\",\"segmentId\":\"\\u003csegmentId\\u003e\",\"skill\":\"setOrchestrateJourneySegment\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"setOrchestrateJourneySegment","inputModes":["application/json"],"name":"setOrchestrateJourneySegment","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"\n\tSets the display name on an existing Orchestrate journey header.\n\n\tOnly the journey title changes. Same edit rules as the journey header in the Pendo UI:\n\tallowed on any journey status when the caller has journey edit permission (enforced before this tool runs).\n\t\n\nUSE FOR: Renaming an existing Orchestrate journey (UI-created or MCP-created). Use getOrchestrateJourney or listOrchestrateJourneys to obtain the journeyId.\n\nEXAMPLES:\n- Rename journey xyz to Welcome onboarding flow\n\nNOT FOR: Creating a journey. Changing description, audience, goal, schedule, graph, or lifecycle status. Setting reachInactiveVisitors or retainVisitorsAfterEntry (use setOrchestrateJourneySegment).\n\nWORKFLOW: 1. Load the journey (getOrchestrateJourney or create response) for journeyId. 2. Call setOrchestrateJourneyName with name. 3. Confirm with getOrchestrateJourney.\n\nRETURNS:\n- journeyId: updated journey id\n- journeyUrl: direct URL to the journey in the Pendo UI\n- name: journey title after update\n- status: journey lifecycle label after update","examples":["{\"journeyId\":\"\\u003cjourneyId\\u003e\",\"name\":\"\\u003cname\\u003e\",\"skill\":\"setOrchestrateJourneyName\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"setOrchestrateJourneyName","inputModes":["application/json"],"name":"setOrchestrateJourneyName","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"\n\tSets the description on an existing Orchestrate journey header.\n\n\tOnly the journey header description changes. Same edit rules as the journey header in the Pendo UI:\n\tallowed on any journey status when the caller has journey edit permission (enforced before this tool runs).\n\t\n\nUSE FOR: Updating the header description on an existing Orchestrate journey. Use getOrchestrateJourney or listOrchestrateJourneys to obtain the journeyId.\n\nEXAMPLES:\n- Set description on journey xyz to explain the campaign purpose\n\nNOT FOR: Creating a journey. Changing name, audience, goal, schedule, graph, or lifecycle status. Setting reachInactiveVisitors or retainVisitorsAfterEntry (use setOrchestrateJourneySegment).\n\nWORKFLOW: 1. Load the journey (getOrchestrateJourney or create response) for journeyId. 2. Call setOrchestrateJourneyDescription with description. 3. Confirm with getOrchestrateJourney.\n\nRETURNS:\n- journeyId: updated journey id\n- journeyUrl: direct URL to the journey in the Pendo UI\n- name: journey title after update\n- description: journey header description after update\n- status: journey lifecycle label after update","examples":["{\"description\":\"\\u003cdescription\\u003e\",\"journeyId\":\"\\u003cjourneyId\\u003e\",\"skill\":\"setOrchestrateJourneyDescription\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"setOrchestrateJourneyDescription","inputModes":["application/json"],"name":"setOrchestrateJourneyDescription","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"\n\tSaves HTML email body content for an email step inside an Orchestrate journey (use messageId from getOrchestrateJourneySteps).\n\n\tJourney email steps only (messageId from getOrchestrateJourneySteps). Standalone HTML emails are not supported via MCP.\n\tOnly HTML editor emails can be updated (raw HTML body). Template or block-builder emails (guide-based layouts) are not supported. Running emails are blocked; scheduled public emails remain editable (same as the HTTP content API).\n\tWhen emailType is unset, it is treated as marketing. Unsubscribe: use the exact literal {{ UnsubscribeURI }} in the HTML (spacing matters). Required for marketing emails and when emailType is unset; optional for transactional. Missing token on marketing emails returns a validation error.\n\tPersonalization is optional. Any {visitor.../} or {account.../} token requires visitorMetadataSchema (and accountMetadataSchema for account fields) first - every token key must exactly match a key returned by those tools for this subscription. Never invent, guess, or assume field names (including common names like firstname, email, company, or role). Map each returned key to a single-brace email token (e.g. visitor.agent.email -\u003e {visitor.agent.email/}, visitor.agent.firstname -\u003e {visitor.agent.firstname|Friend/}).\n\tPersonalization token names are not validated at save (same as the HTTP content API); calling the schema tools first is the only way to avoid invalid tokens.\n\t\n\nUSE FOR: Saving or updating raw HTML on a journey email step (messageId from getOrchestrateJourneySteps). HTML editor emails only (not template emails). Use getOrchestrateEmail to confirm emailId and status.\n\nEXAMPLES:\n- Save static HTML for journey email step abc123 including {{ UnsubscribeURI }} (no personalization tokens - schema tools not required)\n- User wants Hi {firstname}: call visitorMetadataSchema first; only if visitor.agent.firstname (or another returned key) exists, use {visitor.agent.firstname|there/}; if no name field exists, tell the user - do not invent firstname\n- User wants account industry in the email: accountMetadataSchema first, find exact key (e.g. account.salesforce.industry), then {account.salesforce.industry/} - never guess account.custom.industry\n\nNOT FOR: Standalone HTML emails (use the Orchestrate UI until standalone HTML MCP is available). Template or block-builder emails (guide-based layouts, not raw HTML). Changing email settings such as sender, subject, or status (use the Orchestrate UI). Running emails. Empty HTML body. Adding any {visitor.../} or {account.../} token without calling visitorMetadataSchema and accountMetadataSchema first (never invent or guess metadata field names). Substituting a different metadata key when the user requested field is not in the schema response.\n\nWORKFLOW: 1. Use getOrchestrateJourney and getOrchestrateJourneySteps to get the existing email step messageId (emailId). This tool updates HTML only - it does not create email steps. Confirm the step is an HTML editor email (not a template or block-builder email) and is not running. 2. If the HTML will include any {visitor.../} or {account.../} personalization token, STOP: call visitorMetadataSchema first (and accountMetadataSchema for any account token) before writing HTML - do not call updateOrchestrateEmailContent until schema tools have returned. Use only keys present in those responses; each token must exactly match a returned key (visitor.agent.email -\u003e {visitor.agent.email/}). Never invent, guess, or assume field names - not even common ones like firstname, email, company, or role. If the user asked for a field that is not in the schema response, tell them it is not available on this subscription; do not substitute a similar-sounding key. If not personalizing, skip this step. Build HTML; for marketing emails or when emailType is unset, include the exact literal {{ UnsubscribeURI }} (optional for transactional). 3. Call updateOrchestrateEmailContent with emailId and htmlContent.\n\nRETURNS:\n- resultSummary: human-readable summary of the update\n- validationReport: validation result (valid true with no issues on success)\n- emailId: updated journey step messageId\n- emailUrl: direct URL to the email in the Pendo UI\n- name: email display name\n- status: email lifecycle status after update\n- journeyId: parent journey id for the email step\n- journeyUrl: direct URL to the parent journey in the Pendo UI","examples":["{\"emailId\":\"\\u003cemailId\\u003e\",\"htmlContent\":\"\\u003chtmlContent\\u003e\",\"skill\":\"updateOrchestrateEmailContent\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"updateOrchestrateEmailContent","inputModes":["application/json"],"name":"updateOrchestrateEmailContent","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","orchestrateMcpWrite"]},{"description":"Returns all product areas for a subscription - their IDs, names, and descriptions. Supports optional fuzzy search and pagination.\n\nUSE FOR: Enumerating all product areas, or finding a productAreaId to pass to other tools that require one. Use this when the user asks about available product areas or when you need to present them a list to choose from.\n\nEXAMPLES:\n- What product areas do we have?\n- List all product areas for this subscription\n- What product area should I use for onboarding? - find the matching name and get its ID\n- Show me all available product areas\n\nNOT FOR: Querying activity or engagement metrics within a product area.\n\nRETURNS:\n- Array of product areas with: id, name, description","examples":["{\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"search\":\"\\u003csearch\\u003e\",\"skill\":\"listProductAreas\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listProductAreas","inputModes":["application/json"],"name":"listProductAreas","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Lists the Pendo Spaces the current user can access in this subscription. A Pendo Space is a collaborative canvas of product artifacts (pages, features, guides, notes, etc.) that a team curates together; think of it as a shared workspace or board inside Pendo. Returns JSON from the Spaces service (opaque shape - field names depend on the Spaces API response). Use this to discover a space id before calling `getAgentContext` with `resourceType` \"space\" and that id as `resourceId`.","examples":["{\"skill\":\"listSpaces\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listSpaces","inputModes":["application/json"],"name":"listSpaces","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Returns a list of themes for a subscription. Themes define the visual styling applied to guides and other in-app content. Supports optional filtering by application and fuzzy search.\n\nUSE FOR: Listing available themes, finding a theme by name, or getting a theme ID to reference in other tools. Use when the user asks about available themes or visual styles for their guides.\n\nEXAMPLES:\n- What themes do we have?\n- List all themes for this subscription\n- Show me themes for app 12345\n- Find a theme named 'Dark Mode'\n\nNOT FOR: Modifying or creating themes. Viewing guide content or guide metrics.\n\nRETURNS:\n- Array of themes with: id, name, appId, tags, archive status, buildingBlocks (visual styling properties), cssUrl (supplemental CSS file URL if present)","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"search\":\"\\u003csearch\\u003e\",\"skill\":\"listThemes\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listThemes","inputModes":["application/json"],"name":"listThemes","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Returns tracked (curated) issue definitions and their associated conversation and event IDs for a given AI agent and time window. Tracked issues are user-defined error or failure categories; conversations are attributed to them by LLM classification.\n\nUSE FOR: Listing all tracked issues defined for an agent and discovering which conversations belong to each. The returned conversationIds and eventIds can be used to scope a detailed analysis of a specific tracked issue.\n\nEXAMPLES:\n- What tracked issues are defined for my agent?\n- Which conversations belong to the 'incorrect answer' tracked issue?\n- Show me the tracked issues for my agent over the last 30 days.\n\nNOT FOR: Detected (auto-clustered) issues or aggregate volume metrics; this tool returns only user-defined tracked issues.\n\nRETURNS:\n- Per tracked issue: id, name, description, severity, status, summary, numConversations, conversationIds, eventIds.\n\nLARGE DATASETS: If this tool returns too much data or times out for a given date range, do NOT simply narrow the overall date range - that silently discards data outside the narrowed window. Instead, split the request into sequential non-overlapping sub-windows (e.g., for 30 days: three ~10-day windows such as days 1-10, 11-20, 21-30). Call the tool once per sub-window, then merge results by summing conversation counts across windows. This preserves the full dataset.\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"listTrackedIssues\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listTrackedIssues","inputModes":["application/json"],"name":"listTrackedIssues","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Returns tracked (curated) use case definitions and their associated conversation and event IDs for a given AI agent and time window. Tracked use cases are user-defined categories; conversations are attributed to them by LLM classification.\n\nUSE FOR: Listing all tracked use cases defined for an agent and discovering which conversations belong to each. Returns conversationIds and eventIds that identify the conversations attributed to each tracked use case for further analysis.\n\nEXAMPLES:\n- What tracked use cases are defined for my agent?\n- Which conversations belong to the 'billing support' tracked use case?\n- Show me the tracked use cases for my agent over the last 30 days.\n\nNOT FOR: Unsupervised clustering of conversations into emergent topics, or aggregate volume metrics - this tool only lists predefined tracked use cases and the conversations attributed to them.\n\nRETURNS:\n- Per tracked use case: id, name, summary, numConversations, conversationIds, eventIds.\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"listTrackedUseCases\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listTrackedUseCases","inputModes":["application/json"],"name":"listTrackedUseCases","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get AI agent conversation clustering analysis with comprehensive metrics. Analyzes conversations and prompts, grouping them by semantic topics/use cases.\n\nEXAMPLES:\n- What use cases has my AI agent been used for in the last 30 days?\n- What are the main topics users are asking my AI agent about?\n- Show me prompt clusters for my chat agent over the past 2 weeks.\n- Cluster recent conversations for my agent to find common themes.\n\nRETURNS:\n- Per-cluster metrics: clusterName, clusterSummary, numConversations, numPrompts, numVisitors, numAccounts, numRagePrompts, numRagePromptsOverNumPrompts, retentionRate, retainedVisitors, totalVisitors, visitorIds, accountIds, conversationIds, and ragePromptConversationIds.\n\nThe maximum time range for this tool is 90 days.","examples":["{\"agentId\":\"\\u003cagentId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"granularity\":\"\\u003cgranularity\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"listUseCases\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listUseCases","inputModes":["application/json"],"name":"listUseCases","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"List the visitors that match a segment and get a summary of the cohort. Returns {summary, rows}: summary has numVisitors and numAccounts (the true segment totals, independent of limit); rows is the list of matched visitors with visitorId and any requested metadata fields, capped by limit. The cohort is defined by a segmentPipeline - either a saved Pendo segment reference or a full inline pipeline produced by the segment-builder tool.\n\nUSE FOR: Listing the members of a segment/cohort and getting its visitor and account totals.\n\nEXAMPLES:\n- List the visitors in segment X\n- Who are the visitors in this cohort?\n- How many visitors and accounts are in this segment?\n- Show me visitors in segment X with their email and role\n\nRETURNS:\n- summary: numVisitors, numAccounts (segment totals, independent of limit)\n- rows: visitorId plus requested fields in a metadata object keyed by metadata path (for example, \"metadata.auto.lastvisit\"), capped by limit; each row also includes a name (the configured visitor display name) when the visitorDisplayName setting is set","examples":["{\"limit\":\"\\u003climit\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"select\":\"\\u003cselect\\u003e\",\"skill\":\"listVisitors\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"listVisitors","inputModes":["application/json"],"name":"listVisitors","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Count how many unique business OBJECTS (e.g. dashboards, venues, documents, orders) were active over a date range, where an object is identified by one event property. Returns a single scalar count (distinct object_id) for the chosen property within the window. Use this for questions about a business object - including when a page or feature shares the same name (e.g. count 'dashboards' as the object, not the 'Dashboards' page). An object is a custom event property designated as an analyzable entity, distinct from pages, features, and track events. The aggregation is built by the Pendo analytics gateway, not in this service.\n\nUSE FOR: Scalar 'how many unique \u003cobjects\u003e were active' questions where \u003cobject\u003e is a business object identified by a single event/metadata property over one time window - even if a page or feature shares the object's name. When the object name is ambiguous (could be a page/feature) or you don't know its event property, ground it with listCustomObjects first.\n\nEXAMPLES:\n- How many unique venues were active in the last 30 days?\n- Count distinct documents touched between 2025-01-01 and 2025-01-31\n- How many unique order IDs were active last week?\n\nNOT FOR: Ranking objects (e.g. 'which dashboards had the most visitors') - use objectAnalyticsBreakdown. Per-page, per-feature, or per-track-event usage - use entityUsage. Per-visitor or per-account app usage - use appUsage. Time series, group-by, or comparisons are not supported here.\n\nRETURNS:\n- activeCount: the number of distinct objects active in the window\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- meta.objectProperty: the field and kind the count was computed over\n- meta.promotedAt (epoch ms) and meta.effectiveDateRange: present only when the requested range begins before the object was promoted; the window is floored to the promotion time (a range entirely before promotion returns activeCount 0)","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"objectProperty\":\"\\u003cobjectProperty\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"objectAnalyticsActiveCount\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"objectAnalyticsActiveCount","inputModes":["application/json"],"name":"objectAnalyticsActiveCount","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Analyze the individual business OBJECTS (e.g. dashboards, venues, documents, orders) of one kind over a date range, where an object is identified by one event property. Use this for questions about a business object - including when a page or feature shares the same name (e.g. treat 'dashboards' as objects, not the 'Dashboards' page). An object is a custom event property designated as an analyzable entity, distinct from pages, features, and track events. Two modes, selected by the 'measures' argument:\n(1) RANKING (default, measures omitted or ['uniqueVisitors']): a ranked list of objects by how many unique visitors were active on each - 'which \u003cobjects\u003e had the most/least visitors'. Returns one row per object (objectId, objectName, uniqueVisitors), top-N by sortBy, optionally scoped by a segment.\n(2) AVERAGES (measures includes 'avgObjectsPerVisitor' and/or 'avgTimePerObject'): a single subscription-wide summary scalar per measure - 'on average how many \u003cobjects\u003e does each visitor use', 'average time spent per \u003cobject\u003e' - matching the object-details page tiles. These are aggregates across ALL objects, NOT per-object rows, so sortBy/limit do not apply.\nThe aggregation is built by the Pendo analytics gateway, not in this service.\n\nUSE FOR: Ranking the individual objects of one business-object kind by distinct active visitors - e.g. which dashboards had the most visitors, busiest venues, most-visited documents - even if a page or feature shares the object's name. Also the home for per-object AVERAGE and TIME questions about a business object, e.g. 'average time per dashboard' or 'average dashboards per visitor'. When the object name is ambiguous (could be a page/feature) or you don't know its event property, ground it with listCustomObjects first.\n\nEXAMPLES:\n- Which dashboards had the most visitors last month?\n- Which venues had the most unique visitors in the last 30 days?\n- Top 10 documents by distinct visitors between 2025-01-01 and 2025-01-31\n- Least-visited order IDs over the last week\n- On average, how many distinct dashboards does each visitor interact with over the last 30 days?\n- On average, how much time do visitors spend on each dashboard over the last 30 days?\n\nNOT FOR: A single 'how many unique objects' scalar - use objectAnalyticsActiveCount. Per-page, per-feature, or per-track-event usage - use aggregateEntityUsage. Per-visitor or per-account app usage - use appUsage. Page dwell-time or time-on-page - that is page analytics, not a business object; 'time spent on a business object' is this tool, page dwell-time is not.\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD); meta.compareToDateRange when comparing; meta.measures: the requested measures\n- meta.objectProperty: the field and kind analyzed\n- RANKING mode: rows - one per object with objectId, objectName, uniqueVisitors, ranked by sortBy. In comparison mode uniqueVisitors splits into current_/prior_/change_/pctChange_ columns.\n- AVERAGES mode: summary - a single object keyed by the requested average measure(s), e.g. {avgObjectsPerVisitor, avgTimePerObject}; no rows.\n- meta.promotedAt (epoch ms) and meta.effectiveDateRange: present only when the requested range begins before the object was promoted; the window is floored to the promotion time (rows before it are excluded) and, if the whole range predates promotion, rows/summary are empty","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"compareToDateRange\":\"\\u003ccompareToDateRange\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"measures\":\"\\u003cmeasures\\u003e\",\"objectProperty\":\"\\u003cobjectProperty\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"objectAnalyticsBreakdown\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"objectAnalyticsBreakdown","inputModes":["application/json"],"name":"objectAnalyticsBreakdown","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Track how engagement with a business OBJECT (e.g. dashboards, venues, documents, orders) changed over time, where an object is identified by one event property. Groups the date range into buckets of the requested period (daily/weekly/monthly) and returns one row per bucket. The 'metric' param chooses what each bucket measures: avgTimePerObject (DEFAULT) = average time spent per object - this is what \"engagement\" with objects means; numEvents = events on objects (\"activity\"/event volume); numVisitors = distinct visitors engaging objects; numSubjects = distinct active objects (the time-bucketed form of objectAnalyticsActiveCount). Use this for questions about a business object - including when a page or feature shares the same name (e.g. trend 'dashboards' as the object, not the 'Dashboards' page). An object is a custom event property designated as an analyzable entity, distinct from pages, features, and track events. The aggregation is built by the Pendo analytics gateway, not in this service.\n\nUSE FOR: Trend questions about a business object over a window - e.g. 'how has weekly engagement with dashboards changed over the last 3 months?' (engagement -\u003e avgTimePerObject, the default), 'event volume per venue by month' (-\u003e numEvents), 'daily distinct visitors on documents over the last 30 days' (-\u003e numVisitors), 'active order IDs per week' (-\u003e numSubjects) - even if a page or feature shares the object's name. When the object name is ambiguous (could be a page/feature) or you don't know its event property, ground it with listCustomObjects first.\n\nEXAMPLES:\n- How has weekly engagement with dashboards changed over the last 3 months?\n- Monthly event volume per venue over the last year\n- Daily distinct visitors engaging documents over the last 30 days\n- Active order IDs per week over the last quarter\n\nNOT FOR: A single scalar for one window - use objectAnalyticsActiveCount. Ranking individual objects - use objectAnalyticsBreakdown. Per-page, per-feature, or per-track-event usage over time - use entityUsageTimeSeries. Whole-app usage over time - use appUsageTimeSeries.\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- meta.objectProperty: the field and kind the series was computed over\n- period: echoed bucket size (daily|weekly|monthly)\n- metrics: the metric name returned per bucket (avgTimePerObject, numEvents, numVisitors, or numSubjects)\n- rows: one entry per time bucket with bucket (YYYY-MM-DD or YYYY-MM), startTime (timestamp object {iso, display}), and the metric value; buckets zero-fill empty periods\n- meta.promotedAt (epoch ms) and meta.effectiveDateRange: present only when the requested range begins before the object was promoted; the window is floored to the promotion time (a range entirely before promotion returns no buckets)","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"metric\":\"\\u003cmetric\\u003e\",\"objectProperty\":\"\\u003cobjectProperty\\u003e\",\"period\":\"\\u003cperiod\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"objectAnalyticsTimeSeries\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"objectAnalyticsTimeSeries","inputModes":["application/json"],"name":"objectAnalyticsTimeSeries","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Rank or trend the events/actions on one kind of business OBJECT (e.g. dashboards, venues, documents, orders) over a date range - the event types (pages, features, track events) fired while the object's identifying property is present. Two modes: (1) default - rank those events by count for 'what are the most common actions/events on a \u003cobject\u003e'; (2) set trend='up' or 'down' - rank which events are TRENDING up or down on the object, comparing the requested window against the equal-length window immediately before it (rows carry currentPeriodEvents, previousPeriodEvents, pctChange, ranked by pctChange). This is THE tool for 'which events are trending up/down across my \u003cobjects\u003e' - it scopes to the object and computes the period-over-period change for you; do not hand-compute a trend by pulling two windows of unscoped track events from another tool. An object is a custom event property designated as an analyzable entity (distinct from pages, features, and track events), including when a page or feature shares the object's name. Returns one row per event type. The aggregation is built by the Pendo analytics gateway, not in this service.\n\nUSE FOR: The events/actions on a business object - either the most common ('the most common actions taken on dashboards this month', 'top interactions on a document') or, with trend='up'/'down', which are TRENDING ('which events are trending up across dashboards', 'what actions on venues are trending down vs the previous period'). When the object name is ambiguous (could be a page/feature) or you don't know its event property, ground it with listCustomObjects first.\n\nEXAMPLES:\n- What are the most common actions taken on dashboards this month?\n- Top 10 event types on venues in the last 30 days\n- Which actions were performed most on documents between 2025-01-01 and 2025-01-31?\n- Which events are trending up across dashboards in the last 30 days?\n- What actions on venues are trending down compared with the previous period?\n\nNOT FOR: How many unique objects were active - use objectAnalyticsActiveCount. Ranking the objects themselves by visitors (which dashboards had the most visitors) or per-object averages/time - use objectAnalyticsBreakdown. Per-page, per-feature, or per-track-event usage NOT scoped to a business object - use aggregateEntityUsage. Do NOT answer 'which events are trending on \u003cobjects\u003e' by comparing two windows of aggregateEntityUsage/entityUsage yourself - that counts ALL events unscoped to the object; set trend on this tool instead.\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- meta.objectProperty: the field and kind analyzed\n- meta.trend: the trending direction, when trend mode is requested\n- meta.compareToDateRange: the previous equal-length window (startDate, endDate) the trend compares against, when trend mode is requested\n- rows (default): one per event type performed on the object, each with eventId, eventName, eventKind (page/feature/track type) and numEvents, ranked by numEvents\n- rows (trend mode): one per event type, each with eventId, eventName, eventKind, currentPeriodEvents, previousPeriodEvents and pctChange, ranked by pctChange\n- meta.promotedAt (epoch ms) and meta.effectiveDateRange: present only when the requested range begins before the object was promoted; the window is floored to the promotion time (rows before it are excluded) and, if the whole range predates promotion, rows are empty","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"objectProperty\":\"\\u003cobjectProperty\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"objectEventBreakdown\",\"sortBy\":\"\\u003csortBy\\u003e\",\"sortOrder\":\"\\u003csortOrder\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"trend\":\"\\u003ctrend\\u003e\"}"],"id":"objectEventBreakdown","inputModes":["application/json"],"name":"objectEventBreakdown","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"A tool designed for running PES (product engagement score) queries. For any score fields that aren't required or provided, default saved PES configuration options are used.\n\nUSE FOR: Analyzing the PES, which is made up of scores from feature adoption, stickiness, and growth.\n\nEXAMPLES:\n- What is the PES for this feature?\n- What is adoption score for a specific feature, page, and track event?\n- What is the stickiness score for accounts, weekly over monthly? (This may expressed as WAA over MAA)\n- What is the stickiness score for visitors, daily over monthly, excluding weekends? (This may expressed as DAU over MAU)\n- What is the growth score for accounts?\n\nRETURNS:\n- PES score and component scores (adoption, stickiness, growth)\n- Individual component scores (adoption, stickiness, growth)\n- For stickiness rows: a stickinessConfig object (userBase, numerator, denominator, excludeWeekends, startDate, endDate) describing exactly which definition produced the number - state this definition when reporting the score, since fields like excludeWeekends may be inherited from saved config rather than the request\n\nThe maximum time range for this tool is 180 days.","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"adoptionUserBase\":\"\\u003cadoptionUserBase\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"blacklist\":\"\\u003cblacklist\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"excludeWeekends\":\"\\u003cexcludeWeekends\\u003e\",\"featureIds\":\"\\u003cfeatureIds\\u003e\",\"growthUserBase\":\"\\u003cgrowthUserBase\\u003e\",\"pageIds\":\"\\u003cpageIds\\u003e\",\"scores\":\"\\u003cscores\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"productEngagementScore\",\"startDate\":\"\\u003cstartDate\\u003e\",\"stickinessDenominator\":\"\\u003cstickinessDenominator\\u003e\",\"stickinessNumerator\":\"\\u003cstickinessNumerator\\u003e\",\"stickinessUserBase\":\"\\u003cstickinessUserBase\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"trackEventIds\":\"\\u003ctrackEventIds\\u003e\"}"],"id":"productEngagementScore","inputModes":["application/json"],"name":"productEngagementScore","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"\nReturn all pages, features, or track types belonging to a product area, including those with zero activity in the date range.\n\nUse this tool when you need to identify unused or low-engagement entities within a product area - for example, \"which features in the Onboarding product area have had no usage this quarter?\" Every member of the product area is returned (up to the requested limit) with activity data left-joined onto it, so entities that generated no events still appear in the result set with numEvents: 0 rather than being filtered out. When the product area has more members than the limit, results are sorted by the requested sort field and truncated - absence from the results in that case means the entity fell outside the limit, not that it lacked activity.\n\nSupports optional segmentPipeline filtering: when provided, activity metrics reflect only visitors in the segment scope, but all product area members are still returned (zero-activity rows remain for entities with no segment activity).\n\n\nUSE FOR: Listing all members of a product area with their activity metrics, including entities with zero events.\n\nEXAMPLES:\n- Which features in the Onboarding product area have zero usage this quarter? -\u003e entityType='feature', productAreaId='\u003cid\u003e', sort=['+numEvents'], dateRange={range:'custom', startDate:'2025-01-01', endDate:'2025-03-31'}\n- What pages in the Analytics product area should we consider sunsetting? -\u003e entityType='page', productAreaId='\u003cid\u003e', sort=['+numEvents'], limit=50, dateRange={range:'relative', lastNDays:90}\n- Which pages in product area X have zero activity from identified visitors? -\u003e Use buildPendoSegment to create the identified-visitor scope, then pass its pipeline output verbatim as segmentPipeline; entityType='page', productAreaId='\u003cid\u003e', segmentPipeline='\u003cbuildPendoSegment pipeline output\u003e', sort=['+numEvents'], dateRange={range:'relative', lastNDays:30}\n\nNOT FOR: Ranked activity across all entity types regardless of product area membership.\n\nRETURNS:\n- All members of the product area for the given entity type\n- Each row includes: entity ID, name, description, numEvents, numMinutes, uniqueVisitorCount, uniqueAccountCount, daysActive, avgMinutesPerVisitor, avgDaysActivePerVisitor\n- Entities with no activity in the date range appear with all metrics set to 0\n- When segmentPipeline is provided, metrics reflect only activity from visitors in that segment scope; zero-activity rows still appear for entities with no segment activity\n\nSORT OPTIONS:\n- numEvents - total event count (default: ascending, to surface unused entities first)\n- numMinutes, uniqueVisitorCount, uniqueAccountCount, daysActive\n\nThe maximum time range for this tool is 367 days.","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"entityType\":\"\\u003centityType\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"period\":\"\\u003cperiod\\u003e\",\"productAreaId\":\"\\u003cproductAreaId\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"productAreaMemberActivity\",\"sort\":\"\\u003csort\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"productAreaMemberActivity","inputModes":["application/json"],"name":"productAreaMemberActivity","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Run a funnel and return conversion and timing metrics for an ordered sequence of 2-3 steps. By default the unit of analysis is the unique VISITOR: each visitor counts toward step N only if they completed every prior step in order. Set funnelBy='object' to instead key the funnel on a business OBJECT (e.g. dashboards, venues, orders) identified by an event property - then each distinct object counts toward a step, answering how objects move through the sequence: 'of the objects that reached step A, how many went on to reach step B?', 'how long do the objects take to get from step A to step B?', or 'where do the objects drop off?'. The steps are ALWAYS phrased as visitor actions ('someone viewed a page', 'someone clicked a feature') - that phrasing is NOT a signal for visitor mode; pick the unit from what the question COUNTS, so any question about 'our \u003cobjects\u003e' progressing, completing, or dropping off is funnelBy='object'. By default each entity is counted at most once (analyzeBy='uniqueVisitors'); set analyzeBy='totalAttempts' to instead count every pass through the funnel, where a single entity can complete it multiple times (each attempt must finish within funnelTimeout minutes). Use ONLY for sequence questions where ordering matters - one thing happening and then another. Do NOT use for unordered set-overlap questions like 'how many visitors did both X and Y?' - those are answered by building a segment instead. This is a slow-running tool. It scans raw events, so expect longer latency than the metric tools.\n\nUSE FOR: Ordered funnel questions: 'of visitors who viewed page A, how many went on to click feature B?', 'of visitors who saw guide G, how many reached page B?', drop-off analysis, time-to-completion between steps. With funnelBy='object': object-keyed funnels like 'of the dashboards where event A occurred, how many went on to have event B occur?', 'how long do our dashboards take to complete the funnel from A to B?', or 'where do our venues drop off between A -\u003e B -\u003e C?'.\n\nEXAMPLES:\n- Show me the funnel from page A to feature B\n- What is the drop-off between step 1 and step 2?\n- How long does it take visitors to go from page X to track event Y?\n- Funnel of A -\u003e B -\u003e C with conversion rates\n- Show me the drop-off from seeing guide G to page B\n- Of visitors who dismissed guide G, how many still clicked feature F?\n- Of dashboards where someone viewed page A, how many had someone click feature B? (funnelBy=object)\n- How long do our dashboards take to complete the funnel from page A to feature B? (funnelBy=object)\n- Where do our venues drop off between steps A -\u003e B -\u003e C? (funnelBy=object)\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate for the query window\n- meta.promotedAt (object mode, epoch ms) and meta.effectiveDateRange: present only when funnelBy='object' and the range begins before the object was promoted; events before promotion are excluded from the funnel\n- meta.analyzeBy: the counting mode used (uniqueVisitors or totalAttempts); meta.funnelTimeout (minutes) is echoed only in totalAttempts mode\n- summary.totalVisitorsEnteringStep1: visitors who completed step 1 (visitor mode); totalObjectsEnteringStep1 in object mode; totalAttemptsEnteringStep1 when analyzeBy='totalAttempts'\n- summary.visitorsCompletingFunnel: visitors who completed all steps (visitor mode); objectsCompletingFunnel in object mode; attemptsCompletingFunnel when analyzeBy='totalAttempts'\n- summary.overallConversion: fraction (0-1) who completed the funnel\n- summary.steps: per-step array of index, kind, id, visitors (objects in object mode; attempts when analyzeBy='totalAttempts'), conversionFromStart, dropOffFromPrevious, plus eventType on guide steps\n- summary.steps[].averageTimeToNextStep / medianTimeToNextStep: elapsed time from this step to the next one, as duration objects {seconds, display}; null on the last step\n- summary.steps[].averageTimeFromPreviousStep / medianTimeFromPreviousStep: elapsed time from the previous step to this one; null on the first step (to-next of a step equals from-previous of the following step)\n- the step with the largest of these is where the visitor/object spends the most time between steps; all are computed across entities that completed the whole funnel\n- summary.averageTimeToCompletion: average time from step 1 to last step as a duration object {seconds, display} (null when no completions)\n- summary.medianTimeToCompletion: median time from step 1 to last step as a duration object {seconds, display} (null when no completions)","examples":["{\"analyzeBy\":\"\\u003canalyzeBy\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"blacklist\":\"\\u003cblacklist\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"funnelBy\":\"\\u003cfunnelBy\\u003e\",\"funnelTimeout\":\"\\u003cfunnelTimeout\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"objectProperty\":\"\\u003cobjectProperty\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"queryFunnel\",\"steps\":\"\\u003csteps\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"queryFunnel","inputModes":["application/json"],"name":"queryFunnel","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","slow","read-only"]},{"description":"\n\tLook up the names and descriptions of product entities, such as: accounts, pages, features, track types, guides, starred replays (SessionRecording), saved clips, playlists or product areas.\n\tGuide results include an activation URL that can launch the guide directly in the application.\n\tSaved clip and starred Replay results include an activation URL that links directly to the saved clip in Session Replay.\n\tPlaylist results include an activation URL that links directly to the playlist in Session Replay.\n\tWhen users ask \"How do I...\" or \"Help me with...\" questions, search for Guide entities to find relevant step-by-step walkthroughs.\n\n\tDEPRECATED for Account, Guide, ProductArea, Page, Feature, and TrackType entity types: use listAccounts, listGuides, listProductAreas, and listCountables instead, which provide richer filtering and dedicated listing capabilities.\n\n\tUseful for: finding relevant entities in the customer's product for follow-up analysis with other tools, learning\n\tmore about specific entities, or answering how-to questions by finding relevant guides with direct launch links.\n\tUses semantic search to find entities by conceptual meaning and relevance to natural language queries,\n\twith fuzzy search for broad matching.\n\n\tTool may be used in one of three ways:\n\t1. Get specific entities: itemIds and exactly one itemType are specified; searchFallback and search are not allowed in this case.\n\t2. Search for relevant entities: searchFallback AND search are BOTH specified, along with one or more itemType; itemIds is not allowed in this case.\n\t3. Get starred entities: starredItemTypes lists one or more entity types and matching itemType are specified; returns only entities of those types starred by the current user. ALWAYS combine multiple starred entity types into a single call (e.g., starred replays AND starred guides in one call, not separate calls).\n\n\tIMPORTANT: The search parameter should contain only the core query terms (e.g., \"onboarding features\", \"Bridgeway Logistics\"), not instructions or meta-commentary.\n\t\n\nEXAMPLES:\n- What features should I look at to track onboarding success?\n- What parts of my app provide administrator functions?\n- What communications do we have to end users advertising our annual conference?\n- What instrumentation events do we collect for end-user performance?\n- Which pages should I measure user activity on to see how much time users are spending in setup?\n- How do I set up single sign-on?\n- Help me configure user permissions in my app\n- Show me saved clips about checkout errors\n- Show me all my starred items\n\nRETURNS:\n- Entity ID, name, description, and search method for each match\n- For Guide entities: an activation URL that launches the guide in-app (when the guide is public and has audience set to everyone)\n- For SessionRecording (Replay) entities: an activation URL that links to the replay player\n- For Saved Clip entities: an activation URL linking directly to the saved clip in Session Replay\n- For Playlist entities: an activation URL linking directly to the playlist in Session Replay","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"itemIds\":\"\\u003citemIds\\u003e\",\"itemType\":\"\\u003citemType\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"rerankingStrategy\":\"\\u003crerankingStrategy\\u003e\",\"search\":\"\\u003csearch\\u003e\",\"searchFallback\":\"\\u003csearchFallback\\u003e\",\"skill\":\"searchEntities\",\"starredItemTypes\":\"\\u003cstarredItemTypes\\u003e\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"searchEntities","inputModes":["application/json"],"name":"searchEntities","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"List all the segments. The name and the id of each segment is returned, along with flagNames if the segment defines one or more feature flags. These segments can be used for query build tools. Only publicly shared segments are returned.","examples":["{\"skill\":\"segmentList\",\"subId\":\"\\u003csubId\\u003e\",\"substring\":\"\\u003csubstring\\u003e\"}"],"id":"segmentList","inputModes":["application/json"],"name":"segmentList","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get session replay recordings with filtering by duration, activity percentage, date range, frustration types, and track events. Returns detailed session metadata including frustration events, activity scores, and app information. When referencing a page, feature, or guide in a filter in association with a frustration type, defer to use occurredOn/notOccurredOn facts on frustration type filters over pageIds, featureIds, or guideIds filtering.\n\nUSE FOR: Finding session replays with specific criteria, analyzing user session quality, identifying high-activity or problematic sessions, scoping replays to specific apps, segments, accounts, features, guides, or product areas, filtering for sessions with specific frustration signals, or filtering by track events, pages, or features and their properties (including historical metadata)\n\nEXAMPLES:\n- Show me recordings that occur on page 1234\n- Show me session replays from the last week with high activity\n- Find session replays longer than 5 minutes\n- Show me session replays for visitor 1234\n- Show me session replays for account acme-corp\n- Show me session replays for app 5678\n- Show me session replays where users interacted with feature abc123\n- Show me session replays where users saw guide xyz789\n- Show me session replays with rage clicks\n- Show me session replays where the checkout-completed track event fired\n- Show me session replays for the Onboarding product area\n\nRETURNS:\n- Session replay recordings with their URL and metadata including duration, activity percentage, frustration events, and app details. Limited to 50 replays returned.\n- Timestamp fields (startTime, endTime, minBrowserTime) are raw Unix epoch milliseconds; pass them directly to other tools that accept a timestamp. Each has a *Display sibling (startTimeDisplay, endTimeDisplay, minBrowserTimeDisplay) with a human-readable rendering; use those when presenting times to the user.\n\nThe maximum time range for this tool is 31 days.","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"blacklist\":\"\\u003cblacklist\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"eventProperties\":\"\\u003ceventProperties\\u003e\",\"featureEventProperties\":\"\\u003cfeatureEventProperties\\u003e\",\"featureIds\":\"\\u003cfeatureIds\\u003e\",\"frustrationTypes\":\"\\u003cfrustrationTypes\\u003e\",\"guideIds\":\"\\u003cguideIds\\u003e\",\"minActivityPercentage\":\"\\u003cminActivityPercentage\\u003e\",\"minDuration\":\"\\u003cminDuration\\u003e\",\"notFeatureIds\":\"\\u003cnotFeatureIds\\u003e\",\"notGuideIds\":\"\\u003cnotGuideIds\\u003e\",\"notPageIds\":\"\\u003cnotPageIds\\u003e\",\"notProductAreaIds\":\"\\u003cnotProductAreaIds\\u003e\",\"notTrackEventIds\":\"\\u003cnotTrackEventIds\\u003e\",\"pageEventProperties\":\"\\u003cpageEventProperties\\u003e\",\"pageIds\":\"\\u003cpageIds\\u003e\",\"productAreaIds\":\"\\u003cproductAreaIds\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"sessionReplayList\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"trackEventIds\":\"\\u003ctrackEventIds\\u003e\",\"visitorId\":\"\\u003cvisitorId\\u003e\"}"],"id":"sessionReplayList","inputModes":["application/json"],"name":"sessionReplayList","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Request an AI-generated summary for a session replay recording. Returns a structured summary with a title and a chronological timeline of key moments, errors, and frustration signals. On a first call the summary job is enqueued and the current status is returned. Each call always attempts to generate a fresh summary; if a job for the same session is already PENDING or RUNNING, the tool polls that job instead of starting a duplicate. Pass a consistent set of session-context fields (recordingSessionId, appId, visitorId, startTime, endTime) for the specific recording so the summary is generated from the correct session.\n\nUSE FOR: Summarizing a specific session replay to extract key moments, errors, and frustration signals, once the session's identifiers and time range are known.\n\nEXAMPLES:\n- Summarize this session replay for me\n- What happened during this user's session?\n- Give me an AI summary of session replay abc123\n\nNOT FOR: Listing or searching session replays. Fetching raw devlog events.\n\nRETURNS:\n- status: PENDING, RUNNING, DONE, or FAILED\n- jobId: identifier for the summary job (use to poll if status is not DONE)\n- data: structured summary with a title and a chronological timeline (present when status is DONE). Each timeline entry has a type (keyMoment, error, or frustrationSignal), timestamp, description, and a url linking directly to that moment in the session replay player.\n- reason: failure reason (present when status is FAILED)","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"endTime\":\"\\u003cendTime\\u003e\",\"libraryFilters\":\"\\u003clibraryFilters\\u003e\",\"recordingIds\":\"\\u003crecordingIds\\u003e\",\"recordingSessionId\":\"\\u003crecordingSessionId\\u003e\",\"skill\":\"sessionReplaySummarize\",\"startTime\":\"\\u003cstartTime\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"visitorId\":\"\\u003cvisitorId\\u003e\"}"],"id":"sessionReplaySummarize","inputModes":["application/json"],"name":"sessionReplaySummarize","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","replayAiSummary"]},{"description":"Analyzes captured DOM(s) from the customer's application, to create page and feature tag suggestions reconciled against existing tags. Accepts one or more pages, each with a `url` and a `domHandle. Just returns a summary manifest of the suggestions.`\n\nUSE FOR: Step 2 of the tagging workflow: when the user wants Pendo page/feature tag suggestions derived from captured DOM HTML.\n\nEXAMPLES:\n- Suggest tags for the page I just captured\n- What untagged features are on https://app.example.com/dashboard\n\nNOT FOR: Applying or persisting tags - this tool only suggests.\n\nWORKFLOW: 1. captureDomForTagging - upload the page's DOM and receive a domHandle. 2. processPageAndFeatureSuggestions - generate suggestions for the captured DOM(s), referencing each capture by its domHandle; returns a sessionId and manifest. 3. getSuggestedFeatureBatch - retrieve the feature suggestions in batches, choosing sections and batch sizes as you see fit.\n\nRETURNS:\n- sessionId - key for fetching feature suggestion batches; valid for 24 hours\n- manifest - each page's suggestion sections with actionType (CREATE/UPDATE/MATCH/DELETE/MERGE) and counts; feature suggestions are NOT inlined - fetch them with getSuggestedFeatureBatch\n- pages - page-level tag suggestions, inline","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"pages\":\"\\u003cpages\\u003e\",\"skill\":\"processPageAndFeatureSuggestions\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"processPageAndFeatureSuggestions","inputModes":["application/json"],"name":"processPageAndFeatureSuggestions","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","enableTagWithLeo","read-only"]},{"description":"\n\tList Surveys, optionally filtering by Survey type, displayed status, application, or product area.\n\t\n\nUSE FOR: Discovering Survey IDs and metadata before requesting Survey responses or scores.\n\nEXAMPLES:\n- List all Surveys\n- List public NPS Surveys\n- Which Surveys are scheduled?\n- Show Surveys for app 123\n- Show Surveys in product area 456\n\nRETURNS:\n- totalCount: total matching Surveys before pagination\n- rows: ID, name, Survey type, status, target segment, app IDs, product area IDs, and useful metadata\n\nFILTERING OPTIONS:\n- surveyType: NET_PROMOTER_SCORE, PRODUCT_MARKET_FIT, CUSTOMER_SATISFACTION, USER_EXPERIENCE_LITE\n- status: public, staged, scheduled, draft, _pendingReview_, disabled\n- appId: Surveys available in one accessible application\n- productAreaId: Surveys associated with one product area","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"offset\":\"\\u003coffset\\u003e\",\"productAreaId\":\"\\u003cproductAreaId\\u003e\",\"skill\":\"listSurveys\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"surveyType\":\"\\u003csurveyType\\u003e\"}"],"id":"listSurveys","inputModes":["application/json"],"name":"listSurveys","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get per-visitor survey responses for a single survey (VOC: CSAT, PMF, UMUX) or NPS guide. limit (default 100, max 500) applies to the pivoted visitor rows.\n\nUSE FOR: Pulling per-visitor responses for a specific survey or NPS guide - individual answers, response distributions per question, and the most-recent answer per visitor across all of the survey's questions.\n\nEXAMPLES:\n- Show me the per-visitor responses to NPS guide guide-nps-q4\n- What did visitors answer on the CSAT survey survey-csat-onboarding?\n- Pull the response distribution and per-visitor answers for our PMF survey last quarter\n- Show NPS rating + reason responses for guide guide-nps-h1 from the last 30 days\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- summary: {surveyId, surveyName, surveyType, items: [{itemId, question, distribution: [{response, count}]}]}. For free-text items (NPS reason, OpenAnswer) freeText is true and distribution is omitted - every response is unique, so refer to per-visitor rows instead.\n- rows: per-visitor with visitorId, accountId, browserTime (timestamp object {iso, display}), and one column per itemId (null if the visitor did not answer that item).","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"limit\":\"\\u003climit\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"surveyResponses\",\"subId\":\"\\u003csubId\\u003e\",\"surveyId\":\"\\u003csurveyId\\u003e\"}"],"id":"surveyResponses","inputModes":["application/json"],"name":"surveyResponses","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Get survey scores over a date range for NPS (Net Promoter Score), CSAT (Customer Satisfaction), PMF (Product-Market Fit), and UMUX (Usability Metric for User Experience). Returns {meta, summary, rows}: rows are one PER SURVEY (scores are never pooled across different surveys), each with surveyId, surveyName, surveyType, score, and numResponses; NPS, CSAT, and PMF rows also break out numPositive, numNeutral, numNegative. summary is keyed by survey type and gives an equal-weighted mean of that type's per-survey scores (avgScore, numSurveys, totalResponses) - the business roll-up across surveys of that type. Audience can be scoped via an inline segmentPipeline and/or a single accountId; surveyId narrows to one survey (or a single NPS guide); appId narrows to surveys in one app; surveyTypes selects which types to include.\n\nUSE FOR: Per-survey NPS/CSAT/PMF/UMUX scores over a window, the positive/neutral/negative breakdown per survey, and the average score across all surveys of a type - optionally scoped to an account, app, or segment.\n\nEXAMPLES:\n- What is our NPS score?\n- Show me NPS trends over the last 30 days\n- What's our CSAT score for each survey over the last 30 days?\n- Give me the score for every CSAT survey and the overall average\n- What's the CSAT score for account X this quarter?\n- Show the positive/neutral/negative breakdown for each PMF survey last month\n- What's our UMUX score over the last 90 days?\n\nRETURNS:\n- meta.dateRange: resolved startDate and endDate (YYYY-MM-DD)\n- summary: keyed by survey type, each with avgScore (equal-weighted mean of that type's per-survey scores), numSurveys, totalResponses\n- rows: one per survey with surveyId, surveyName, surveyType, score, numResponses. NPS score is -100 to +100; CSAT/PMF/UMUX score is 0-100. NPS/CSAT/PMF rows also include numPositive, numNeutral, numNegative.","examples":["{\"accountId\":\"\\u003caccountId\\u003e\",\"appId\":\"\\u003cappId\\u003e\",\"dateRange\":\"\\u003cdateRange\\u003e\",\"includeAnonymous\":\"\\u003cincludeAnonymous\\u003e\",\"segmentPipeline\":\"\\u003csegmentPipeline\\u003e\",\"skill\":\"surveyScores\",\"subId\":\"\\u003csubId\\u003e\",\"surveyId\":\"\\u003csurveyId\\u003e\",\"surveyTypes\":\"\\u003csurveyTypes\\u003e\"}"],"id":"surveyScores","inputModes":["application/json"],"name":"surveyScores","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Removes the link between an existing feedback item and an existing idea, detaching the customer evidence from the idea. Votes propagated from the feedback item are removed from the idea's vote count.\n\nUSE FOR: When the user explicitly asks to unlink, disconnect, or remove the association between a feedback item and an idea, or vice versa\n\nEXAMPLES:\n- Unlink feedback abc123 from idea xyz456\n- Disconnect this feedback from that idea\n- Remove the association between idea xyz456 and feedback abc123\n\nRETURNS:\n- Confirmation that the idea and feedback item have been unlinked","examples":["{\"feedbackItemId\":\"\\u003cfeedbackItemId\\u003e\",\"ideaId\":\"\\u003cideaId\\u003e\",\"skill\":\"unlinkIdeaFeedback\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"unlinkIdeaFeedback","inputModes":["application/json"],"name":"unlinkIdeaFeedback","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","destructive"]},{"description":"Updates an existing feedback item. Only fields that are explicitly provided are modified; omitted fields are left unchanged. Returns the ID of the updated feedback item.\n\nUSE FOR: When the user wants to edit an existing feedback item's title, description, status, application, product area, or importance\n\nEXAMPLES:\n- Update the title of feedback 123 to 'New title'\n- Change the status of feedback 456 to 'Under Review'\n- Set the importance of feedback 789 to 'Must Have'\n\nRETURNS:\n- ID of the updated feedback item","examples":["{\"appIds\":\"\\u003cappIds\\u003e\",\"description\":\"\\u003cdescription\\u003e\",\"feedbackId\":\"\\u003cfeedbackId\\u003e\",\"importance\":\"\\u003cimportance\\u003e\",\"productAreaIds\":\"\\u003cproductAreaIds\\u003e\",\"skill\":\"updateFeedbackItem\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"title\":\"\\u003ctitle\\u003e\"}"],"id":"updateFeedbackItem","inputModes":["application/json"],"name":"updateFeedbackItem","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","destructive"]},{"description":"Updates an existing product idea. Only fields that are explicitly provided are modified; omitted fields are left unchanged. Returns the ID of the updated idea.\n\nUSE FOR: When the user wants to edit an existing idea's title, description, status, application, product area, effort, or impact\n\nEXAMPLES:\n- Update the title of idea 123 to 'New title'\n- Change the status of idea 456 to 'In Progress'\n- Set the effort for idea 789 to 3\n\nRETURNS:\n- ID of the updated idea","examples":["{\"appIds\":\"\\u003cappIds\\u003e\",\"description\":\"\\u003cdescription\\u003e\",\"effort\":\"\\u003ceffort\\u003e\",\"ideaId\":\"\\u003cideaId\\u003e\",\"impact\":\"\\u003cimpact\\u003e\",\"productAreaIds\":\"\\u003cproductAreaIds\\u003e\",\"skill\":\"updateIdeaItem\",\"status\":\"\\u003cstatus\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"title\":\"\\u003ctitle\\u003e\"}"],"id":"updateIdeaItem","inputModes":["application/json"],"name":"updateIdeaItem","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","destructive"]},{"description":"Updates an existing Pendo visitor segment. Only the fields you provide are changed; omitted fields are left as-is. Confirm the segment id, updated name (if any), and a human-readable summary of every AND/OR clause with the user before submitting.\n\nUSE FOR: Editing a saved segment's name, description, sharing, or rules. Fetch the current definition with getSegment first if the user wants to tweak specific rules - this tool replaces the whole rule set when a definition is provided.\n\nEXAMPLES:\n- Rename segment abc123 to \"Power users\".\n- Make segment xyz789 public.\n- Update the rules on segment abc123 to only include visitors active in the last 14 days.\n\nRETURNS:\n- id: the updated segment's id.\n- summary: plain-English description of the persisted segment rules with entity names resolved. Reflects what was actually stored after compile-time normalization.\n\nEntityTypes:\n    visitor:\n        requiredFields:\n            entityType: \"visitor\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    account:\n        requiredFields:\n            entityType: \"account\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    page:\n        requiredFields:\n            entityType: \"page\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"deadClicks\", \"errorClicks\", \"rageClicks\", \"daysActive\", \"uTurns\", \"eventTime\", \"seen\", \"notseen\", \"lastSeen\"]\n\n    feature:\n        requiredFields:\n            entityType: \"feature\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"deadClicks\", \"errorClicks\", \"rageClicks\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\n    trackEvent:\n        requiredFields:\n            entityType: \"trackEvent\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\n    guide:\n        requiredFields:\n            entityType: \"guide\"\n            entityId: String\n        supportedMetrics:\n            [\"seen\", \"lastSeen\", \"notSeen\"]\n\n    poll:\n        requiredFields:\n            entityType: \"poll\"\n            entityId: String\n            pollId: String  // the poll nested under the guide\n        supportedMetrics:\n            [\"response\"]\n\n    guideElement:\n        requiredFields:\n            entityType: \"guideElement\"\n            entityId: String\n            stepId: String     // the guide step the element sits on\n            elementId: String  // the element's uiElementId, e.g. \"pendo-button-a1b2c3d4\"\n        supportedMetrics:\n            [\"eventCount\"]\n\n    segment:\n        requiredFields:\n            entityType: \"segment\"\n            entityId: String\n        supportedMetrics:\n            [\"isMemberOfSegment\", \"isNotMemberOfSegment\"]\n\n    metadata:\n        requiredFields:\n            entityType: \"metadata\"\n            entityId: String\n        supportedMetrics:\n            []\n\n    agent:\n        requiredFields:\n            entityType: \"agent\"\n            entityId: String\n        supportedMetrics:\n            [\"eventCount\", \"daysActive\", \"used\", \"notused\", \"lastused\"]\n\nMetrics:\n    eventCount:\n        description: Number of events for the selected entity.\n        requiredFields:\n            metric: \"eventCount\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    deadClicks:\n        description: Number of dead clicks for the selected page or feature.\n        requiredFields:\n            metric: \"deadClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    errorClicks:\n        description: Number of error clicks for the selected page or feature.\n        requiredFields:\n            metric: \"errorClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    rageClicks:\n        description: Number of rage clicks for the selected page or feature.\n        requiredFields:\n            metric: \"rageClicks\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    daysActive:\n        description: Number of active days for the selected entity.\n        requiredFields:\n            metric: \"daysActive\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    uTurns:\n        description: Number of u-turns for the selected page.\n        requiredFields:\n            metric: \"uTurns\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    eventTime:\n        description: Time in minutes spent on the selected page.\n        requiredFields:\n            metric: \"eventTime\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"withinLast\", \"between\"]\n\n    response:\n        description: Numeric poll response. Use two ANDed rules for a range.\n        requiredFields:\n            metric: \"response\"\n            operator: Enum[\"==\", \"!=\", \"\u003e=\", \"\u003c=\"]\n            threshold: Integer\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"between\"]\n\n    used:\n        description: Whether the selected feature or track event was used, optionally with a frequency threshold.\n        requiredFields:\n            metric: \"used\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"atLeast\", \"atMost\"]\n\n    notused:\n        description: Whether the selected feature or track event was not used.\n        requiredFields:\n            metric: \"notused\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\"]\n\n    lastused:\n        description: When the selected feature or track event was last used.\n        requiredFields:\n            metric: \"lastused\"\n        supportedConditions:\n            [\"since\", \"withinLast\", \"between\"]\n\n    seen:\n        description: Whether the selected page was seen, optionally with a frequency threshold. For checking withinLast\n        requiredFields:\n            metric: \"seen\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\", \"atLeast\", \"atMost\"]\n\n    notseen:\n        description: Whether the selected page was not seen.\n        requiredFields:\n            metric: \"notseen\"\n        supportedConditions:\n            [\"ever\", \"since\", \"withinLast\"]\n\n    lastSeen:\n        description: When the selected page was last seen.\n        requiredFields:\n            metric: \"lastSeen\"\n        supportedConditions:\n            [\"since\", \"withinLast\", \"between\"]\n\n    isMemberOfSegment:\n        description: Whether the visitor is a member of the selected segment.\n        requiredFields:\n            metric: \"isMemberOfSegment\"\n        supportedConditions:\n            []\n\n    isNotMemberOfSegment:\n        description: Whether the visitor is not a member of the selected segment.\n        requiredFields:\n            metric: \"isNotMemberOfSegment\"\n        supportedConditions:\n            []\n\nConditions:\n    ever:\n        description: The metric happened at any time.\n        requiredFields:\n            condition: \"ever\"\n\n    since:\n        description: The metric happened on or after a specific date.\n        requiredFields:\n            condition: \"since\"\n            date: DateString(\"yyyy-mm-dd\")\n\n    withinLast:\n        description: The metric happened within a rolling time window.\n        requiredFields:\n            condition: \"withinLast\"\n            lookbackAmount: Integer\n            granularity: Enum[\"days\", \"weeks\", \"months\"]\n\n    between:\n        description: The metric happened within an inclusive date range.\n        requiredFields:\n            condition: \"between\"\n            first: DateString(\"yyyy-mm-dd\")\n            last: DateString(\"yyyy-mm-dd\")\n\n    atLeast:\n        description: The metric happened at least threshold times ever\n        requiredFields:\n            condition: \"atLeast\"\n            threshold: Integer\n\n    atMost:\n        description: The metric happened at most threshold times ever\n        requiredFields:\n            condition: \"atMost\"\n            threshold: Integer\n\n","examples":["{\"definition\":\"\\u003cdefinition\\u003e\",\"description\":\"\\u003cdescription\\u003e\",\"id\":\"\\u003cid\\u003e\",\"name\":\"\\u003cname\\u003e\",\"shared\":\"\\u003cshared\\u003e\",\"skill\":\"updateSegment\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"updateSegment","inputModes":["application/json"],"name":"updateSegment","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","destructive"]},{"description":"Permanently deletes a saved Pendo visitor segment. Confirm the segment name and id with the user before submitting - this cannot be undone from the agent.\n\nUSE FOR: Removing a segment the user no longer needs. If the segment is referenced by a guide, another segment, or a saved report, the delete is rejected and the referencing entity is named in the error so the user can detach it first. Segments that back a feature flag must be deleted via the feature-flag tools.\n\nEXAMPLES:\n- Delete segment abc123.\n- Remove the \"Old trial users\" segment.\n\nRETURNS:\n- id: the deleted segment's id.","examples":["{\"id\":\"\\u003cid\\u003e\",\"skill\":\"deleteSegment\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"deleteSegment","inputModes":["application/json"],"name":"deleteSegment","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","mcpWriteTools","destructive"]},{"description":"View a Pendo guide as a preview in the chat: renders the guide's steps and shows an Open in Pendo button that links to the guide in Pendo.\n\nUSE FOR: Previewing a specific Pendo guide's steps and content in context, with a link to open it in Pendo. Offer it once, unprompted, after answering about a single guide, and call it only after the user accepts.\n\nEXAMPLES:\n- View guide abc123\n- Show me the steps of this guide\n\nNOT FOR: Listing guides, guide analytics, or creating a guide from scratch.\n\nWORKFLOW: If the client cannot render the preview card, report the guide name, step count, and editUrl; never echo dom or buildingBlocks.\n\nRETURNS:\n- Renders the guide's steps as a preview with an Open in Pendo button that links to the guide.","examples":["{\"guideId\":\"\\u003cguideId\\u003e\",\"skill\":\"viewGuide\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"viewGuide","inputModes":["application/json"],"name":"viewGuide","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]},{"description":"Returns comprehensive activity timeline for a specific visitor, including page views, feature clicks, guide interactions, and custom track events. Provides detailed chronological analysis of user behavior with rich entity context.\n\nUSE FOR: Detailed visitor behavior analysis, timeline reconstruction, debugging user journeys\n\nEXAMPLES:\n- Complete timeline for visitor X\n- What did user Y do on January 15th?\n- Which pages did visitor Z view?\n- Which features did visitor A click?\n- Which guides did visitor B complete?\n- Which polls did visitor C respond to?\n\nNOT FOR: Bulk visitor analysis across many visitors, or ranking visitors by event participation - this tool reconstructs the timeline of a single specified visitor.\n\nWORKFLOW: Use listCountables to find entity ID by name, then use this tool for detailed analysis\n\nRETURNS:\n- Chronologically sorted activity timeline with entity context. Large results automatically stored with signed URL for polling.\n\nThe maximum time range for this tool is 31 days.","examples":["{\"appId\":\"\\u003cappId\\u003e\",\"endDate\":\"\\u003cendDate\\u003e\",\"entityTypes\":\"\\u003centityTypes\\u003e\",\"skill\":\"visitorActivity\",\"startDate\":\"\\u003cstartDate\\u003e\",\"subId\":\"\\u003csubId\\u003e\",\"visitorId\":\"\\u003cvisitorId\\u003e\"}"],"id":"visitorActivity","inputModes":["application/json"],"name":"visitorActivity","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","singleEventScopedAgg","read-only"]},{"description":"\nReturn the set of metadata fields available for visitors. Each key is a dot-separated metadata field name. Each value includes the field's Type and a Historical flag indicating whether the field supports historical (event-time) filtering.\n\nFor string fields with at least one value, the response also includes cardinality info to help build correct metadataFilter values instead of guessing:\n- \"cardinality\" is the total number of distinct values the field takes.\n- If cardinality is below 50, \"values\" contains every distinct value the field takes.\n- Otherwise, \"sample\" contains up to 10 example values.\n- The cardinality fields is omitted for fields with high cardinality (more than 500 distinct values).\n\nExample return value:\n\n{\n    \"visitor.auto.lastvisit\"     : {\"type\": \"time\", \"historical\": false},\n    \"visitor.agent.app_ownership\": {\"type\": \"string\", \"historical\": false, \"cardinality\": 2, \"values\": [\"all\", \"some\"]},\n    \"visitor.agent.email\"        : {\"type\": \"string\", \"historical\": true, \"cardinality\": 438, \"sample\": [\"andy@pendo.io\", \"...\"]}\n}\n\nA field where historical is true can be decomposed into (kind, group, field) - for \"visitor.agent.email\", that is kind=\"visitor\", group=\"agent\", field=\"email\".\n","examples":["{\"skill\":\"visitorMetadataSchema\",\"subId\":\"\\u003csubId\\u003e\"}"],"id":"visitorMetadataSchema","inputModes":["application/json"],"name":"visitorMetadataSchema","outputModes":["application/json","text/plain"],"tags":["analytics","pendo","read-only"]}],"url":"https://app.pendo.io/a2a/v0","version":"1.0.0","supportsAuthenticatedExtendedCard":false}