get_lead
Get Lead
Retrieve full details of a specific lead including contact information, engagement metrics, custom variables, and campaign association.
Ask your agent in plain language. Each of these maps to a real tool on the server.
get_lead
Retrieve full details of a specific lead including contact information, engagement metrics, custom variables, and campaign association.
update_campaign
Update a campaign's settings. Can modify name, schedule, daily limits, tracking options, and other configuration. Also supports launching (activating) or pausing a campaign by setting the desired action.
get_campaign_analytics
Retrieve analytics for one or more campaigns, including sends, opens, clicks, replies, bounces, and CRM metrics. Supports overview, daily breakdown, and per-step views.
manage_custom_tags
List, create, delete custom tags, and assign or unassign tags to campaigns and email accounts. Tags help organize and filter resources in the workspace.
manage_account_campaign_mappings
Read campaigns associated with a sending account, or the sender list of a campaign. The current documented API has no mapping create/delete operation or opaque mapping ID; legacy add/remove actions are retained but cannot execute.
update_lead
Update a lead's information, custom variables, or interest status. Can update contact details and also change the lead's interest status for a specific campaign.
manage_lead_lists
List, create, update, or delete lead lists. Lead lists organize leads into groups that can be associated with campaigns or used independently.
reply_to_email
Send a real email reply to an existing thread from a connected sending account. The recipient must match the sender of the original message; this tool cannot send arbitrary new emails. Requires emails:read and emails:create permissions.
list_email_accounts
List connected email sending accounts in the workspace. Supports searching, filtering by status and tags, and pagination.
list_campaigns
List campaigns in the Instantly workspace. Supports searching by name, filtering by status and tags, and cursor-based pagination.
list_emails
List sent and received emails from the unified inbox. Filter by campaign, lead, sending account, read/unread status, or search by email address or thread ID.
manage_block_list
List, add, or remove entries from the email block list. Blocked entries prevent emails from being sent to specific addresses or domains.
verify_email
Verify an email address to check its deliverability before adding it to a campaign. Returns the verification status (valid, invalid, risky, catch_all, pending). If the result is pending, use the same tool with checkOnly to poll for the result.
get_campaign
Retrieve full details of a specific campaign including its schedule, sequences, settings, and status.
delete_lead
Permanently delete a lead from the workspace. This action cannot be undone.
get_email_account
Retrieve full details of a specific email sending account by its email address. Includes warmup settings, tracking domain, status, and sending configuration.
manage_email_account
Pause, resume, update settings, or delete a connected email sending account. Supports updating daily limits and sending gaps. Resuming can send real emails; deletion removes the connected account.
list_leads
List leads in a campaign or lead list with cursor-based pagination. interestStatus filters each returned provider page locally; an empty filtered page may still have a cursor that must be followed.
create_lead
Add a new lead to a campaign or lead list. Supports custom variables for personalization. The lead can be optionally skipped if they already exist in the workspace or campaign.
manage_lead_labels
List, create, update, or delete lead labels. Labels categorize lead statuses and responses within campaigns. Current labels have a positive, negative, or neutral category; the current API does not expose color settings.
move_leads
Submit a background job to transfer specified leads from a source campaign or list to a destination campaign or list. Moving to an active campaign can initiate sending. Use get_background_job to check completion.
delete_campaign
Permanently delete a campaign. This action cannot be undone.
create_campaign
Create a new cold email campaign. At minimum, provide a name and schedule. Sequences (email steps) can be added at creation or later.
get_background_job
Read a submitted background job, including lead-move progress and status. Requires background-jobs:read or an equivalent broader scope. A failed job may still have partially changed resources; read back before retrying.
get_email
Read a single inbox email and its message/thread identifiers. Requires emails:read or an equivalent broader scope. Does not send a reply or mark the thread read.
get_current_workspace
Read the workspace bound to this V2 API key. Requires workspaces:read, workspaces:all, all:read, or all:all.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Manage draft campaigns, leads and lists, sending-account settings, inbox messages, verification, tags, block lists and campaign analytics through the scoped V2 API. Identify the connected workspace and track asynchronous lead moves. Campaign activation/resumption and replies can send real emails; verification can spend credits.
Common questions about connecting Instantly to AI agents with Metorial.