MCP connector tools
Every tool the connector offers, with its permission, inputs and what it does.
Generated, do not edit
This page is generated from the code by tools/gen_reference.py. Change the code, then run the generator again. Edits made here are overwritten.
The connector offers 92 tools in this version of the code. 37 are written for the connector itself and 55 are the Ask Adapt tools, offered to the connector through a bridge. A tool is only usable when the key or sign-in carries its permission. See Permissions and limits for what each permission means.
"Read" tools return information. "Prepare" tools only create an approval card in Adapt Leads: nothing changes until a person approves the card in the app. The connector cannot approve.
The book
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
lead_detail |
Read | book:read |
Everything held on one lead. | lead_id (string, required) |
my_account |
Read | account:read |
Plan, export allowance and how much of it is left this month. | none |
my_lists |
Read | account:read |
The operator's saved lists. | none |
opportunities_for |
Read | book:read |
The reasons to talk to a business now, with the signal behind each one. | lead_id (string), name (string), company_number (string), reason (string), how_many (integer) |
resolve_sector |
Read | book:search |
Show which categories a plain-English sector maps to, and how many records sit in each. | sector (string, required) |
search_leads |
Read | book:search |
Search the UK business book. | sector (string), area (string), has_email (boolean), has_phone (boolean), has_website (boolean), has_director (boolean), page (integer), page_size (integer) |
Lists and saved searches
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
add_to_list |
Prepare | outreach:write |
Adding businesses (lead_ids from earlier results, or a search) to one of the user's saved lists. | list_name (string, required), lead_ids (array), sector (string), area (string), keywords (string), verified_email (boolean), has_director (boolean), has_phone (boolean), has_email (boolean), has_website (boolean), how_many (integer) |
archive_list |
Prepare | outreach:write |
Archiving one of the user's saved lists (the way to tidy up; Adapt keeps the data). | list_name (string, required) |
create_list |
Prepare | outreach:write |
A new saved list, empty or filled with businesses from earlier results (lead_ids) or from a search (sector, area...). | name (string, required), lead_ids (array), sector (string), area (string), keywords (string), verified_email (boolean), has_director (boolean), has_phone (boolean), has_email (boolean), has_website (boolean), how_many (integer) |
lists_add |
Change | lists:write |
Add lead ids to a saved list. | list_id (string, required), lead_ids (array, required) |
lists_archive |
Change | lists:write |
Archive a saved list. | list_id (string, required) |
lists_create |
Change | lists:write |
Create a saved list. | name (string, required) |
lists_get |
Read | lists:read |
One saved list. | list_id (string, required) |
restore_list |
Prepare | outreach:write |
Bringing back an archived list. | list_name (string, required) |
searches_list |
Read | lists:read |
Saved searches for this account. | none |
searches_save |
Change | lists:write |
Save a search. | name (string, required), params (object) |
Campaigns
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
campaigns_add_people |
Change | campaigns:write |
Add people to a campaign queue. | campaign_id (string, required), people (array, required) |
campaigns_archive |
Change | campaigns:write |
Archive a campaign. | campaign_id (string, required) |
campaigns_create |
Change | campaigns:write |
Create a draft campaign, or return the existing one with this name. | name (string, required) |
campaigns_get |
Read | campaigns:read |
One campaign, including its sequence. | campaign_id (string, required) |
campaigns_list |
Read | campaigns:read |
This account's campaigns. | none |
campaigns_pause |
Change | campaigns:write |
Pause a campaign. | campaign_id (string, required) |
campaigns_unarchive |
Change | campaigns:write |
Bring an archived campaign back. | campaign_id (string, required) |
enrol_opportunity |
Prepare | outreach:write |
Adding the business behind ONE reason to talk (an opportunity_id from opportunities_for) to one of the user's DRAFT or PAUSED email campaigns. | campaign_name (string, required), opportunity_id (string, required) |
opportunity_outcome |
Prepare | outreach:write |
Recording what came of a reason to talk the user took into a campaign: replied, meeting, won, lost or not_interested. | opportunity_id (string, required), outcome (string (replied, meeting, won, lost, not_interested), required) |
queue_campaign_leads |
Prepare | outreach:write |
Adding businesses (lead_ids from earlier results, or a search) to one of the user's DRAFT or PAUSED email campaigns as recipients. | campaign_name (string, required), lead_ids (array), sector (string), area (string), keywords (string), verified_email (boolean), has_director (boolean), has_phone (boolean), has_email (boolean), has_website (boolean), how_many (integer) |
start_campaign |
Prepare | outreach:write |
Starting (launching a draft, or resuming a paused) email or LinkedIn campaign. | campaign_name (string, required), channel (string (email, linkedin)) |
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
enrol_opportunity_linkedin |
Prepare | outreach:write |
Queueing the right person at the business behind ONE reason to talk (an opportunity_id from opportunities_for) onto one of the user's DRAFT or PAUSED LinkedIn campaigns. | campaign_name (string, required), opportunity_id (string, required) |
linkedin_activity_summary |
Read | linkedin:read |
Today/week activity counts and goals for this account. | none |
linkedin_campaign_activate |
Change | linkedin:orchestrate |
Prepare an approval card so the user can start this campaign in Adapt. | campaign_id (string, required) |
linkedin_campaign_enqueue_leads |
Change | linkedin:orchestrate |
Queue LinkedIn people onto a draft or paused campaign. | campaign_id (string), campaign_name (string), leads_json (string), intent (string), activate (boolean) |
linkedin_campaign_get |
Read | linkedin:read |
One campaign including sequence and member counts. | campaign_id (string, required) |
linkedin_campaign_list |
Read | linkedin:read |
List this account's LinkedIn outreach campaigns with member counts. | none |
linkedin_history |
Read | linkedin:read |
Who queued / decided / executed work for a person or campaign. | linkedin_url (string), campaign_id (string), lead_id (string), limit (integer) |
linkedin_match |
Read | linkedin:read |
Match a LinkedIn person to the Adapt book. | name (string), company (string), domain (string), linkedin_url (string) |
linkedin_status |
Read | linkedin:read |
Enricher presence, arming, connect budget left. | none |
pause_linkedin_campaign |
Prepare | outreach:write |
Pausing one of the user's RUNNING LinkedIn campaigns (email campaigns use pause_campaign). | campaign_name (string, required) |
queue_linkedin_leads |
Prepare | outreach:write |
Queueing people onto one of the user's DRAFT or PAUSED LinkedIn campaigns. | campaign_name (string, required), people (array, required) |
Email outreach and replies
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
add_suppression |
Prepare | outreach:write |
Adding email addresses or whole domains to the user's do-not-contact list (Settings) and to Adapt Outreach's blocklist, so campaigns never email them. | values (array, required), reason (string) |
campaign_drafts |
Read | outreach:read |
Show the emails written for an email campaign (email 1 per lead): who each goes to, the subject, a short preview, and why a lead has none (held, excluded). | campaign_name (string, required) |
campaign_report |
Read | outreach:read |
Explain one campaign's numbers (email or LinkedIn): status, recipients, sent, replies and reply rate, replies by type, pace, schedule, approval and spam check; for LinkedIn queued, sent, accepted, replied. | campaign_name (string, required) |
campaign_settings |
Prepare | outreach:write |
Changing one email campaign's sending limits (daily_min and daily_max: each day sends a steady number between them; daily_limit: a hard cap) and working hours (days e.g. | campaign_name (string, required), daily_min (integer), daily_max (integer), daily_limit (integer), days (string), start_time (string), end_time (string), timezone (string) |
draft_reply |
Read | outreach:read |
Help answer a campaign reply. | reply (string, required), body (string), subject (string) |
mark_reply |
Prepare | outreach:write |
Labelling a campaign reply in the Unibox (status: interested, meeting_booked, question, out_of_office, wrong_person, not_interested, unknown) and/or marking it read. | reply (string, required), status (string (interested, meeting_booked, question, out_of_office, wrong_person, not_interested, unknown)), mark_read (boolean) |
morning_summary |
Read | outreach:read |
A morning briefing: new and unread replies (and which look interested), how each running campaign is doing (sent, replies), LinkedIn campaigns, today's activity goals, exports left this month, and what moved... | none |
outreach_campaigns |
Read | outreach:read |
The user's email outreach campaigns: status (draft, active, paused...), recipients, sent, replies and whether the drafts are approved. | none |
outreach_replies |
Read | outreach:read |
Replies to the user's email campaigns (newest first), with who wrote, the campaign, a preview and how each was classified (interested, question, out of office...). | unread_only (boolean), limit (integer) |
pause_campaign |
Prepare | outreach:write |
Pausing one of the user's SENDING email campaigns: it stops sending at once, follow-ups included. | campaign_name (string, required) |
write_campaign_emails |
Prepare | outreach:write |
Pressing Write emails on a DRAFT or PAUSED email campaign that writes email 1 per lead: each ready lead gets its own checked email 1. | campaign_name (string, required) |
CRM
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
add_reminder |
Prepare | outreach:write |
Adding a reminder (a dated task) to the user's Tasks page and Home screen: title, date (YYYY-MM-DD, today, tomorrow or a weekday), time (HH:MM UK time) and optionally the business it is about. | title (string, required), date (string), time (string), business (string) |
arrivals_recent |
Read | crm:read |
The latest enquiries to one inlet (name or id from inlets_list): when, whether each became a record, and any marks (possible spam, test, possible duplicate...). | inlet (string, required), how_many (integer) |
assign_lead |
Prepare | crm:write |
Giving a CRM record (a lead, company, person or deal) to one person in the CRM, found by name, email or account_id from team_roster. | person (string), record_id (string), record_name (string), object (string) |
crm_add_note |
Prepare | crm:write |
A note on a CRM record, in the user's words. | text (string), record_id (string), record_name (string), object (string) |
crm_archive_record |
Prepare | crm:write |
Archiving a CRM record (the way to tidy up; Adapt keeps the data). | record_id (string), record_name (string), object (string) |
crm_archive_task |
Prepare | crm:write |
Archiving a task on a CRM record, found by its title (Adapt keeps the data; it can be brought back). | task_title (string), record_id (string), record_name (string), object (string) |
crm_create_record |
Prepare | crm:write |
A new CRM record: object is leads, orgs, contacts or deals; values by field name (e.g. | object (string (leads, orgs, contacts, deals), required), values (object, required), stage (string), link_org (string), link_contact (string) |
crm_create_task |
Prepare | crm:write |
A task on a CRM record (a title and an optional due date). | title (string), due (string), record_id (string), record_name (string), object (string) |
crm_pipeline |
Read | crm:read |
The user's sales pipeline: for every stage, how many deals and their total and weighted value (GBP, lifetime), plus the biggest open deals and the ones that have gone quiet. | none |
crm_recent_activity |
Read | crm:read |
The latest events across the CRM (notes, calls, stage moves, new records), newest first, each with its record's name. | limit (integer) |
crm_record |
Read | crm:read |
One CRM record in full, for a brief: its fields, linked organisation/contact/deals, latest notes, open tasks and recent timeline. | record_id (string), name (string), object (string (leads, orgs, contacts, deals)) |
crm_restore_record |
Prepare | crm:write |
Bringing back an archived CRM record. | record_id (string), record_name (string), object (string) |
crm_search |
Read | crm:read |
Search the user's CRM (their team workspace). | object (string (leads, orgs, contacts, deals), required), text (string), stage (string), status (string), limit (integer) |
crm_update_deal |
Prepare | crm:write |
Changing a CRM record: move a deal to another stage (a lost stage needs lost_reason), and/or set field values (by field name, e.g. | record_id (string), record_name (string), object (string), stage (string), lost_reason (string), values (Any) |
inlets_list |
Read | crm:read |
The ways enquiries reach the user's CRM: each form, webhook or connected tool, with where it files leads, how many have arrived, what is waiting, who gets a new one and whether a reminder is set. | none |
lead_brief |
Read | crm:read |
What the book can say about the business behind ONE CRM record (a record_id from an earlier result): how sure the match is, which source kinds agree or differ with what the record says, when each source was... | record_id (string, required) |
Reports and the calling console
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
account_overview |
Read | reports:read |
The user's Home: what moved on the businesses they own (movers: news, contract wins, hires, director changes, with dates), risk signals, how many companies they hold, how good those records are, lists,... | none |
assign_dial_pack |
Prepare | outreach:write |
Handing a caller-console list (a dial pack already sent to the console) to a calling team; their manager then shares the calls out. | list_name (string, required), team_name (string, required) |
dialler_lists |
Read | outreach:read |
Lists already sent to the caller console. | none |
dialler_teams |
Read | outreach:read |
Calling teams for this organisation. | none |
report_analytics |
Read | reports:read |
Activity counts for this account. | none |
report_outreach |
Read | reports:read |
How this account's outreach is doing. | none |
Team
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
team_activity |
Read | outreach:read |
What the team has been doing: the latest CRM events with who did each (notes, calls, stage moves, new records). | limit (integer) |
team_members |
Read | team:read |
People in this organisation. | none |
team_roster |
Read | crm:read |
The people in the user's CRM who can be given a lead, with their role and whether they are on the rota. | none |
user_deactivate |
Prepare | team:write |
Deactivating a member. | account_id (string, required) |
user_invite |
Prepare | team:write |
Inviting someone to this organisation by email, as a member or an admin. | email (string, required), role (string (member, admin)) |
user_invites |
Read | team:read |
Pending invites for this organisation. | none |
user_reactivate |
Prepare | team:write |
Making a deactivated member active again. | account_id (string, required) |
user_set_role |
Prepare | team:write |
Changing a member's role to member or admin. | account_id (string, required), role (string (member, admin), required) |
Calendar and connections
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
calendar_create_event |
Prepare | connections:write |
Creating one event on the user's connected Google Calendar. | title (string, required), start (string, required), end (string), duration_minutes (integer), description (string), add_meet (boolean), invitees (array) |
calendar_free_slots |
Read | connections:read |
Find free slots on the user's Google Calendar using free/busy, inside working hours (default 09:00-17:30 UK, weekdays) for a meeting of the requested length (default 30 minutes). | start_date (string), end_date (string), duration_minutes (integer), day_start (string), day_end (string) |
calendar_upcoming |
Read | connections:read |
List upcoming events on the user's connected Google Calendar. | start (string), end (string), limit (integer) |
calendar_update_event |
Prepare | connections:write |
Rescheduling, retitling or changing invitees on an event Adapt created for this account. | event_id (string, required), title (string), start (string), end (string), duration_minutes (integer), invitees (array), description (string) |
connections_status |
Read | connections:read |
Whether LinkedIn posting and Google Calendar are connected, and where the mailbox is connected. | none |
Reveal, enrich and export
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
credits_balance |
Read | account:read |
Credit balance and how many reveals this account has made. | none |
enrich_lead |
Prepare | book:reveal |
Re-checking one business now (Enrich: Adapt re-reads its website and public records for fresher details). | lead_id (string), name (string) |
export_list |
Prepare | book:reveal |
Exporting one saved list to a CSV file. | list_name (string, required) |
reveal_lead |
Prepare | book:reveal |
Revealing one business's contact details (email, phone...). | lead_id (string), name (string) |
reveals_list |
Read | book:read |
Leads this account has already revealed. | none |
Account and other
| Tool | Kind | Permission | What it does | Inputs |
|---|---|---|---|---|
my_settings |
Read | account:read |
The user's current settings: theme, density, results per page, time zone, profile, reply alerts, digest, do-not-contact count and Adapt Outreach settings. | none |
pending_approvals |
Read | account:read |
Approvals waiting for this user in Adapt. | none |
posts_list |
Read | posts:read |
Draft and scheduled posts. | none |