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_linkedin_upload_cost
Preview the cost of uploading LinkedIn profiles without charging.
Use before upload_linkedin_profiles so the user can approve the spend. Accepts 1-50 unique profile URLs after normalization; all form one run.
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| linkedin_urls | array | yes |
upload_linkedin_profiles⚡ AsyncThis tool starts a background job. Use get_task_status to poll for completion.
Upload and score LinkedIn profiles in one asynchronous campaign run. Spends credits.
Preview the cost and confirm with the user before calling. Do not split the URL list into multiple calls; a live run blocks another campaign run. Returns one task to poll with get_task_status, or a non-empty error.
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| linkedin_urls | array | yes |
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 |