MCP Tools/Research runs/start_discovery

start_discovery

writeResearch runs

Start a research run (Discovery) for the project.

Connected surface
This tool and the Research dashboard page are two surfaces over the same data. The dashboard is where you view and curate it; start_discovery is how your AI can launch a research session from inside the conversation that prompted it. How surfaces connect →
Write tool
Mutates Rampify state, triggers background work, or calls a paid external API. Most clients ask for confirmation before invoking.

Parameters

ParameterTypeDescription
domainstringoptionalProject domain (alt to project_id).
project_idstringoptionalProject UUID.
product_idstringoptionalOptional. Product to scope this session to. Defaults to the project's default product when omitted. Use list_products to discover product IDs for multi-product projects.
playbookenum("category_visibility" | "comparison_readiness" | "scenario_surfacing" | "developer_workflow" | "narrative_audit" | "market_opportunity")optionalOptional. Map the user's natural-language playbook name to one of the slugs. Omit only when the user did not name a playbook at all — the tool will tell you whether to pick automatically or ask the user.
templateenum("category_visibility" | "comparison_readiness" | "scenario_surfacing" | "developer_workflow" | "narrative_audit" | "market_opportunity")optionalDeprecated: the same as playbook.