MCP tool reference

Connect external AI tools with MCP setup. MCP exposes a smaller surface than the REST API. Examples use fictional data.

• create_experiment — Create an experiment. Requires mcp:write and the existing ConversionLab experiment create policy.

• create_idea — Create an idea. Requires mcp:write and the existing ConversionLab idea create policy.

• create_insight — Create an insight. Requires mcp:write and the existing ConversionLab insight create policy.

• get_experiment — Get a full experiment record with linked summaries and metrics.

• get_idea — Get a full idea record with linked summaries.

• get_insight — Get a full insight record with linked summaries.

• get_mcp_context — Describe the authenticated ConversionLab team, user role, MCP token permissions, and available MCP surface.

• get_metric — Get a metric by ID.

• get_project — Get a project by ID.

• get_today_daily_brief — Return today's retained daily brief if one already exists. This never generates a new brief.

• list_audiences — List configured audiences, optionally filtered by project.

• list_experiment_states — List experiment states, optionally filtered by project.

• list_experiments — List experiments, optionally filtered by project, state, type, or metric.

• list_idea_states — List idea states, optionally filtered by project.

• list_ideas — List ideas, optionally filtered by project or state.

• list_insight_labels — List insight labels, optionally filtered by project.

• list_insights — List insights, optionally filtered by project or label.

• list_metrics — List metrics, optionally filtered by project.

• list_pages — List configured pages, optionally filtered by project.

• list_projects — List projects in the authenticated team.

• search_conversionlab — Search ConversionLab projects, ideas, insights, experiments, metrics, pages, and audiences. Uses semantic search only when team AI is available, otherwise falls back to keyword search.

• update_experiment — Update an experiment. Requires mcp:write and the existing ConversionLab experiment update policy.

• update_idea — Update an idea. Requires mcp:write and the existing ConversionLab idea update policy.

• update_insight — Update an insight. Requires mcp:write and the existing ConversionLab insight update policy.