Skip to content

MCP — Tool reference

Tools are team-scoped. Setup and OAuth: MCP overview.

Optional on most tools: team_id (otherwise current team). Lists typically capped at 50 items.

ToolDescription
list_teamsYour teams (id, name, plan, has_mcp_access, has_mcp_ab_testing) — visible even without MCP plan
get_usageLimits and usage
ToolDescription
get_dashboardOverview + time series; compact recent_conversions
list_conversionsConversion list with filters
get_conversion_rateConversion-rate metrics
list_sessions / get_sessionSessions
list_domainsDomains (no auth_key)
ToolPurpose
list_profilesList and search visitor profiles
get_profileOne profile with traits, session and conversion timeline
get_conversion_funnelCohort funnel: how many profiles with event A later had event B

Profiles connect repeat visits by the same person. Every conversion and session carries a profile_id that opens the full journey via get_profile — even when the signup and the purchase happened in separate sessions.

get_conversion_funnel answers questions like “how many signups from the Meta campaign layout-cta bought later?” in a single call. The cohort can be filtered by channel, UTM parameters and click id presence; usertrax never returns click id values over MCP. Default window between the two events: 90 days.

UTM filters match exactly and are case-insensitive. Conversions without a profile are reported separately as unprofiled_a_count and stay out of the rate.

Requires plan feature feedback.

ToolDescription
list_feedback / get_feedbackFeedback list and detail

Requires plan feature surveys (from Pro).

ToolDescription
list_surveys / get_surveySurveys
list_survey_responsesResponses / aggregates

Requires plan feature mcp_ab_testing (Business; also trial/free). Dashboard A/B tests use ab_testing separately.

ToolDescription
list_ab_testsTests with short summary
get_ab_testSingle test + variants (config)
get_ab_test_analyticsAnalytics including significance
create_ab_testCreate draft (+ optional CSS/JS fields)
update_ab_testUpdate / change status
delete_ab_testDelete

All A/B tools require Business. create_ab_test always starts as draft. Activate with update_ab_test and status=active. Optional custom_css / custom_js are stored as sent — generate them in the client if needed.

No funnels, no ad-export triggers, no secrets, no raw SQL.