Skip to main content

​
Authentication

All tools authenticate using the X-API-KEY passed in the MCP server header. No additional auth is needed per-tool call.

​
Workspace Tools

​
list_clients

List all available RevyOps client workspaces accessible via your API key(s). Call this first to discover which workspaces you can query, then pass the workspace name to other tools. Parameters: none Returns: List of workspace names and IDs, with a flag indicating the default workspace.

​
Campaign Tools

​
get_campaigns

Get all campaigns with performance metrics.
ParameterTypeDescription
client_namestringWorkspace name (from list_clients). Uses default if omitted.
date_fromstringFilter start date (YYYY-MM-DD)
date_tostringFilter end date (YYYY-MM-DD)
originstringPlatform filter: instantly, smartlead, emailbison, lemlist
date_groupingstringGroup timeseries: daily, weekly, monthly
Returns: Per-campaign metrics — sent, replies, bounces, interested, reply rate, open rate, click rate, unsubscribes, start/end dates.

​
get_campaign_drilldown

Drill into a specific campaign to see individual contacts or companies.
ParameterTypeDescription
campaign_idstringRequired. Campaign identifier
originstringRequired. Platform: instantly, smartlead, emailbison, lemlist
metric_typestringWhat to show: sends, prospects, replies, interested, bounces (default: sends)
client_namestringWorkspace name
date_startstringFilter start date
date_endstringFilter end date
searchstringSearch by email, name, or company
group_bystringcontacts or companies (default: contacts)
limitintegerMax results (default: 100, max: 5000)

​
get_campaign_stats

Get high-level campaign statistics across all campaigns.
ParameterTypeDescription
client_namestringWorkspace name
date_startstringFilter start date
date_endstringFilter end date

​
add_campaign_note

Add or update a note on a campaign.
ParameterTypeDescription
campaign_idstringRequired. Campaign identifier
originstringRequired. Platform
notestringRequired. Note text
client_namestringWorkspace name

​
archive_campaign

Archive or unarchive a campaign.
ParameterTypeDescription
campaign_idstringRequired. Campaign identifier
originstringRequired. Platform
archivedbooleantrue to archive, false to unarchive (default: true)
client_namestringWorkspace name

​
Contact Tools

​
search_contacts

Search contacts by email, name, domain, or LinkedIn URL.
ParameterTypeDescription
client_namestringWorkspace name
emailstringFilter by email address
first_namestringFilter by first name
last_namestringFilter by last name
domainstringFilter by company domain
linkedin_urlstringFilter by LinkedIn URL

​
get_contact

Get full contact details including custom fields.
ParameterTypeDescription
contact_idstringRequired. Contact ID
client_namestringWorkspace name

​
update_contact

Update a contact’s fields.
ParameterTypeDescription
contact_idstringRequired. Contact ID
first_namestringNew first name
last_namestringNew last name
titlestringNew job title
phonestringNew phone number
statusstringNew contact status
custom_fieldsobjectKey-value pairs of custom field updates
client_namestringWorkspace name

​
Company Tools

​
search_companies

Search companies by domain or name.
ParameterTypeDescription
client_namestringWorkspace name
domainstringFilter by company domain
namestringFilter by company name

​
get_company

Get full company details including custom fields.
ParameterTypeDescription
company_idstringRequired. Company ID
client_namestringWorkspace name

​
update_company

Update a company’s fields.
ParameterTypeDescription
company_idstringRequired. Company ID
namestringNew company name
statusstringNew status
custom_fieldsobjectKey-value pairs of custom field updates
client_namestringWorkspace name

​
Email Tools

​
search_emails

Search email records by campaign, contact, or type.
ParameterTypeDescription
client_namestringWorkspace name
campaign_idstringFilter by campaign
contact_emailstringFilter by contact email address
email_typestringINBOUND, OUTBOUND, or BOUNCED
limitintegerMax results (default: 50)

​
mark_email_interested

Mark or unmark an email reply as interested.
ParameterTypeDescription
email_idstringRequired. Email record ID
interestedbooleantrue to mark, false to unmark (default: true)
client_namestringWorkspace name

​
get_email_thread

Get the full email thread between your team and a contact.
ParameterTypeDescription
contact_idstringRequired. Contact ID
client_namestringWorkspace name
campaign_idstringFilter to a specific campaign
originstringFilter to a specific platform

​
Analytics Tools

​
get_deliverability

Get deliverability metrics broken down by sending domain and inbox.
ParameterTypeDescription
client_namestringWorkspace name
date_startstringFilter start date
date_endstringFilter end date

​
get_contacts_stats

Get contact-level aggregate statistics.
ParameterTypeDescription
client_namestringWorkspace name
date_startstringFilter start (ISO datetime)
date_endstringFilter end (ISO datetime)

​
get_variable_report_variables

Get available tracking variables and campaigns for A/B reporting.
ParameterTypeDescription
client_namestringWorkspace name
start_datestringFilter start
end_datestringFilter end

​
get_variable_report

Generate an A/B test style report grouped by tracking variables.
ParameterTypeDescription
campaign_origin_pairsarrayList of [campaign_id, origin] pairs
variable_fieldsarrayTracking field names to group by
variable_valuesarrayAllowed values for each field
client_namestringWorkspace name
start_datestringFilter start
end_datestringFilter end