MCP / Developer reference
MCP tool reference
Find the tools for each task and the permission each one requires.
This index is generated from Vendita’s tool registry. Use tools/list for current argument schemas and whoami for the live toolset and your permissions.
“Read” is the server’s tool annotation. Some previews store a proposal even when marked as read tools. “Write” can change data, start a test, or prepare a purchase; it does not necessarily send SMS. See permissions and actions.
Tools with no specific scope still require an authenticated MCP connection. Plan and readiness checks apply in addition to permissions.
Connection and playbooks
| Tool | Purpose | Permission | Type |
|---|---|---|---|
library_list | List library documents | Authenticated connection | Read |
library_read | Read a library document | Authenticated connection | Read |
library_search | Search the library | Authenticated connection | Read |
list_personas | List simulation personas | Authenticated connection | Read |
whoami | Who am I | Authenticated connection | Read |
Agents and testing
| Tool | Purpose | Permission | Type |
|---|---|---|---|
activate_agent | Activate agent | agents:write | Write |
activate_agent_version | Activate an agent version | agents:write | Write |
create_agent | Create agent | agents:write | Write |
get_agent | Get agent | agents:read | Read |
get_agent_actions | Get the agent's actions | agents:read | Read |
get_agent_sandbox | Read the sandbox conversation | agents:read | Read |
get_agent_spec | Get the agent spec | agents:read | Read |
get_simulation | Get a simulation run | agents:read | Read |
list_agent_versions | List agent versions | agents:read | Read |
list_agents | List agents | agents:read | Read |
list_simulations | List simulation runs for an agent | agents:read | Read |
set_agent_actions | Switch the agent's actions on or off | agents:write | Write |
set_agent_instructions | Set agent instructions | agents:write | Write |
set_agent_spec | Set the agent spec | agents:write | Write |
simulate_agent | Simulate the agent against test contacts | agents:write | Write |
test_agent_reply | Test the agent in the sandbox | agents:write | Write |
Campaigns
| Tool | Purpose | Permission | Type |
|---|---|---|---|
confirm_campaign_compliance | Confirm campaign consent | campaigns:launch | Write |
create_campaign | Create campaign | campaigns:write | Write |
enroll_contacts | Enrol contacts in campaign | campaigns:write | Write |
get_campaign | Get campaign | campaigns:read | Read |
get_campaign_availability | What times a campaign can offer right now | campaigns:read | Read |
launch_campaign_confirm | Confirm campaign launch | campaigns:launch | Write |
launch_campaign_preview | Preview campaign launch | campaigns:launch | Read |
list_calendar_connections | Connected calendars | campaigns:read | Read |
list_campaigns | List campaigns | campaigns:read | Read |
pause_campaign | Pause campaign | campaigns:write | Write |
update_campaign | Update campaign | campaigns:write | Write |
Contacts
| Tool | Purpose | Permission | Type |
|---|---|---|---|
add_contacts | Add contacts | contacts:write | Write |
list_contacts | List contacts | contacts:read | Read |
Conversations and callbacks
| Tool | Purpose | Permission | Type |
|---|---|---|---|
complete_callback_request | Complete or cancel a callback request | conversations:write | Write |
get_conversation | Get conversation | conversations:read | Read |
list_callback_requests | List callback requests | conversations:read | Read |
list_conversations | List conversations | conversations:read | Read |
Analytics
| Tool | Purpose | Permission | Type |
|---|---|---|---|
get_analytics | Get analytics | analytics:read | Read |
Billing and allowance
| Tool | Purpose | Permission | Type |
|---|---|---|---|
add_credit_confirm | Confirm buying credit | billing:write | Write |
add_credit_preview | Preview buying credit | billing:write | Write |
buy_simulations_confirm | Confirm buying extra simulations | billing:write | Write |
buy_simulations_preview | Preview buying extra simulations | billing:write | Write |
get_plan | Plan, credit, usage and the price of the next contact | billing:read | Read |
get_usage | Get usage | billing:read | Read |
list_credit_history | Credit history | billing:read | Read |
set_auto_reload | Turn auto reload on or off | billing:write | Write |
set_spend_cap | Set the monthly spend cap | billing:write | Write |
Agent knowledge
| Tool | Purpose | Permission | Type |
|---|---|---|---|
set_agent_sales_brain | Set agent sales brain | knowledge:write | Write |
CRM imports and write-back
| Tool | Purpose | Permission | Type |
|---|---|---|---|
get_crm_import | Progress of a CRM import | crm:read | Read |
get_crm_import_options | What a CRM import can filter on | crm:read | Read |
get_crm_write_back | Whether the agent writes to a CRM | crm:read | Read |
list_crm_connections | CRM connections | crm:read | Read |
preview_crm_import | Preview a CRM import | crm:write | Read |
save_crm_import_filter | Save what a CRM import brings in | crm:write | Write |
set_crm_write_back | Switch CRM write-back on or off | crm:write | Write |
start_crm_import | Import contacts from the CRM | crm:write | Write |
Phone numbers
| Tool | Purpose | Permission | Type |
|---|---|---|---|
buy_number_confirm | Confirm buying a number | numbers:write | Write |
buy_number_preview | Preview buying a number | numbers:write | Write |
list_numbers | Numbers this workspace sends from | agents:read | Read |
number_readiness | Can a number be bought for a country? | agents:read | Read |
release_number | Release a purchased number | numbers:write | Write |
search_numbers | Find available numbers | numbers:write | Read |
Business registration
| Tool | Purpose | Permission | Type |
|---|---|---|---|
get_compliance | Verification status and what is still needed | compliance:read | Read |
get_compliance_case | Get one verification case | compliance:read | Read |
set_business_profile | Save the business profile used for verification | compliance:write | Write |
start_compliance | Start a verification case for a country | compliance:write | Write |
submit_compliance | Submit a verification case | compliance:write | Write |
Message checks
| Tool | Purpose | Permission | Type |
|---|---|---|---|
list_content_blocks | Messages the content screen refused | messages:read | Read |