MCP Server / Tools Reference
Contact Enrichment
Find verified emails and phone numbers.
enrich_email⚡ AsyncThis tool starts a background job. Use get_task_status to poll for completion.
Find and verify a prospect's email address. Costs 2 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_prospect to see the enriched email in the contact info. Always returns a task object or a non-empty error string. An empty result means the tool did not execute — no enrichment was started and no credits were charged. Args: campaign_id: The campaign the prospect belongs to. profile_id: The prospect's profile ID.
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| profile_id | string | yes |
enrich_phone⚡ AsyncThis tool starts a background job. Use get_task_status to poll for completion.
Find and verify a prospect's phone number. 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_prospect to see the enriched phone in the contact info. Always returns a task object or a non-empty error string. An empty result means the tool did not execute — no enrichment was started and no credits were charged. Args: campaign_id: The campaign the prospect belongs to. profile_id: The prospect's profile ID.
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| profile_id | string | yes |
report_inaccurate_contact
Flag a contact email or phone as inaccurate. Free — no credits.
Always returns a non-empty confirmation string. An empty result means the tool did not execute — the contact was not flagged. Args: campaign_id: The campaign the prospect belongs to. profile_id: The prospect's profile ID. field: Which contact type — "email" or "phone". value: The exact email or phone string that is wrong. reason: Why it's wrong — "bounced", "wrong_person", "outdated", or "other".
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| profile_id | string | yes | |
| field | "email" | "phone" | yes | |
| value | string | yes | |
| reason | no | Default: null |
retry_enrichment⚡ AsyncThis tool starts a background job. Use get_task_status to poll for completion.
Retry contact enrichment with an alternative source. Same cost as initial enrichment.
Always returns a task object or a non-empty error string. An empty result means the tool did not execute — no retry was started and no credits were charged. Args: campaign_id: The campaign the prospect belongs to. profile_id: The prospect's profile ID. enrichment_type: "email" or "phone".
| Name | Type | Required | Description |
|---|---|---|---|
| campaign_id | string | yes | |
| profile_id | string | yes | |
| enrichment_type | "email" | "phone" | yes |