MCP Server / Tools Reference
Research Reports
Generate deep-dive prospect research reports.
generate_report⚡ AsyncThis tool starts a background job. Use get_task_status to poll for completion.
Generate a detailed research report for a prospect. Must be scored first. Costs 5 credits.
This is an async operation — it returns a task that runs in the background. Wait for the task to complete (use get_task_status to check), then call get_report with the report ID to read the content. Always returns a task object or a non-empty error string. An empty result means the tool did not execute — no report was started and no credits were charged. Args: campaign_id: The campaign the prospect belongs to. profile_id: The prospect's profile ID. additional_context: Optional context to guide the report.
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| profile_id | string | yes | |
| additional_context | no | Default: null |
get_report
Get a completed research report's content.
Always returns a non-empty string. An empty result means the tool did not execute — do not fabricate report content. Args: report_id: The report ID (returned by generate_report or get_task_status).
| Name | Type | Required | Description |
|---|---|---|---|
| report_id | string | yes |