coldvioDocs
Start free
Docs/ tools
Reference

MCP tool reference

Seventeen focused tools expose the Coldvio workflows that make sense in an agent. Every tool is tenant-scoped; consequential operations require confirmation.

Open tool catalog JSONRead as Markdown
Read: 12Write: 1Generate: 2Approve: 2
get_summary

Get account summary

agent:readRead

Return credits and counts for contacts, active campaigns, pending approvals, and open posts.

get_voice_profile

Get voice profile

agent:readRead

Read the active voice narrative, rules, audit, and strength.

list_contacts

List contacts

agent:readRead

Search the customer's own CRM contacts with narrow filters and limits.

get_contact

Get contact

agent:readRead

Read one tenant-owned contact and its recorded message history.

update_contact

Update contact

agent:writeWriteconfirmation required

Update CRM status, notes, tags, or follow-up date.

list_lead_lists

List lead lists

agent:readRead

List lead lists owned by the signed-in customer.

list_leads

List leads

agent:readRead

Search leads inside one tenant-owned lead list.

list_campaigns

List campaigns

agent:readRead

List the customer's outreach campaigns.

get_campaign

Get campaign

agent:readRead

Read one campaign and its configured steps.

list_actions

List campaign actions

agent:readRead

List queued, approval-pending, sent, failed, or replied campaign actions.

approve_action

Approve campaign action

agent:approveApproveconfirmation required

Approve one pending action; approval may queue an external LinkedIn action.

reject_action

Reject campaign action

agent:approveApproveconfirmation required

Permanently reject one pending campaign action.

list_posts

List content posts

agent:readRead

List ideas, drafts, scheduled posts, or published posts.

get_post

Get content post

agent:readRead

Read one tenant-owned post including preflight results.

generate_linkedin_draft

Generate LinkedIn draft

agent:generateGenerateconfirmation required

Spend credits to generate outreach, reply, comment, or CRM-action copy. It does not send.

generate_email_draft

Generate email draft

agent:generateGenerateconfirmation required

Spend credits to generate an email draft in the customer's voice. It does not send.

Deliberate omissions

Coldvio does not expose direct send, direct publish, or generic execute tools. Draft generation does not send content. Approval is explicit because it may queue an external LinkedIn action.