Cofounder CLI
Research
Run research in the background and read saved customer and market evidence.
Research answers questions from published sources. Start a job with your question and a spending limit, then read its saved report and citations. Published evidence can inform your decisions; it doesn't prove people will buy your product.
Research jobs
| MCP | CLI | API |
|---|---|---|
research_start | cofounder research start --query <question> --max-cost-usd <usd> | POST /cofounder-cli/v1/research/jobs |
research_jobs_list | cofounder research jobs list | GET /cofounder-cli/v1/research/jobs |
research_jobs_get | cofounder research jobs get --job-id <id> | GET /cofounder-cli/v1/research/jobs/{job_id} |
research_jobs_results_get | cofounder research jobs results get --job-id <id> | GET /cofounder-cli/v1/research/jobs/{job_id}/results |
research_jobs_cancel | cofounder research jobs cancel --job-id <id> | POST /cofounder-cli/v1/research/jobs/{job_id}/cancel |
cofounder research start --query "How do dental clinics book new patients?" \
--max-cost-usd 20 --title "Dental booking"
cofounder research jobs get --job-id <job-id>
cofounder research jobs results get --job-id <job-id>start spends up to --max-cost-usd and returns a job id right away;
the research runs in the background. --effort thorough digs deeper and
costs more to start. To get results in a shape you choose instead of a
written report, pass a JSON Schema as --output-schema. Its root must be an
object that lists every property as required and sets
additionalProperties to false; length, count, and range limits aren't
supported.
Check on a job with jobs get: it shows status, progress, and cost so far.
Once it's completed, jobs results get returns the report or structured
output and the sources behind it. jobs list shows research, enrichment, and
prospect-search jobs; filter with --kind and --status.
cancel stops the job. A cancelled or failed research job isn't charged; a
prospect search in enumerate mode keeps what it has already spent. Pass
your own --idempotency-key to start: if the response gets lost, run it
again with the same key and question and you won't start a second job.
Prospect searches from the CRM are research jobs too, and their results are the candidates you import.