Tools Reference

This is a complete reference of all tools available through the recapt MCP server. Most users won't need this. The AI discovers and uses tools automatically based on your requests.

Page Analysis

get_page_metrics

Get aggregated behavioral metrics for a page.

Parameter	Type	Required	Description
page_path	string	No	Page path (e.g., /checkout). Omit for all pages.
days	number	No	Days to analyze (default: 7)

Returns: frustration, confusion, confidence, energy scores, health score, session count.

get_element_friction

Get per-element friction data for a page.

Parameter	Type	Required	Description
page_path	string	Yes	Page path to analyze
selector_filter	string	No	Filter elements by selector substring

Returns: elements with click counts, dominant friction signals.

get_dead_clicks

Find clicks on non-interactive elements.

Parameter	Type	Required	Description
page_path	string	No	Filter to specific page
days	number	No	Days to analyze (default: 7)

get_console_errors

Get JavaScript errors captured during sessions.

Parameter	Type	Required	Description
page_path	string	No	Filter to specific page
days	number	No	Days to analyze (default: 7)

get_form_friction

Analyze form performance and abandonment.

Parameter	Type	Required	Description
page_path	string	No	Filter to specific page
days	number	No	Days to analyze (default: 7)

get_page_trends

Get metric trends over time for a page.

Parameter	Type	Required	Description
page_path	string	Yes	Page path to analyze
days	number	No	Days to analyze (default: 14)

list_pages

List all tracked pages.

Parameter	Type	Required	Description
limit	number	No	Maximum pages to return (default: 50)

scan_site

One-shot site health scan across all pages.

Parameter	Type	Required	Description
top_n	number	No	Number of top pages to analyze (default: 10)
offset	number	No	Skip first N pages for pagination

get_ux_health_report

Comprehensive UX health report combining metrics, issues, and anomalies.

Parameter	Type	Required	Description
page_path	string	No	Focus on specific page (omit for site-wide)
days	number	No	Days to analyze (default: 7)

Flow Analysis

analyze_flow

Analyze user navigation flows between pages.

Parameter	Type	Required	Description
start_page	string	No*	Starting page path
end_page	string	No*	Ending page path
days	number	No	Days to analyze (default: 7)

*At least one of start_page or end_page is required.

Returns: paths with steps, success rates, bottlenecks, friction scores.

analyze_funnel

Analyze conversion funnel through a sequence of pages.

Parameter	Type	Required	Description
steps	string[]	Yes	Ordered page paths (minimum 2)
days	number	No	Days to analyze (default: 7)

Returns: per-step metrics (entered, converted, dropped, dwell time, frustration).

get_flow_friction

Get friction points in user flows.

Parameter	Type	Required	Description
page_path	string	No	Filter to flows involving this page
days	number	No	Days to analyze (default: 7)

get_journey_patterns

Discover common user journey patterns.

Parameter	Type	Required	Description
days	number	No	Days to analyze (default: 7)
min_sessions	number	No	Minimum sessions for a pattern

Issue Detection

get_anomalies

Detect anomalous sessions and frustration spikes.

Parameter	Type	Required	Description
threshold	number	No	Anomaly threshold 0-1 (default: 0.35)
days	number	No	Days to analyze (default: 7)
page_path	string	No	Filter to specific page

detect_regressions

Find recent metric regressions.

Parameter	Type	Required	Description
days	number	No	Days to analyze (default: 7)
page_path	string	No	Filter to specific page

detect_drift

Detect gradual metric drift over time.

Parameter	Type	Required	Description
days	number	No	Days to analyze (default: 14)
page_path	string	No	Filter to specific page

Comparison & Segmentation

compare_cohorts

Compare two user cohorts side by side.

Parameter	Type	Required	Description
cohort_a	object	Yes	Filters for cohort A
cohort_b	object	Yes	Filters for cohort B
cohort_a_label	string	No	Human label for cohort A
cohort_b_label	string	No	Human label for cohort B
page_path	string	No	Scope to specific page
date_from	string	No	Start date (ISO format)
date_to	string	No	End date (ISO format)

Cohort filters: device (desktop/tablet/mobile), outcome (COMPLETED/STRUGGLED/BLOCKED/DISENGAGED), pattern, has_friction, has_rage_clicks, page_path

compare_periods

Compare metrics between two time periods.

Parameter	Type	Required	Description
page_path	string	Yes	Page to compare
period_a_start	string	Yes	Start of period A (ISO date)
period_a_end	string	Yes	End of period A (ISO date)
period_b_start	string	Yes	Start of period B (ISO date)
period_b_end	string	Yes	End of period B (ISO date)

discover_personas

Discover behavioral personas from session data.

Parameter	Type	Required	Description
days	number	No	Days to analyze (default: 14)
min_sessions	number	No	Minimum sessions per persona

Session Analysis

search_sessions

Search sessions by natural language query.

Parameter	Type	Required	Description
query	string	Yes	Natural language search query
page_path	string	No	Filter to specific page
limit	number	No	Maximum sessions to return (default: 10)

list_sessions

List recent sessions.

Parameter	Type	Required	Description
page_path	string	No	Filter to specific page
days	number	No	Days to look back (default: 7)
limit	number	No	Maximum sessions to return (default: 20)

get_session_details

Get detailed information about specific session(s).

Parameter	Type	Required	Description
session_id	string	No*	Single session ID
session_ids	string[]	No*	Multiple session IDs

*Provide either session_id or session_ids.

triage_sessions

Automatically triage sessions to find those needing attention.

Parameter	Type	Required	Description
session_ids	string[]	No	Triage specific sessions
days	number	No	Lookback period (default: 7)
page_path	string	No	Filter to specific page
min_severity	string	No	Minimum severity to include
limit	number	No	Maximum sessions to return (default: 20)

predict_outcomes

Predict session outcomes based on behavioral signals.

Parameter	Type	Required	Description
session_id	string	No*	Session to analyze
behavioral_features	object	No*	Features for prediction

*Provide either session_id or behavioral_features.

Diagnostic

run_full_diagnostic

Run comprehensive site diagnostic.

Parameter	Type	Required	Description
days	number	No	Days to analyze (default: 7)

Returns: prioritized issues, problem pages, regressions, recommended investigation order.

Triage

dismiss_issue

Dismiss an issue as false positive.

Parameter	Type	Required	Description
issue_id	string	Yes	Issue ID to dismiss
reason	string	Yes	Reason: stale, intended, duplicate, false_positive
explanation	string	Yes	Detailed explanation
create_knowledge	boolean	No	Create site knowledge entry (default: true)

mark_intended_behavior

Mark an issue as intended behavior.

Parameter	Type	Required	Description
issue_id	string	Yes	Issue ID to mark
explanation	string	Yes	Why this behavior is intended

Remediation

propose_fix

Propose a fix for an issue.

Parameter	Type	Required	Description
issue_id	string	Yes	Issue ID to fix
diagnosis	string	Yes	Root cause analysis
proposed_fix	string	Yes	Description of the fix
code_snippet	string	No	Suggested code changes
affected_files	string[]	No	Files to modify
confidence	number	Yes	Confidence level 0-1

list_pending_fixes

List fixes awaiting deployment.

No parameters.

list_remediations

List remediation records.

Parameter	Type	Required	Description
status	string	No	Filter by status
issue_id	string	No	Filter by issue
page_path	string	No	Filter by page
limit	number	No	Maximum results (default: 20)

Statuses: proposed, deployed, evaluating, succeeded, failed, reverted

confirm_deployment

Mark a fix as deployed.

Parameter	Type	Required	Description
remediation_id	string	Yes	Remediation ID

evaluate_fix

Evaluate if a deployed fix improved metrics.

Parameter	Type	Required	Description
remediation_id	string	Yes	Remediation ID
min_hours	number	No	Minimum hours since deployment (default: 24)

Knowledge

get_site_knowledge

Retrieve site-specific learnings.

Parameter	Type	Required	Description
category	string	No	Filter by category
page_path	string	No	Filter by page
issue_category	string	No	Filter by issue category
limit	number	No	Maximum entries (default: 50)

Categories: false_positive, intended_behavior, fix_pattern, context

add_site_knowledge

Store a site-specific learning.

Parameter	Type	Required	Description
category	string	Yes	Knowledge category
subject	string	Yes	Unique identifier/title
content	string	Yes	Detailed description
page_path	string	No	Associated page
element_selector	string	No	Associated element
issue_category	string	No	Associated issue category

delete_site_knowledge

Delete a knowledge entry.

Parameter	Type	Required	Description
knowledge_id	string	Yes	Knowledge entry ID

Utility

get_domains

List tracked domains.

No parameters.

memory_save

Save a value to working memory.

Parameter	Type	Required	Description
key	string	Yes	Unique key
value	string	Yes	Value to store
annotation	string	No	Note about the data

memory_recall

Retrieve a value from working memory.

Parameter	Type	Required	Description
key	string	Yes	Key to retrieve

memory_list

List all keys in working memory.

No parameters.

memory_delete

Delete a value from working memory.

Parameter	Type	Required	Description
key	string	Yes	Key to delete

memory_clear

Clear all working memory.

No parameters.