MCP Tools Reference
Complete reference for all 27 MisarReach MCP tools — inputs, required fields, and behavior.
All tools are exposed by the misar-reach MCP server. Authentication is handled automatically via MISARREACH_API_KEY. All responses are JSON strings.
Lead Finder
list_leads
List saved leads for the authenticated user. Supports pagination and search by name, email, or company.
| Parameter | Type | Description |
|---|---|---|
page | number | Page number (default: 1) |
limit | number | Results per page (default: 20, max: 100) |
search | string | Filter by name, email, or company |
job_id | string | Filter leads by a specific search job UUID |
search_leads
Start an AI-powered lead search job. Returns a jobId immediately — poll get_search_job_status for results. Consumes search credits.
Required: query
| Parameter | Type | Description |
|---|---|---|
query | string | Search query describing the ideal lead (2–200 chars) |
useAI | boolean | Use AI to enrich and score results (default: false) |
filters | object | Optional filters: location, role, industry, companySize (e.g. "10-50") |
get_search_job_status
Poll the status and results of a lead search job.
Required: jobId
| Parameter | Type | Description |
|---|---|---|
jobId | string | Lead search job UUID |
submit_lead_feedback
Submit positive or negative feedback on an AI-generated lead message to improve future output quality.
Required: jobId, leadEmail, feedback
| Parameter | Type | Description |
|---|---|---|
jobId | string | Lead search job UUID |
leadEmail | string | Email address of the lead |
feedback | string | positive | negative |
discover_companies
Discover companies matching criteria via Hunter.io. Optionally fetch contact emails for each company.
| Parameter | Type | Description |
|---|---|---|
query | string | Free-text company search query |
industry | array | Industry filters (max 10) |
location | array | Location filters (max 10) |
headcount_min | number | Minimum employee count |
headcount_max | number | Maximum employee count |
technology | array | Technology stack filters (max 10) |
fetch_emails | boolean | Also fetch contact emails (default: false) |
limit | number | Max companies to return (1–100, default: 20) |
enrich_lead
Enrich a lead with person and company data (seniority, department, LinkedIn, phone, company size, industry). Consumes enrichment credits.
Required: leadId
| Parameter | Type | Description |
|---|---|---|
leadId | string | Lead UUID from list_leads |
verify_emails
Verify email deliverability for one or more email addresses. Consumes verification credits.
| Parameter | Type | Description |
|---|---|---|
email | string | Single email to verify (use this OR emails) |
emails | array | Batch of emails to verify (max 20) |
score_leads
Trigger on-demand AI scoring for all unscored leads in a job, or a specific set of lead IDs. Runs in the background — returns immediately with a count. Consumes AI credits.
| Parameter | Type | Description |
|---|---|---|
jobId | string | Score all unscored leads for this job UUID (use this OR leadIds) |
leadIds | array | Specific lead UUIDs to (re)score (max 200, use this OR jobId) |
list_lead_lists
List Hunter.io lead lists associated with the account. No parameters.
create_lead_list
Create a new Hunter.io lead list.
Required: name
| Parameter | Type | Description |
|---|---|---|
name | string | List name (1–200 chars) |
sync_lead_list
Sync a Hunter.io lead list into local lead records.
Required: listId
| Parameter | Type | Description |
|---|---|---|
listId | string | Hunter.io list ID (integer as string) |
preview_message
Generate a sample AI-personalised outreach message for a person.
Required: name
| Parameter | Type | Description |
|---|---|---|
name | string | Person's full name (1–100 chars) |
role | string | Job title or role (optional, max 100 chars) |
company | string | Company name (optional, max 100 chars) |
send_to_campaign
Bulk-import selected lead IDs into a campaign's contact list. Leads must belong to the authenticated user.
Required: leadIds, campaignId
| Parameter | Type | Description |
|---|---|---|
leadIds | array | Lead UUIDs to import (1–500) |
campaignId | string | Target campaign UUID |
listId | string | Target contact list UUID (defaults to campaign's own list) |
Deals & Pipeline
list_deals
List deals with an optional status filter. Returns a deals array plus revenue summary (total, closed, pipeline).
| Parameter | Type | Description |
|---|---|---|
status | string | Filter by status (new, contacted, interested, meeting, proposal, closed, lost) |
limit | number | Max results (default: 50, max: 100) |
offset | number | Pagination offset (default: 0) |
create_deal
Create a new deal linked to a lead email.
Required: leadEmail
| Parameter | Type | Description |
|---|---|---|
leadEmail | string | Lead's email address |
leadName | string | Lead's display name |
value | number | Deal value in minor currency units (default: 0) |
currency | string | ISO 4217 currency code (default: USD) |
notes | string | Deal notes (max 5000 chars) |
conversationId | string | UUID of associated conversation |
campaignId | string | UUID of associated campaign |
contactId | string | UUID of associated contact |
update_deal
Update a deal's status, value, or notes.
Required: dealId
| Parameter | Type | Description |
|---|---|---|
dealId | string | Deal UUID |
status | string | interested | meeting | proposal | closed | lost |
value | number | Updated deal value in minor currency units |
notes | string | Updated deal notes (max 5000 chars) |
get_pipeline
Get the full sales pipeline board with deals grouped by stage (new, contacted, interested, meeting, proposal, closed, lost) plus revenue totals.
| Parameter | Type | Description |
|---|---|---|
workspaceId | string | Optional workspace UUID to filter the pipeline |
move_deal_stage
Move a deal to a new pipeline stage (drag-and-drop equivalent).
Required: dealId, newStage
| Parameter | Type | Description |
|---|---|---|
dealId | string | Deal UUID |
newStage | string | new | contacted | interested | meeting | proposal | closed | lost |
Autopilot
start_autopilot
Start an AI autopilot run for outreach automation. Provide a goal and the agent runs fire-and-forget. Returns a runId — poll get_autopilot_status for progress. Consumes autopilot credits.
Required: goal
| Parameter | Type | Description |
|---|---|---|
goal | string | Outreach goal description (10–500 chars) |
workspace_id | string | Optional workspace UUID to associate with this run |
list_autopilot_runs
List past autopilot runs with their status and summary results.
| Parameter | Type | Description |
|---|---|---|
limit | number | Max results (default: 20) |
offset | number | Pagination offset |
get_autopilot_status
Get the current status and progress of a specific autopilot run.
Required: runId
| Parameter | Type | Description |
|---|---|---|
runId | string | Autopilot run UUID |
Channels
get_channels_status
Get the status, configuration, and delivery stats for all outreach channels (WhatsApp, SMS, push notifications). No parameters.
update_channel
Enable or disable a specific outreach channel.
Required: channel, enabled
| Parameter | Type | Description |
|---|---|---|
channel | string | whatsapp | sms | push |
enabled | boolean | Enable (true) or disable (false) the channel |
Sales Agent
get_sales_agent_config
Fetch the current user's AI sales agent configuration. No parameters.
update_sales_agent_config
Update the AI sales agent configuration (enable/disable, cal link, offer price, reply limits, confidence threshold).
| Parameter | Type | Description |
|---|---|---|
enabled | boolean | Enable or disable the sales agent |
cal_link | string | Calendly or Cal.com URL for meeting booking (max 500 chars, null to clear) |
offer_price | number | Offer price in minor currency units (integer, min 0) |
offer_description | string | Short description of the offer (max 1000 chars, null to clear) |
max_replies_per_day | number | Maximum automated replies per day (1–500, default: 20) |
confidence_threshold | number | Confidence score below which the agent flags for human review (0.0–1.0, default: 0.65) |
get_sales_agent_actions
Fetch today's AI sales agent actions and summary stats (total actions, deals closed, flagged for human review). No parameters.
process_sales_agent
Run the AI sales agent pipeline on a conversation — decides the next action and optionally generates a reply. Logs the action to the agent activity feed.
Required: conversationId
| Parameter | Type | Description |
|---|---|---|
conversationId | string | UUID of the conversation to process |