Vendo AI

Official149 tools

by vendo-ai

Autonomous AI sales: agents, signal-based prospecting, outreach, CRM — 149 tools.

com.vendo-ai/vendo-ai (Model Context Protocol Server)

The MCP server com.vendo-ai/vendo-ai provides capabilities for autonomous AI sales, centered on agents that perform signal-based prospecting and outreach, and integrate with a CRM. The server exposes 149 tools, enabling developers to build workflows around sales automation.

🛠️ Key Features

Autonomous AI sales support
Agents for sales operations
Signal-based prospecting
Outreach automation
CRM-focused functionality
Exposes 149 tools

🚀 Use Cases

Building agent-driven prospecting workflows
Automating outbound outreach based on signals
Connecting sales outreach with CRM operations
Creating multi-step sales automation using available tools

⚡ Developer Benefits

Large toolset (149 tools) for composing sales flows
Clear focus on prospecting, outreach, and CRM

⚠️ Limitations

Scope is limited to autonomous sales (agents, prospecting signals, outreach, CRM) as described; no additional capabilities are specified.

Captured live from the server via tools/list.

get_balance

Get the current credit balance for the account. Read-only, no side-effects, no cost.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_balance_full

Richer than `get_balance` — returns balance, total subscription credits, total purchased, total spent, free-trial credits, email/workspace info.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_subscription

Plan, status (ACTIVE/CANCELLED/PAST_DUE/EXPIRED/TRIALING), period dates, currency, amount, Stripe IDs.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_subscription_limits

Base + purchased extra agent slots. Useful to check "can I create another agent?" before calling `create_agent`.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_pricing

List of public plans + add-ons (Extra Agent Slot, SDR sender pair, etc.) with prices in user currency.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_credit_transactions

Credit deductions + grants, newest first. Optional filters: type (e.g. EMAIL_SENT, LINKEDIN_INVITE, SDR_CONTACT), date range, pagination.

Parameters5

type	string	optional
from	string	optional	ISO date, e.g. 2026-06-01
to	string	optional	ISO date, e.g. 2026-06-30
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "from": {
      "type": "string",
      "description": "ISO date, e.g. 2026-06-01"
    },
    "to": {
      "type": "string",
      "description": "ISO date, e.g. 2026-06-30"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_invoices

List of Stripe invoices (paid + open). Optional year/month scope.

Parameters2

year	integer	optional
month	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer"
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_credit_usage_by_type

Per-session credit spend grouped by connection type (email_outreach, linkedin_outreach, phone_call, widget, sdr_contact, etc.). Useful for analytics.

Parameters2

from	string	optional
to	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string"
    },
    "to": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_credit_usage_monthly

Calendar-month breakdown of credit spend across all categories.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_credit_usage_by_agent

Total credit spend per agent in the workspace. Identifies the most expensive agents.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_credit_usage_for_agent

Total credits spent by one specific agent.

Parameters1

agent_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_credit_usage_for_agent_connections

Per-channel credit spend (widget, telegram, phone, etc.) for one agent. Identifies the costliest channels.

Parameters1

agent_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_sdr_email_capacity

How many SDR sender email addresses the account has (included + purchased extras) and the estimated daily email throughput. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_agents

List all AI agents in the account. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_agent

Fetch the full details of a single agent by id.

Parameters1

string

required

The agent UUID

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The agent UUID"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_agent

Create a new AI sales agent. Costs 1 credit. The agent is created in DRAFT status and does not start contacting anyone — you still need to attach it to a campaign and launch the campaign. Required: name + description. Company info (name/website/description) is required BEFORE generating a sales script, so you can either pass it here OR call `set_agent_company` later.

Parameters2

name	string	required	Agent's display name (e.g. 'Sales agent for Acme')
description	string	required	A short description of the agent itself (1-2 sentences, what it does)

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Agent's display name (e.g. 'Sales agent for Acme')"
    },
    "description": {
      "type": "string",
      "description": "A short description of the agent itself (1-2 sentences, what it does)"
    }
  },
  "required": [
    "name",
    "description"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

update_agent

Update an agent's basic info (name, description, company info). Partial updates are fine — only include the fields you want to change.

Parameters5

id	string	required
name	string	optional
company_name	string	optional
company_website	string	optional
company_description	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "company_website": {
      "type": "string"
    },
    "company_description": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_delete_agent

Show what would happen if you delete an agent. The agent is NOT deleted. ALWAYS call this first and surface the result to the user before calling `delete_agent`.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_agent

Permanently delete an agent. NOT reversible. Only call after the user has reviewed `preview_delete_agent` output and explicitly approved.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_agents_with_stats

Same as `list_agents` but includes per-agent stats (connections, credits spent, status).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_agent_plan_limits

How many agents can the user create (base plan + purchased extra slots) vs how many they have. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

duplicate_agent

Create a copy of an existing agent (new id, same config). Counts toward agent capacity.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_agent_status

Change agent status. Allowed values: ACTIVE, PAUSED, ARCHIVED, DRAFT.

Parameters2

id	string	required
status	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "PAUSED",
        "ARCHIVED",
        "DRAFT"
      ]
    }
  },
  "required": [
    "id",
    "status"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_agent_company

Required before `generate_agent_script` will work. Set the company the agent represents — its name, website, and what it sells.

Parameters4

id	string	required
company_name	string	required
company_website	string	required
company_description	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "company_website": {
      "type": "string"
    },
    "company_description": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "company_name",
    "company_website",
    "company_description"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_agent_avatar_from_url

Set the agent avatar from a publicly-reachable image URL (jpg, png). The MCP server downloads the image and uploads it on your behalf — you do not need to handle multipart yourself.

Parameters2

id	string	required
image_url	string	required	Publicly reachable HTTPS image URL

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "image_url": {
      "type": "string",
      "description": "Publicly reachable HTTPS image URL"
    }
  },
  "required": [
    "id",
    "image_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_agent_voice

Set agent voice settings: voice_type (e.g. "11labs-Anthony"), language, speed, temperature, backchannel. Call `list_retell_voices` first to see what is available.

Parameters5

id	string	required
voice_type	string	optional
language	string	optional
speech_speed	number	optional
voice_temperature	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "voice_type": {
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "speech_speed": {
      "type": "number"
    },
    "voice_temperature": {
      "type": "number"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_retell_voices

Catalogue of voices that can be assigned via `set_agent_voice`. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

scan_website_quick

Crawl a website's structure (sitemap, top pages) BEFORE creating an agent. Useful when deciding which company to set on the agent. Costs ~2 credits.

Parameters1

website_url

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "website_url": {
      "type": "string"
    }
  },
  "required": [
    "website_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_deep_scan

Show what would happen if you run `deep_scan_agent`. The scan is NOT executed. ALWAYS call this first and confirm the cost (15 credits) and duration with the user.

Parameters3

id	string	required
company_name	string	optional
company_website	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "company_website": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

deep_scan_agent

Crawl 15+ pages of the agent's company website, extract people, contacts, pricing, social links. Saves to the agent. Costs 15 credits. Only call after `preview_deep_scan` and user approval.

Parameters3

id	string	required
company_name	string	required
company_website	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "company_website": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "company_name",
    "company_website"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

save_scan_data

Save the output of a deep scan onto the agent (company description, people, contacts).

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_agent_description

Use AI to draft a 2-3 paragraph company description. Costs 1 credit. Requires `company_website` already set.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_agent_script

Generate the agent's full sales script (8 stages) and email_script (for email/LinkedIn channels). Requires `company_name` AND `company_description` already set on the agent — call `set_agent_company` first. Costs 1 credit. Re-running OVERWRITES the existing script.

Parameters3

id	string	required
script_style	string	required
purpose	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "script_style": {
      "type": "string",
      "enum": [
        "PROFESSIONAL_FORMAL",
        "FRIENDLY_CASUAL",
        "TECHNICAL_EXPERT",
        "CONSULTATIVE"
      ]
    },
    "purpose": {
      "type": "string",
      "enum": [
        "sales",
        "support",
        "info"
      ]
    }
  },
  "required": [
    "id",
    "script_style"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_agent_email

Render a sample outreach email from this agent — no sending, no credit cost. Useful to check tone/script before launching.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_linkedin_invite

Render a sample LinkedIn connection request from this agent. No sending, no cost.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_linkedin_followup

Render a sample first follow-up (after the connection is accepted). No sending, no cost.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_agent_connections

See every channel attached to this agent: widgets, telegram, phone, presentations, etc.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_widget_embed_code

Get the HTML snippet to embed the agent's website widget on a customer's site.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

connect_google_meet

Returns a Google OAuth URL. The user MUST open this URL in a browser and grant consent — the MCP cannot complete OAuth on its own.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_google_meet_meetings

Read-only list of meetings the agent has scheduled. Requires Google Meet connected first.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

disconnect_google_meet

Revoke Google Meet for this agent. Existing meetings stay in the user's calendar.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

connect_telegram_bot

The user creates a bot with @BotFather, gets the HTTP API token, and passes it here. After that, all messages to the bot are answered by the agent.

Parameters2

id	string	required
bot_token	string	required	Telegram Bot API token from @BotFather

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "bot_token": {
      "type": "string",
      "description": "Telegram Bot API token from @BotFather"
    }
  },
  "required": [
    "id",
    "bot_token"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_telegram_bot_info

See the connected bot username + settings.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

disconnect_telegram_bot

Detach the bot from this agent. Bot keeps existing in Telegram but stops responding.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_telegram_analytics

Read-only stats: chats, messages, voice-call duration.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_agent_presentations

Each agent can host one or more interactive presentations. Read-only list.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_narrator_analytics

Views, sessions, conversion to lead, drop-off by slide.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_narrator_leads

Anonymized lead list from CTA forms in presentations.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_list_searches

List active Signal Searches in this workspace. Optionally filter by agent.

Parameters1

agent_id

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_get_search

Fetch one Signal Search by id, including its profile, hunters, and contact counts.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_preview_search

Run Claude on the agent's script and return the auto-generated ICP profile (offer summary, ideal customer profile, relevant topics, LinkedIn queries) WITHOUT persisting anything. Use to review/edit before calling `sdr_create_search`.

Parameters1

agent_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_create_search

Create a Signal Search and immediately activate the configured hunters. Required: name, agent_id. Optional: enabled_sources, target_regions (ISO-2 country codes), pre-edited profile fields from `sdr_preview_search`.

Parameters10

name	string	required
agent_id	string	required
enabled_sources	array	optional	E.g. ['linkedin_jobs', 'connected_people']. Paid sources (ai_web_hunter, g2_reviews, tech_stack) are off by default.
target_regions	array	optional	ISO-2 country codes the search targets, e.g. ['GB', 'US'].
offer_summary	string	optional
icp_summary	string	optional
relevant_topics	object	optional
signal_weights	object	optional
industry_keywords	array	optional
exclude_keywords	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "agent_id": {
      "type": "string"
    },
    "enabled_sources": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "E.g. ['linkedin_jobs', 'connected_people']. Paid sources (ai_web_hunter, g2_reviews, tech_stack) are off by default."
    },
    "target_regions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ISO-2 country codes the search targets, e.g. ['GB', 'US']."
    },
    "offer_summary": {
      "type": "string"
    },
    "icp_summary": {
      "type": "string"
    },
    "relevant_topics": {
      "type": "object",
      "additionalProperties": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "signal_weights": {
      "type": "object",
      "additionalProperties": {
        "type": "number"
      }
    },
    "industry_keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "exclude_keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "name",
    "agent_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_update_search

Edit a Signal Search — name, enabled_sources, target_regions, or profile fields. Partial updates fine.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_activate_search

Set status=active and fire-start all enabled hunters. Reversible via `sdr_pause_search`.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_pause_search

Pause hunters. Existing data stays; no new contacts surface. Reversible via `sdr_resume_search`.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_resume_search

Clear paused state and restart all hunters.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_regenerate_search

Re-run Claude on the agent's current knowledge to regenerate the entire ICP profile and hunter configuration. Useful after the agent's script changed significantly.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_preview_delete_search

Show what would happen if you delete the Signal Search. Nothing is deleted.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_delete_search

Permanently delete a Signal Search. Hunters are paused first, then the search and all its contacts/personas are removed. NOT reversible.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_get_agent_signal_profile

Read the agent's current signal profile (ICP, offer summary, hunter weights). Returns { exists: false } when nothing's generated yet.

Parameters1

agent_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_generate_agent_signal_profile

Run Claude on the agent's knowledge to (re)generate its signal profile. Persists onto the agent so later Signal Searches reuse it.

Parameters1

agent_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_list_personas

List the people Vendo SDR has discovered for a given Signal Search. Filterable by company, role, min_relevance.

Parameters6

search_id	string	required
company	string	optional
role	string	optional
min_relevance	string	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "company": {
      "type": "string"
    },
    "role": {
      "type": "string"
    },
    "min_relevance": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_persona_stats

Aggregate stats: total personas, by_role, top_companies, daily count series, credits_spent, quality_blocked.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_export_personas_to_audience

Take the personas matched by a Signal Search (optionally filtered by role / having email / specific IDs) and export them into a custom audience that can then be attached to any campaign.

Parameters5

search_id	string	required
name	string	optional
only_with_email	boolean	optional
roles	array	optional
ids	array	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "only_with_email": {
      "type": "boolean"
    },
    "roles": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_get_outreach

Read the SDR outreach campaign — channels enabled, ready/queued/sent counts, current content config.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_preview_launch_outreach

Show what would happen if you launch SDR outreach for this search — recipient counts per channel. NOTHING IS SENT. ALWAYS call first and surface the counts to the user.

Parameters3

search_id	string	required
channels	array	optional
sender_mode	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "email",
          "linkedin"
        ]
      }
    },
    "sender_mode": {
      "type": "string",
      "enum": [
        "managed",
        "client_owned"
      ]
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_launch_outreach

Launch SDR outreach. Contacts will start receiving emails and/or LinkedIn invites. Credits spent per message. Only call after `sdr_preview_launch_outreach` and explicit user approval.

Parameters5

search_id	string	required
channels	array	optional
sender_mode	string	optional
daily_email_limit	integer	optional
daily_linkedin_limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "email",
          "linkedin"
        ]
      }
    },
    "sender_mode": {
      "type": "string",
      "enum": [
        "managed",
        "client_owned"
      ]
    },
    "daily_email_limit": {
      "type": "integer"
    },
    "daily_linkedin_limit": {
      "type": "integer"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_get_outreach_content

Read the configured email subject/body templates and LinkedIn invite template for SDR outreach.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_update_outreach_content

Edit email/LinkedIn templates for this SDR outreach. Takes effect on new sends.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_preview_outreach_content

Render an example personalized email/LinkedIn message for a specific contact. Costs ~1 Claude call.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_pause_outreach

Stop sending new messages on this SDR campaign. Reversible.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_resume_outreach

Resume a paused SDR outreach campaign.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_preview_delete_outreach

Show what would happen. The Signal Search ITSELF is NOT deleted, only the outreach campaign.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_delete_outreach

Delete the SDR outreach campaign. The Signal Search and its hunters CONTINUE running. Only call after `sdr_preview_delete_outreach`.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_run_states

Per-source map of run state (running / paused / idle) for a Signal Search.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_health

Operator-level health view: states, signals/contacts produced, credits spent, recent events, learning insights for a single search.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_signal_stats

Signals collected by source over the last N days (max 90, default 30).

Parameters2

search_id	string	required
days_back	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "days_back": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_recent_signals

Last N signals across all Signal Searches in the workspace. Useful for the "is it working?" check.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_company_heat

Composite "heat" ranking — companies with the strongest live signal in the workspace.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_learning_insights

Learned weights per signal type and conversion stats based on real outreach outcomes.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_preview_run_now

Show what would happen if you trigger an immediate hunter run. Useful because some sources are paid (ai_web_hunter, g2_reviews, tech_stack — Anthropic + web_search credits).

Parameters2

search_id	string	required
source	string	optional	Name of one specific hunter, or omit to run all enabled. E.g. 'linkedin_jobs', 'ai_web_hunter', 'connected_people'.

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "description": "Name of one specific hunter, or omit to run all enabled. E.g. 'linkedin_jobs', 'ai_web_hunter', 'connected_people'."
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_run_now

Fire-and-forget kick of one (or all) hunters for this Signal Search. Spends Anthropic + web_search credits for paid sources. Call after `sdr_preview_run_now`.

Parameters2

search_id	string	required
source	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_audience

Search the people graph for prospects matching filters (countries, industries, positions, tags, must-have-email, etc.). PREVIEW only — returns aggregate counts and a small sample. Does not save anything, does not contact anyone, does not spend credits.

Parameters13

countries	array	optional
industries	array	optional
positions	array	optional
cities	array	optional
tags	array	optional
companySizes	array	optional
mustHaveEmail	boolean	optional
mustHaveLinkedin	boolean	optional
mustHavePhone	boolean	optional
searchMode	string	optional
semanticQuery	string	optional
exactKeyword	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "countries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "industries": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "positions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "companySizes": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "startup",
          "small",
          "medium",
          "large",
          "enterprise"
        ]
      }
    },
    "mustHaveEmail": {
      "type": "boolean"
    },
    "mustHaveLinkedin": {
      "type": "boolean"
    },
    "mustHavePhone": {
      "type": "boolean"
    },
    "searchMode": {
      "type": "string",
      "enum": [
        "keyword",
        "exact",
        "semantic"
      ]
    },
    "semanticQuery": {
      "type": "string"
    },
    "exactKeyword": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

save_audience

Save a searchable audience using the same filter set as `search_audience`. The audience is named and can then be attached to a campaign. No outreach happens here.

Parameters2

name	string	optional
filters	object	required

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "properties": {
        "country": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "industries": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "companySize": {
          "type": "string",
          "enum": [
            "startup",
            "small",
            "medium",
            "large",
            "enterprise"
          ]
        },
        "mustHaveEmail": {
          "type": "boolean"
        },
        "mustHavePhone": {
          "type": "boolean"
        },
        "mustHaveLinkedin": {
          "type": "boolean"
        },
        "mustHaveBookingUrl": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "filters"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_campaigns

List all campaigns in the account, with current status and live stats.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_campaign

Fetch full details of a single campaign: status, sequence, channel paused flags, today stats.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_campaign

Create a new campaign in DRAFT status. The campaign is NOT launched — nobody is contacted until you call `launch_campaign`. Needs an audience id and an agent id.

Parameters5

name	string	required
audienceId	string	required
agentId	string	optional
description	string	optional
settings	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "audienceId": {
      "type": "string"
    },
    "agentId": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "settings": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "name",
    "audienceId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

update_campaign

Update a campaign before or after it has started. Partial updates allowed (only include fields you want to change).

Parameters4

id	string	required
name	string	optional
description	string	optional
settings	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "settings": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_launch_campaign

Show what would happen if you launch the campaign: recipient count, channels, daily limit. NOTHING IS SENT. ALWAYS call this first and surface the result to the user (recipient count, channels) before calling `launch_campaign`. This is required by Vendo AI policy and protects the user from a launch they did not intend.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

launch_campaign

Launch the campaign — contacts will start receiving outreach immediately. SPENDS CREDITS continuously while the campaign runs. Only call AFTER the user has reviewed `preview_launch_campaign` output and explicitly approved the recipient count and channels.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

pause_campaign

Pause a running campaign across every channel. Reversible — call `launch_campaign` to resume.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

pause_channel

Pause a single channel (email, linkedin, phone_call, voice_call) on a running campaign. Other channels keep going.

Parameters2

id	string	required
channel	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "channel": {
      "type": "string",
      "enum": [
        "email",
        "linkedin",
        "phone_call",
        "voice_call"
      ]
    }
  },
  "required": [
    "id",
    "channel"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

resume_channel

Resume a paused channel on a campaign.

Parameters2

id	string	required
channel	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "channel": {
      "type": "string",
      "enum": [
        "email",
        "linkedin",
        "phone_call",
        "voice_call"
      ]
    }
  },
  "required": [
    "id",
    "channel"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

archive_campaign

Archive a campaign — it stops processing and is hidden from the default views.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_delete_campaign

Show what would happen if you delete a campaign. The campaign is NOT deleted.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_campaign

Permanently delete a campaign. NOT reversible. Only call after the user has reviewed `preview_delete_campaign` output and explicitly approved.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_list_leads

List leads in the CRM pipeline. Filters: stage (stage id), source (e.g. linkedin_outreach_reply, email_reply_real, widget_chat, manual), q (name/company/email search), range (24h|7d|30d|90d|180d|1y|all), limit/offset. Read-only. Great first call for "who replied to me?".

Parameters6

stage	string	optional
source	string	optional
q	string	optional
range	string	optional
limit	integer	optional
offset	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "stage": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "q": {
      "type": "string"
    },
    "range": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_get_lead

Full lead card: identity, source ("why is this person here"), company enrichment, activities, comments, assignments. Read-only.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_get_conversation

The full message thread with this lead on their source channel (LinkedIn / email / widget / telegram / phone transcript). Read-only.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_stats

Counts per stage, new today/this week, stale leads. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_list_stages

Ordered kanban columns for this workspace (id, name, color, is_terminal). Read-only. Call before moving leads.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_create_lead

Add a lead card to the New stage. ALL fields optional — provide whatever is known (at least one non-empty). Side-effect: a card appears on the customer board.

Parameters7

first_name	string	optional
last_name	string	optional
company_name	string	optional
title	string	optional
email	string	optional
linkedin_url	string	optional
phone	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "linkedin_url": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_update_lead

Patch lead attributes (name, company, title, email, phone, notes, tags, deal_value). Reversible.

Parameters9

id	string	required
first_name	string	optional
last_name	string	optional
company_name	string	optional
title	string	optional
email	string	optional
phone	string	optional
notes	string	optional
deal_value	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    },
    "last_name": {
      "type": "string"
    },
    "company_name": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "deal_value": {
      "type": "number"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_move_lead

Drag-and-drop equivalent: move a lead to a different pipeline stage by stage_id (get ids from crm_list_stages). Reversible.

Parameters2

id	string	required
stage_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "stage_id": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "stage_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_reply_to_lead

Sends a REAL LinkedIn message or email reply to the lead on their source channel, from the customer's own account. Also moves the lead to the "Manager Dialog" stage. ALWAYS show the drafted text to the human and get approval BEFORE calling this.

Parameters2

id	string	required
text	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "text": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id",
    "text"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_add_comment

Internal team note on the lead card (not visible to the lead). Supports @mentions via user ids.

Parameters2

id	string	required
body	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "body": {
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "id",
    "body"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_enrich_from_linkedin

Fetch name / title / current employer / avatar / location for a linkedin.com/in/... URL (same lookup the SDR hunters use). May also suggest an email as an UNVERIFIED pattern guess (email_confidence=pattern_guess). Costs one profile view from the workspace's shared daily LinkedIn budget — do not loop over big lists.

Parameters1

linkedin_url

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "linkedin_url": {
      "type": "string"
    }
  },
  "required": [
    "linkedin_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_create_stage

Add a custom kanban column (name, optional hex color). Inserted before the terminal stages (Won/Lost).

Parameters2

name	string	required
color	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    },
    "color": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_update_stage

Rename or recolor a stage. System stages (New, Manager Dialog) cannot be renamed.

Parameters3

id	string	required
name	string	optional
color	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "color": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_delete_crm_lead

Dry-run of deleting a CRM lead — shows who would be removed from the board. ALWAYS call this first and show the result to the human.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_crm_lead

Soft-delete a lead — it disappears from the pipeline (restorable by support only). Only call after the user reviewed `preview_delete_crm_lead` output and explicitly approved.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_delete_crm_stage

Dry-run of deleting a pipeline stage. Deletion is refused downstream if the stage still holds leads or is a system stage.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_crm_stage

Delete an EMPTY, non-system pipeline stage. Only call after the user reviewed `preview_delete_crm_stage` and explicitly approved.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_list_workspace_members

List the people in this workspace who can own a CRM lead. Use before `reassign_crm_lead` to get valid owner ids. Read-only, free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_list_workspace_agents

List the AI agents in this workspace that CRM leads can be attributed to. Read-only, free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_list_linkedin_accounts

List the LinkedIn accounts connected to this workspace, as shown in the CRM. Useful to see which account owns a conversation. Read-only, free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reassign_crm_lead

Change who owns a lead. Call `crm_list_workspace_members` first to get a valid owner id — passing an unknown id fails. Write operation, no credit cost.

Parameters2

id	string	required	Lead id
owner_id	string	required	New owner — a member id from crm_list_workspace_members

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Lead id"
    },
    "owner_id": {
      "type": "string",
      "description": "New owner — a member id from crm_list_workspace_members"
    }
  },
  "required": [
    "id",
    "owner_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_list_calendar_events

List custom calendar events (meetings, reminders) in the CRM planner for a date range. Note: SDR sending windows also appear in the UI calendar but are derived from the search schedule — read those via `sdr_get_search`. Read-only, free.

Parameters2

from	string	optional	ISO date, start of range
to	string	optional	ISO date, end of range

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "ISO date, start of range"
    },
    "to": {
      "type": "string",
      "description": "ISO date, end of range"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_create_calendar_event

Add a custom event to the CRM planner. Write operation, no credit cost. Does NOT send invites to anyone — it only records the event on the internal calendar.

Parameters5

title	string	required
starts_at	string	required	ISO datetime
ends_at	string	optional	ISO datetime
all_day	boolean	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "starts_at": {
      "type": "string",
      "description": "ISO datetime"
    },
    "ends_at": {
      "type": "string",
      "description": "ISO datetime"
    },
    "all_day": {
      "type": "boolean"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "title",
    "starts_at"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_update_calendar_event

Edit an existing custom calendar event. Write operation, no credit cost.

Parameters6

id	string	required
title	string	optional
starts_at	string	optional
ends_at	string	optional
all_day	boolean	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "starts_at": {
      "type": "string"
    },
    "ends_at": {
      "type": "string"
    },
    "all_day": {
      "type": "boolean"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_delete_calendar_event

Remove a custom calendar event. Unlike deleting a lead or a stage this destroys no history and needs no preview step, but it cannot be undone.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_list_notifications

List CRM notifications (new lead, new reply, stage change). Read-only, free.

Parameters2

limit	number	optional
unread_only	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "unread_only": {
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_mark_notification_read

Mark a single CRM notification as read. Write operation, no credit cost.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_mark_all_notifications_read

Clear the CRM notification badge by marking everything read.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_get_settings

Read CRM settings, including the notify_* toggles that control which events send an email/notification. Read-only, free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_update_settings

Change CRM settings — e.g. mute new-lead or new-reply notifications while an integration drives the CRM itself. Write operation, no credit cost. Turning notifications off means the human stops being alerted, so confirm with the user first.

Parameters4

notify_new_lead	boolean	optional
notify_new_reply	boolean	optional
notify_stage_change	boolean	optional
analytics_emails_enabled	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "notify_new_lead": {
      "type": "boolean"
    },
    "notify_new_reply": {
      "type": "boolean"
    },
    "notify_stage_change": {
      "type": "boolean"
    },
    "analytics_emails_enabled": {
      "type": "boolean"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_communication_cards

One card per campaign and per SDR search, with outbound counters. This is the FULL outbound stream — everyone contacted, whether or not they replied (CRM leads only contains people who answered). Read-only, free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_communication_history

Every outbound touch for one campaign or SDR search, filterable by channel, reply status and date. Use `crm_communication_cards` first to get the id. Read-only, free.

Parameters8

type	string	required
id	string	required	Campaign id or SDR search id
channel	string	optional
replied	boolean	optional
from	string	optional	ISO date
to	string	optional	ISO date
limit	number	optional
offset	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "campaign",
        "sdr"
      ]
    },
    "id": {
      "type": "string",
      "description": "Campaign id or SDR search id"
    },
    "channel": {
      "type": "string",
      "enum": [
        "email",
        "linkedin",
        "phone"
      ]
    },
    "replied": {
      "type": "boolean"
    },
    "from": {
      "type": "string",
      "description": "ISO date"
    },
    "to": {
      "type": "string",
      "description": "ISO date"
    },
    "limit": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    }
  },
  "required": [
    "type",
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

crm_communication_thread

The complete message thread with one contact inside a card. `key` comes from a `crm_communication_history` row (an email address or LinkedIn chat id). Read-only, free.

Parameters3

type	string	required
id	string	required
key	string	required	Thread key from crm_communication_history

Raw schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "campaign",
        "sdr"
      ]
    },
    "id": {
      "type": "string"
    },
    "key": {
      "type": "string",
      "description": "Thread key from crm_communication_history"
    }
  },
  "required": [
    "type",
    "id",
    "key"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_get_person_detail

Full provenance for one person found by SDR: which hunter found them, what query fired, what signal triggered the pick, and the scoring breakdown. Use this to explain to a customer WHY a contact is in their list. Read-only, free.

Parameters1

string

required

Person (persona) id

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Person (persona) id"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_export_people_csv

Export the contacts of an SDR search as CSV text (name, title, email, LinkedIn, location, company). Contacts ONLY — deliberately carries no scores or signal reasoning, because this file leaves the platform. Returns the raw CSV; can be large. Read-only, free.

Parameters4

search_id	string	required
company	string	optional
role	string	optional
min_relevance	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "company": {
      "type": "string"
    },
    "role": {
      "type": "string"
    },
    "min_relevance": {
      "type": "number"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_audiences

List the audiences saved in this workspace. Read-only, free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_audience

Read one saved audience with its filters and contact count. Read-only, free.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_audience_sets

Browse pre-built, ready-to-use audiences available for purchase, plus their categories. Browsing is free; buying costs credits. Read-only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_audience_set

Details of one marketplace set by slug: size, description, freshness. Use the contact count here to work out the purchase cost (2 credits per contact). Read-only, free.

Parameters1

slug

string

required

Human-readable slug, not a UUID

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Human-readable slug, not a UUID"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_audience_set_contacts

Paginated preview of the contacts inside a marketplace set. Contact details stay masked until the set is purchased. Read-only, free.

Parameters3

slug	string	required
offset	number	optional
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    },
    "offset": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_buy_audience_set

Dry-run of purchasing an audience set — shows what would be bought and what it costs, WITHOUT spending credits. ALWAYS call this first and show the cost to the human.

Parameters1

string

required

Set id (UUID), not the slug

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Set id (UUID), not the slug"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

buy_audience_set

SPENDS CREDITS (2 per contact). Purchases the set and snapshots its contacts into the workspace. Only call after the user reviewed `preview_buy_audience_set` output and explicitly approved the cost.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_launch_audience_set

Dry-run of buying a set AND starting outreach against it. Shows the cost without spending anything. ALWAYS call this first.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

launch_audience_set

SPENDS CREDITS and STARTS REAL OUTREACH to real people: buys the snapshot, then runs a campaign against it. The most consequential tool in this list. Only call after the user reviewed `preview_launch_audience_set` and explicitly approved.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_activity_feed

Recent discovery + outreach events for one SDR search, newest first — the same ticker the dashboard shows. Read-only, free.

Parameters2

search_id	string	required
limit	number	optional	Default 40

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    },
    "limit": {
      "type": "number",
      "description": "Default 40"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sdr_outreach_summary

Per-channel sent and queued counts for one SDR search. Read-only, free.

Parameters1

search_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string"
    }
  },
  "required": [
    "search_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_linkedin_accounts

List the LinkedIn accounts connected to this workspace and their status. Each healthy account adds roughly 70–80 invites/day of capacity — check here first when asked why invite volume is low. Read-only, free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

connect_linkedin_account

Returns a hosted URL that a HUMAN must open in a browser to authorise a LinkedIn account. This tool cannot complete the connection itself — give the link to the user. No account exists until they finish the flow.

Parameters1

campaign_id

string

optional

Optionally bind the new account to a campaign

Raw schema

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "Optionally bind the new account to a campaign"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_reconnect_linkedin_account

Dry-run of re-authenticating a LinkedIn account. Explains the side-effects without doing anything. ALWAYS call this first — reconnecting changes the account id upstream and can orphan existing outreach history.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reconnect_linkedin_account

Re-authenticate a LinkedIn account whose session died. Creates a NEW account id upstream: past outreach stays attached to the old id, so per-account history can look empty afterwards and running campaigns may need re-pointing. Only call after the user reviewed `preview_reconnect_linkedin_account` and approved.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

preview_disconnect_linkedin_account

Dry-run of removing a LinkedIn account, showing the capacity that would be lost. ALWAYS call this first.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

disconnect_linkedin_account

Remove a LinkedIn account from the workspace. Any campaign or SDR search sending from it stops immediately and daily capacity drops. Only call after the user reviewed `preview_disconnect_linkedin_account` and explicitly approved.

Parameters1

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

set_agent_contact_channels

Set the meeting link, email, phone, WhatsApp and Telegram that the AI agent gives out when a visitor asks how to get in touch or book a call. Omitted channels are cleared, so always send the full set you want the agent to have. Write operation, no credit cost.

Parameters6

id	string	required	Agent id
meeting_url	string	optional	Booking link, e.g. Calendly
email	string	optional
phone	string	optional
whatsapp	string	optional
telegram	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Agent id"
    },
    "meeting_url": {
      "type": "string",
      "description": "Booking link, e.g. Calendly"
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "whatsapp": {
      "type": "string"
    },
    "telegram": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (149)

get_balanceget_balance_fullget_subscriptionget_subscription_limitsget_pricingget_credit_transactionsget_invoicesget_credit_usage_by_type

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.vendo-ai.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "vendo-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.vendo-ai.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.