MCP Server / Tools Reference
Search
Run a campaign to find and score prospects.
run_campaign⚡ AsyncThis tool starts a background job. Use get_task_status to poll for completion.
Start finding and scoring prospects for a campaign. Spends credits.
The campaign must have training and filters set before running. Use preview_campaign_cost first to see the cost before committing. Always returns a task object or a non-empty error string. An empty result means the tool did not execute — the search did not start and no credits were charged. Do not poll for status or assume prospects are being found. Args: campaign_id: The campaign to run. batch_size: Number of profiles to find (10, 30, 50, or 100). Default 30.
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| batch_size | "10" | "30" | "50" | "100" | no | Default: 30 |
preview_campaign_cost
Preview the credit cost of running a campaign without charging.
Use this before run_campaign to check the cost and confirm with the user. Args: campaign_id: The campaign to preview. batch_size: Number of profiles to find (10, 30, 50, or 100). Default 30.
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| batch_size | "10" | "30" | "50" | "100" | no | Default: 30 |