# MCP tool reference

Inputs, outputs, permissions, and examples for every registered ConversionLab MCP tool.

Connect external AI tools with [MCP setup](https://conversionlab.app/docs/developer/mcp-setup). MCP exposes a smaller surface than the REST API. Examples use fictional data.

- [`create_experiment`](https://conversionlab.app/docs/developer/mcp/create-experiment) — Create an experiment. Requires mcp:write and the existing ConversionLab experiment create policy.

- [`create_idea`](https://conversionlab.app/docs/developer/mcp/create-idea) — Create an idea. Requires mcp:write and the existing ConversionLab idea create policy.

- [`create_insight`](https://conversionlab.app/docs/developer/mcp/create-insight) — Create an insight. Requires mcp:write and the existing ConversionLab insight create policy.

- [`get_experiment`](https://conversionlab.app/docs/developer/mcp/get-experiment) — Get a full experiment record with linked summaries and metrics.

- [`get_idea`](https://conversionlab.app/docs/developer/mcp/get-idea) — Get a full idea record with linked summaries.

- [`get_insight`](https://conversionlab.app/docs/developer/mcp/get-insight) — Get a full insight record with linked summaries.

- [`get_mcp_context`](https://conversionlab.app/docs/developer/mcp/get-mcp-context) — Describe the authenticated ConversionLab team, user role, MCP token permissions, and available MCP surface.

- [`get_metric`](https://conversionlab.app/docs/developer/mcp/get-metric) — Get a metric by ID.

- [`get_project`](https://conversionlab.app/docs/developer/mcp/get-project) — Get a project by ID.

- [`get_today_daily_brief`](https://conversionlab.app/docs/developer/mcp/get-today-daily-brief) — Return today's retained daily brief if one already exists. This never generates a new brief.

- [`list_audiences`](https://conversionlab.app/docs/developer/mcp/list-audiences) — List configured audiences, optionally filtered by project.

- [`list_experiment_states`](https://conversionlab.app/docs/developer/mcp/list-experiment-states) — List experiment states, optionally filtered by project.

- [`list_experiments`](https://conversionlab.app/docs/developer/mcp/list-experiments) — List experiments, optionally filtered by project, state, type, or metric.

- [`list_idea_states`](https://conversionlab.app/docs/developer/mcp/list-idea-states) — List idea states, optionally filtered by project.

- [`list_ideas`](https://conversionlab.app/docs/developer/mcp/list-ideas) — List ideas, optionally filtered by project or state.

- [`list_insight_labels`](https://conversionlab.app/docs/developer/mcp/list-insight-labels) — List insight labels, optionally filtered by project.

- [`list_insights`](https://conversionlab.app/docs/developer/mcp/list-insights) — List insights, optionally filtered by project or label.

- [`list_metrics`](https://conversionlab.app/docs/developer/mcp/list-metrics) — List metrics, optionally filtered by project.

- [`list_pages`](https://conversionlab.app/docs/developer/mcp/list-pages) — List configured pages, optionally filtered by project.

- [`list_projects`](https://conversionlab.app/docs/developer/mcp/list-projects) — List projects in the authenticated team.

- [`search_conversionlab`](https://conversionlab.app/docs/developer/mcp/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`](https://conversionlab.app/docs/developer/mcp/update-experiment) — Update an experiment. Requires mcp:write and the existing ConversionLab experiment update policy.

- [`update_idea`](https://conversionlab.app/docs/developer/mcp/update-idea) — Update an idea. Requires mcp:write and the existing ConversionLab idea update policy.

- [`update_insight`](https://conversionlab.app/docs/developer/mcp/update-insight) — Update an insight. Requires mcp:write and the existing ConversionLab insight update policy.