Run LinkedIn and email outreach: find leads, manage campaigns, and reply to prospects.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Approve or reject one or more discovered leads. Two-phase: first call returns a confirmation token + preview; the user reviews an inline card and confirms; second call (with confirmation_token) commits the status flip. action='approve' requires campaign_id (the campaign the leads will be associated with); action='reject' does not. The tool stamps each lead's status + reviewed_at + campaign_id; downstream campaign-engine pipelines ingest approved leads through their normal path. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
Decision applied to every lead in lead_ids
Discovered lead ids (from a prior find_leads result)
Number of leads in the batch (used in the confirm preview; mirrors len(lead_ids))
Required for action=approve; omitted for action=reject (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)
Campaign name (used in the confirm preview)
Phase-2 token (omit on phase-1)
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Approve or reject one or more discovered leads. Two-phase: first call returns a confirmation token + preview; the user reviews an inline card and confirms; second call (with confirmation_token) commits the status flip. action='approve' requires campaign_id (the campaign the leads will be associated with); action='reject' does not. The tool stamps each lead's status + reviewed_at + campaign_id; downstream campaign-engine pipelines ingest approved leads through their normal path. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| count | integer | Number of leads in the batch (used in the confirm preview; mirrors len(lead_ids)) |
| action* | string | Decision applied to every lead in lead_ids |
| lead_ids* | array | Discovered lead ids (from a prior find_leads result) |
| campaign_id | string | Required for action=approve; omitted for action=reject (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| campaign_name | string | Campaign name (used in the confirm preview) |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"action",
"lead_ids"
],
"properties": {
"count": {
"type": "integer",
"description": "Number of leads in the batch (used in the confirm preview; mirrors len(lead_ids))"
},
"action": {
"enum": [
"approve",
"reject"
],
"type": "string",
"description": "Decision applied to every lead in lead_ids"
},
"lead_ids": {
"type": "array",
"items": {
"type": "string",
"description": "Lead id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"description": "Discovered lead ids (from a prior find_leads result)"
},
"campaign_id": {
"type": "string",
"description": "Required for action=approve; omitted for action=reject (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"campaign_name": {
"type": "string",
"description": "Campaign name (used in the confirm preview)"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}Configure X or Hacker News searches for one owned agent and set source listening. First call get_agent_sources. If no source exists, propose 1-10 precise searches from the user's request and saved ICP; do not invent a broad search without showing it. If a source exists, show its current searches and only replace them when the user asks to change them. This tool previews the exact searches, enabled state, and LinkedIn resolution choice, then requires explicit approval. It does not activate a draft or paused agent. For an already configured source whose searches need no change, use set_agent_source_listening instead. X needs a connected X account for collection. Hacker News uses its public search provider. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| app_id | string | Product ID; required for MCP accounts with multiple products (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| source* | string | Source to configure |
| enabled* | boolean | Whether source listening should be enabled after approval |
| queries* | array | Exact search phrases to save, 1-10 |
| agent_id* | string | Owned agent ID (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
Pause, resume, cancel, or retry a durable Operator task after exact approval. Supply its current version. Retry also requires one failed idempotent local-read step; completed effects cannot replay. A pause may not stop an already executing provider call. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| step_id | string | Required failed step id for retry (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| task_id* | string | Task id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| operation* | string | Task transition |
| expected_version* | integer | Current task version |
| confirmation_token | string | One-use approval token; omit on first call |
{
"type": "object",
"required": [
"task_id",
"operation",
"expected_version"
],
"properties": {
"step_id": {
"type": "string",
"description": "Required failed step id for retry (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"task_id": {
"type": "string",
"description": "Task id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"operation": {
"enum": [
"pause",
"resume",
"cancel",
"retry"
],
"type": "string",
"description": "Task transition"
},
"expected_version": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1,
"description": "Current task version"
},
"confirmation_token": {
"type": "string",
"description": "One-use approval token; omit on first call"
}
}
}Create a new draft agent under the request's scoped app. Two-phase: first call previews every setting; second call after user confirmation creates it. The agent's ICP starts from the app's saved ICP; icp_filters keys you supply override only those keys, every other saved field (job_titles, mandatory_keywords, excluded_companies, company_sizes, ...) is kept as-is. Do not restate the full ICP from memory for a vague request like "set it up" — omit icp_filters entirely to inherit the saved ICP untouched, and only pass the specific keys the user actually asked to change. To deliberately clear a list field, pass it as an empty array. excluded_companies stores exact current employer names. If supplied a LinkedIn company URL, Operator saves its slug name there and retains the URL separately for competitor signals; ask the user to verify the name in the approval. Supply signals only when the user selects exact agent discovery signals; each signal must include its supported platform, category, key, label, enabled state, and config. An explicit empty signals array creates no signals. Without signals, defaults seed from the merged ICP filters. A requested keyword such as product launch can be a keyword_tracking_product_launch signal with config.keyword='product launch'. Ask for missing signal details; never claim a requested setting was saved if this schema cannot represent it. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| name* | string | Display name for the new agent (1-100 chars) |
| type | string | Agent type (default 'signal') |
| signals | array | Exact agent discovery signals. Omit to seed from ICP; use [] for none. |
Create a draft campaign in the selected product. First show the exact campaign, agent, destination list, and any agent retargeting for approval. With agent_id and no list_id, use the agent's destination list; if absent, assign the product default list to both. An explicit different list retargets a draft agent only after approval. Never activate, discover, enroll, or send. If workflow_steps are omitted, create the standard 4-step flow. For custom steps ask about type, delay, message mode, template, and final step. In message_template use only {FirstName}, {LastName}, and {Company}. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| name* | string | Campaign name (1-100 chars) |
| list_id | string | Optional owned lead list id. With an agent, omitted means its destination list. Otherwise the product default list is used or created. (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| agent_id | string | Optional agent id (from a prior list_agents) that supplies leads to this campaign (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| app_name | string | App name (used in the confirm preview) |
| workflow_steps | array | Optional custom workflow steps |
| cold_outreach_mode |
Create a new lead list scoped to the request's app. Use this when the user wants to organise leads into a named bucket (e.g. 'Q4 Targets', 'Hot Founders'). The new list starts empty; populate it later via approve_leads with action='approve' and the new list_id, or by editing the list manually. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| name* | string | Display name for the list (1-100 chars) |
| description | string | Optional one-sentence description of what the list is for |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Display name for the list (1-100 chars)"
},
"description": {
"type": "string",
"description": "Optional one-sentence description of what the list is for"
}
}
}Create a scoped note or reminder after an explicit confirmation of the exact lead, body, and due date. One request_key can be applied only once; a changed intent with the same key fails. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| body* | string | Note or reminder text (max 5000 chars) |
| lead_id* | string | Lead id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| reminder_at | string | Optional RFC3339 reminder due date |
| request_key* | string | Stable unique request identity (8-128 chars) |
| reminder_body | string | Required when reminder_at is set |
| confirmation_token | string | One-use approval token; omit on first call |
{
"type": "object",
"required": [
"lead_id",
"request_key",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Note or reminder text (max 5000 chars)"
},
"lead_id": {
"type": "string",
"description": "Lead id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"reminder_at": {
"type": "string",
"description": "Optional RFC3339 reminder due date"
},
"request_key": {
"type": "string",
"description": "Stable unique request identity (8-128 chars)"
},
"reminder_body": {
"type": "string",
"description": "Required when reminder_at is set"
},
"confirmation_token": {
"type": "string",
"description": "One-use approval token; omit on first call"
}
}
}Create a scoped note or reminder after an explicit confirmation of the exact lead, body, and due date. One request_key can be applied only once; a changed intent with the same key fails. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| body* | string | Note or reminder text (max 5000 chars) |
| lead_id* | string | Lead id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| reminder_at* | string | Required RFC3339 reminder due date |
| request_key* | string | Stable unique request identity (8-128 chars) |
| confirmation_token | string | One-use approval token; omit on first call |
{
"type": "object",
"required": [
"lead_id",
"request_key",
"body",
"reminder_at"
],
"properties": {
"body": {
"type": "string",
"description": "Note or reminder text (max 5000 chars)"
},
"lead_id": {
"type": "string",
"description": "Lead id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"reminder_at": {
"type": "string",
"description": "Required RFC3339 reminder due date"
},
"request_key": {
"type": "string",
"description": "Stable unique request identity (8-128 chars)"
},
"confirmation_token": {
"type": "string",
"description": "One-use approval token; omit on first call"
}
}
}Stage a proposed ICP edit for one agent. Returns a diff envelope (current vs proposed, fields_changed) so the user can review the change inline before applying it. Does NOT write — to actually apply the edit, call update_icp (confirm-tier) with the same agent_id and proposed fields. Use this when the user describes a change in plain language ('target Series A founders in EU' etc.); never call update_icp directly without first staging here so the user sees the before/after.
| Argument | Type | Description |
|---|---|---|
| agent_id* | string | Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| proposed_icp_filters | string | Optional structured filters JSON (job_titles, industries, regions, etc.) |
| proposed_icp_description | string | Free-text description of the new ICP |
{
"type": "object",
"required": [
"agent_id"
],
"properties": {
"agent_id": {
"type": "string",
"description": "Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"proposed_icp_filters": {
"type": "string",
"description": "Optional structured filters JSON (job_titles, industries, regions, etc.)"
},
"proposed_icp_description": {
"type": "string",
"description": "Free-text description of the new ICP"
}
}
}Generate a personalised draft for one lead. Reads the lead's profile (industry, role, headline, optional reference hook) and returns a single message body. Does NOT send. After the user reviews and approves, call send_message to actually deliver. ALWAYS call get_lead first to inspect reply_state — refuse to draft for opted-out / replied / rejected leads. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| tone | string | Voice register |
| lead_id* | string | Lead id (from a prior find_leads / get_lead) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| reference | string | Optional specific hook (recent post, role transition, milestone) the user wants referenced |
{
"type": "object",
"required": [
"lead_id"
],
"properties": {
"tone": {
"enum": [
"warm",
"professional",
"direct"
],
"type": "string",
"description": "Voice register"
},
"lead_id": {
"type": "string",
"description": "Lead id (from a prior find_leads / get_lead) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"reference": {
"type": "string",
"description": "Optional specific hook (recent post, role transition, milestone) the user wants referenced"
}
}
}Enable (activate) a paused or draft agent so it begins discovering leads on its schedule. Two-phase: first call returns a confirmation token + preview; the user reviews and confirms; second call (with confirmation_token) commits. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| agent_id* | string | Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| app_name* | string | App name (used in the confirm preview) |
| agent_name* | string | Agent name (used in the confirm preview) |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"agent_id",
"agent_name",
"app_name"
],
"properties": {
"agent_id": {
"type": "string",
"description": "Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"app_name": {
"type": "string",
"description": "App name (used in the confirm preview)"
},
"agent_name": {
"type": "string",
"description": "Agent name (used in the confirm preview)"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}Enable (resume) a paused or draft campaign. The campaign engine starts scheduling actions per the campaign's workflow. Two-phase: first call returns a confirmation token + preview; the user reviews and confirms; second call (with confirmation_token) commits. Activation pre-conditions (workflow steps, connected accounts) are validated by the underlying campaign service — the tool surfaces any failure as a structured error. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| app_name* | string | App name (used in the confirm preview) |
| campaign_id* | string | Campaign id (from a prior list_campaigns) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| campaign_name* | string | Campaign name (used in the confirm preview) |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"campaign_id",
"campaign_name",
"app_name"
],
"properties": {
"app_name": {
"type": "string",
"description": "App name (used in the confirm preview)"
},
"campaign_id": {
"type": "string",
"description": "Campaign id (from a prior list_campaigns) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"campaign_name": {
"type": "string",
"description": "Campaign name (used in the confirm preview)"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}Search leads in the app the request is scoped to. Returns bounded named summaries and IDs, never full rows. Use get_lead to load full detail for a specific id. Default source is 'discovered' (agent-found, awaiting approval); pass source='approved' to search leads already in campaigns. Optional 'search' keyword runs an ILIKE across name/company/headline; optional 'status' narrows by lead status. If results are thin, surface the count and ASK the user before broadening the filters — do not silently relax constraints.
| Argument | Type | Description |
|---|---|---|
| limit* | integer | Max number of leads to return (1..50) |
| search | string | Optional keyword (matches name, company, or headline) |
| source | string | Lead source. Default 'discovered'. |
| status | string | Optional status filter (e.g. 'pending', 'approved', 'rejected') |
{
"type": "object",
"required": [
"limit"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max number of leads to return (1..50)"
},
"search": {
"type": "string",
"description": "Optional keyword (matches name, company, or headline)"
},
"source": {
"enum": [
"discovered",
"approved"
],
"type": "string",
"description": "Lead source. Default 'discovered'."
},
"status": {
"type": "string",
"description": "Optional status filter (e.g. 'pending', 'approved', 'rejected')"
}
}
}Read current account access for Operator and campaign actions in the selected product. Operator requires active paid or lifetime entitlement; campaign actions also accept active beta. Feature flags are account-wide. This snapshot is not an action authorization or credit quote.
No arguments.
{
"type": "object",
"properties": {}
}Read X and Hacker News listening settings for one owned agent, including sources not configured yet. Use list_agents to identify the agent. If configured is false, use configure_agent_source to propose exact searches and enable listening after approval. If configured is true and searches exist, use set_agent_source_listening to toggle without changing searches. A draft or paused agent does not collect until activated. LinkedIn signal groups are separate.
| Argument | Type | Description |
|---|---|---|
| app_id | string | Product ID; required for MCP accounts with multiple products (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| agent_id* | string | Owned agent ID (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"agent_id"
],
"properties": {
"app_id": {
"type": "string",
"description": "Product ID; required for MCP accounts with multiple products (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"agent_id": {
"type": "string",
"description": "Owned agent ID (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Return product- or campaign-scoped activity in a UTC lookback interval. Completed actions and invitations use executed_at; connections and recorded replies use lead event timestamps. These are separate event counts, not one conversion cohort. Default 7 days, max 90.
| Argument | Type | Description |
|---|---|---|
| scope | string | Aggregation level. Default 'app'. |
| days_back | integer | Lookback window in days (default 7) |
| campaign_id | string | Campaign id (required when scope='campaign') (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"properties": {
"scope": {
"enum": [
"campaign",
"app"
],
"type": "string",
"description": "Aggregation level. Default 'app'."
},
"days_back": {
"type": "integer",
"maximum": 90,
"minimum": 1,
"description": "Lookback window in days (default 7)"
},
"campaign_id": {
"type": "string",
"description": "Campaign id (required when scope='campaign') (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Read one campaign in the selected product. Returns updated_at for exact approved settings changes, plus workflow, sender assignments, schedule, review mode, observed action state, and readiness blockers. Empty templates are not claimed as generated messages. No sending or activation occurs.
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | Campaign id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "Campaign id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Return bounded conversation context for one lead or conversation in the request scope: lead profile, product/campaign context, last real messages, recent notes, open reminders, and Reply Assistant follow-up suggestions. Use this before meeting prep, reply planning, or questions about what happened with a lead. Read-only; does not draft or send messages.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Number of recent messages to return (default 12, max 20) |
| lead_id | string | Lead id from find_leads/get_lead or a follow-up result (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| conversation_id | string | Conversation id from inbox/follow-up context (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Number of recent messages to return (default 12, max 20)"
},
"lead_id": {
"type": "string",
"description": "Lead id from find_leads/get_lead or a follow-up result (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"conversation_id": {
"type": "string",
"description": "Conversation id from inbox/follow-up context (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Rank up to four live operational starting points with source IDs and links. Connected senders and insights count across the account; leads, actions, campaigns, and unread messages count within the selected product. Read only.
No arguments.
{
"type": "object",
"properties": {}
}List reply-needed conversations or due follow-ups in the selected product. One predicate determines both the total and page. AI drafts are not counted as sent replies. Limit 50; use offset for later pages.
| Argument | Type | Description |
|---|---|---|
| mode* | string | Queue type |
| limit | integer | Maximum rows (default 20, max 50) |
| offset | integer | Pagination offset (default 0) |
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"reply_needed",
"due_follow_up"
],
"type": "string",
"description": "Queue type"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum rows (default 20, max 50)"
},
"offset": {
"type": "integer",
"maximum": 10000,
"description": "Pagination offset (default 0)"
}
}
}Read one insight and its evidence for the selected product, or an explicitly account-scoped insight. Read-only; proposed changes never run here.
| Argument | Type | Description |
|---|---|---|
| insight_id* | string | Insight id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"insight_id"
],
"properties": {
"insight_id": {
"type": "string",
"description": "Insight id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Return full detail for a single lead by id, INCLUDING the derived reply_state and opt_out flags. Always call this before drafting or sending a message — a lead whose reply_state is 'replied', 'rejected', or 'opted_out', or whose opt_out is true, must NEVER be drafted to or messaged. Use source='approved' for leads in active campaigns; default 'discovered' is for agent-found leads awaiting approval.
| Argument | Type | Description |
|---|---|---|
| source | string | Lead source. Default 'discovered'. |
| lead_id* | string | Lead id (from a prior find_leads result) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"lead_id"
],
"properties": {
"source": {
"enum": [
"discovered",
"approved"
],
"type": "string",
"description": "Lead source. Default 'discovered'."
},
"lead_id": {
"type": "string",
"description": "Lead id (from a prior find_leads result) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Read one unarchived list in the selected product and its exact member count. Does not return contacts; use list_list_contacts.
| Argument | Type | Description |
|---|---|---|
| list_id* | string | List id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"list_id"
],
"properties": {
"list_id": {
"type": "string",
"description": "List id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Read one durable Operator task in the selected product with its step states, action states, safe summaries, version, and progress. Does not return executable arguments or raw provider errors.
| Argument | Type | Description |
|---|---|---|
| task_id* | string | Task id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"task_id"
],
"properties": {
"task_id": {
"type": "string",
"description": "Task id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Read the selected product's name, site, description, ICP summary, language, Product Brain availability, and dashboard link. No provider credentials or raw unbounded configuration are returned.
No arguments.
{
"type": "object",
"properties": {}
}Read one reply attempt by its stable request_key in the selected product. Returns actual delivery evidence and next_action. Uncertain delivery requires manual provider review unless an exact outgoing provider message is confirmed. Never retries or sends.
| Argument | Type | Description |
|---|---|---|
| request_key* | string | Stable request identity from send_conversation_reply, 8-128 characters |
{
"type": "object",
"required": [
"request_key"
],
"properties": {
"request_key": {
"type": "string",
"description": "Stable request identity from send_conversation_reply, 8-128 characters"
}
}
}List pending, approved, or failed scheduled actions in the selected product, optionally for one campaign. Returns one bounded page and its exact total. Completed actions are not included.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size (default 20; max 50) |
| offset | integer | Page offset (default 0) |
| campaign_id | string | Optional campaign id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size (default 20; max 50)"
},
"offset": {
"type": "integer",
"maximum": 10000,
"description": "Page offset (default 0)"
},
"campaign_id": {
"type": "string",
"description": "Optional campaign id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Read one action in the selected product: campaign, lead, type, state, scheduled and executed timestamps. Does not return provider metadata or a message body.
| Argument | Type | Description |
|---|---|---|
| action_id* | string | Scheduled action id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"action_id"
],
"properties": {
"action_id": {
"type": "string",
"description": "Scheduled action id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Show account-wide connected sender health and separate readiness for campaign assignments in the selected product. An account-wide connection does not prove a campaign has a usable sender.
No arguments.
{
"type": "object",
"properties": {}
}Import lead rows from a prior search_external_leads session into a lead list. Two-phase: first call returns a confirmation token + preview; the user reviews an inline card and confirms; second call with confirmation_token commits. provider_ids omitted means import every lead in the search session. Supply list_id for an existing list, or list_name to create a new list during the confirmed commit. After a committed result returns list_id, use that exact list_id when creating a campaign from the imported search leads. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| list_id | string | Existing lead list id to import into (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| list_name | string | Name for a new list to create during the confirmed import when list_id is omitted |
| session_id* | string | Lead search session id returned by search_external_leads (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| provider_ids | array | Optional selected provider ids from the search result. Omit to import all search results. |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"session_id"
],
"properties": {
"list_id": {
"type": "string",
"description": "Existing lead list id to import into (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"list_name": {
"type": "string",
"description": "Name for a new list to create during the confirmed import when list_id is omitted"
},
"session_id": {
"type": "string",
"description": "Lead search session id returned by search_external_leads (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"provider_ids": {
"type": "array",
"items": {
"type": "string",
"description": "Provider id from the search result"
},
"description": "Optional selected provider ids from the search result. Omit to import all search results."
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}List the specialist agents in the product/app the request is scoped to. Returns a summary (count, brief one-liner, and a list of {id, name, status, type, role, one-line icp_summary}). Internal agent types are mapped to product-facing roles such as lead_finder. Full ICP filters / config are collapsed to a one-liner — call get_agent (later) to load full detail. Use this to ground questions like 'how many specialist agents do I have?' or 'which Lead Finder agents are active?'.
No arguments.
{
"type": "object",
"properties": {}
}List the products/apps owned by the request scope's user. Returns a summary (count, brief one-liner, and a list of {id, name, description, url}) with no timestamps or internal flags. Use this for product inventory or explicit product-switch/disambiguation questions. A normal product-scoped request already carries an app_id in Scope; do not call this just to discover which product to use for product-aware actions.
No arguments.
{
"type": "object",
"properties": {}
}List the campaigns in the app the request is scoped to (excludes archived). Returns a summary (count, brief one-liner, and a list of {id, name, status, agent_id, list_id}). Settings JSON is intentionally omitted; call get_campaign for current workflow, sender, and action detail. Status values: 'draft', 'active', 'paused'.
No arguments.
{
"type": "object",
"properties": {}
}List account-scoped and selected-product-scoped open insights. Each item labels its actual scope; account insights are not product-only. Exact total and bounded pages.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size (default 20; max 50) |
| offset | integer | Page offset (default 0) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size (default 20; max 50)"
},
"offset": {
"type": "integer",
"maximum": 10000,
"description": "Page offset (default 0)"
}
}
}List contacts in one unarchived list in the selected product. Returns exact total and bounded pages. Does not expose email or provider identifiers.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size (default 20; max 50) |
| offset | integer | Page offset (default 0) |
| list_id* | string | List id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"list_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size (default 20; max 50)"
},
"offset": {
"type": "integer",
"maximum": 10000,
"description": "Page offset (default 0)"
},
"list_id": {
"type": "string",
"description": "List id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}List unarchived lead lists in the selected product. Returns exact total and bounded pages. A list's cached lead count is not used for the total.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size (default 20; max 50) |
| offset | integer | Page offset (default 0) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size (default 20; max 50)"
},
"offset": {
"type": "integer",
"maximum": 10000,
"description": "Page offset (default 0)"
}
}
}List up to 20 files uploaded to any of your Operator threads in the selected product. Returns file IDs and metadata only, never bytes or extracted text. A file can be used for a same-product LinkedIn reply, not another product or email reply.
No arguments.
{
"type": "object",
"properties": {}
}List durable Operator tasks in the selected product. Returns bounded pages, exact total, task status, version, and links. Read-only.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size (default 20; max 50) |
| offset | integer | Page offset (default 0) |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size (default 20; max 50)"
},
"offset": {
"type": "integer",
"maximum": 10000,
"description": "Page offset (default 0)"
}
}
}List up to 20 saved Operator preferences for the user and product in the request scope. Values are bounded, labeled customer data, and never override user instructions or system rules. Returns key, value, and source only. No provider credentials or tokens are returned.
No arguments.
{
"type": "object",
"properties": {}
}List open or done lead reminders in the selected product with exact total and bounded pages. Default is open. This read does not complete a reminder.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size (default 20; max 50) |
| offset | integer | Page offset (default 0) |
| status | string | Reminder state |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Page size (default 20; max 50)"
},
"offset": {
"type": "integer",
"maximum": 10000,
"description": "Page offset (default 0)"
},
"status": {
"enum": [
"open",
"done"
],
"type": "string",
"description": "Reminder state"
}
}
}Pause an active agent so it stops discovering new leads. The agent's existing leads remain in the list. Two-phase: first call returns a confirmation token + preview; the user reviews an inline card and confirms or cancels; second call (with confirmation_token) commits the pause. Always include agent_name + app_name so the preview is human-readable. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| agent_id* | string | Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| app_name* | string | App name (used in the confirm preview) |
| agent_name* | string | Agent name (used in the confirm preview) |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"agent_id",
"agent_name",
"app_name"
],
"properties": {
"agent_id": {
"type": "string",
"description": "Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"app_name": {
"type": "string",
"description": "App name (used in the confirm preview)"
},
"agent_name": {
"type": "string",
"description": "Agent name (used in the confirm preview)"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}Pause an active campaign. The campaign engine stops scheduling actions. Two-phase: first call returns a confirmation token + preview; the user reviews an inline card and confirms or cancels; second call (with confirmation_token) commits the pause. Always include campaign_name + app_name so the preview is human-readable. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| app_name* | string | App name (used in the confirm preview) |
| campaign_id* | string | Campaign id (from a prior list_campaigns) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| campaign_name* | string | Campaign name (used in the confirm preview) |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"campaign_id",
"campaign_name",
"app_name"
],
"properties": {
"app_name": {
"type": "string",
"description": "App name (used in the confirm preview)"
},
"campaign_id": {
"type": "string",
"description": "Campaign id (from a prior list_campaigns) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"campaign_name": {
"type": "string",
"description": "Campaign name (used in the confirm preview)"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}Prepare one exact local inbound reply. Returns recipient, sender, channel, inbound revision, final signed body, and optional owned file identity. Never sends. Files are available only for supported connected LinkedIn conversations in the selected product.
| Argument | Type | Description |
|---|---|---|
| body* | string | Full proposed body. A configured booking link is tracked in the final preview |
| attachment_id | string | Optional file ID from list_operator_files. LinkedIn replies only (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| conversation_id* | string | Local conversation id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
{
"type": "object",
"required": [
"conversation_id",
"body"
],
"properties": {
"body": {
"type": "string",
"description": "Full proposed body. A configured booking link is tracked in the final preview"
},
"attachment_id": {
"type": "string",
"description": "Optional file ID from list_operator_files. LinkedIn replies only (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"conversation_id": {
"type": "string",
"description": "Local conversation id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
}
}
}Rename one unarchived list in the selected product after explicit approval. Supply its current name to reject stale changes; include the full new description. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| name* | string | New name (1-100 chars) |
| list_id* | string | List id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| description* | string | New full description |
| expected_name* | string | Current list name |
| confirmation_token | string | Approval token; omit on first call |
{
"type": "object",
"required": [
"list_id",
"expected_name",
"name",
"description"
],
"properties": {
"name": {
"type": "string",
"description": "New name (1-100 chars)"
},
"list_id": {
"type": "string",
"description": "List id (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"description": {
"type": "string",
"description": "New full description"
},
"expected_name": {
"type": "string",
"description": "Current list name"
},
"confirmation_token": {
"type": "string",
"description": "Approval token; omit on first call"
}
}
}Save one selected-product Operator preference after explicit approval. The value is bounded JSON data, not a system instruction. Existing keys update. No provider credentials or tokens are accepted. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| key* | string | Preference key (1-100 chars; no secret names) |
| value* | string | JSON value (max 600 bytes) |
| reason | string | Why this preference should be saved |
| confirmation_token | string | Approval token; omit on first call |
{
"type": "object",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"description": "Preference key (1-100 chars; no secret names)"
},
"value": {
"type": "string",
"description": "JSON value (max 600 bytes)"
},
"reason": {
"type": "string",
"description": "Why this preference should be saved"
},
"confirmation_token": {
"type": "string",
"description": "Approval token; omit on first call"
}
}
}Search LinkedIn for fresh people leads from the request user's connected account. Use this when the user describes leads to find by words, roles, companies, or market terms, rather than asking to search existing saved leads. Returns a server-owned session_id and up to 10 lead previews. To import the results, call import_search_leads_to_list with that session_id after the user asks to import all or selected leads. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| role | string | Optional job-title filter, e.g. 'Founder OR CEO' |
| limit | integer | Max results to return (1..10). Default 10. |
| query* | string | Free-text people search, e.g. 'YC founders building AI devtools' |
{
"type": "object",
"required": [
"query"
],
"properties": {
"role": {
"type": "string",
"description": "Optional job-title filter, e.g. 'Founder OR CEO'"
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Max results to return (1..10). Default 10."
},
"query": {
"type": "string",
"description": "Free-text people search, e.g. 'YC founders building AI devtools'"
}
}
}Send one exact prepared reply to the latest inbound message after explicit human approval. Provide the complete prepare_conversation_reply result, its attachment_id when present, and a stable request_key. A timeout is uncertain and cannot be retried automatically. LinkedIn files are supported; email files are unavailable. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| prepared* | object | Exact prepare_conversation_reply result; all fields required by server validation |
| request_key* | string | Stable unique request identity, 8-128 chars |
| attachment_id | string | Exact prepared file ID when present (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| confirmation_token | string | One-use approval token; omit on first call |
| reply_as_confirmed | boolean | Explicitly confirm using another rep's sender |
{
"type": "object",
"required": [
"prepared",
"request_key"
],
"properties": {
"prepared": {
"type": "object",
"description": "Exact prepare_conversation_reply result; all fields required by server validation"
},
"request_key": {
"type": "string",
"description": "Stable unique request identity, 8-128 chars"
},
"attachment_id": {
"type": "string",
"description": "Exact prepared file ID when present (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"confirmation_token": {
"type": "string",
"description": "One-use approval token; omit on first call"
},
"reply_as_confirmed": {
"type": "boolean",
"description": "Explicitly confirm using another rep's sender"
}
}
}Pause or resume only an existing X or Hacker News source on an agent. First read get_agent_sources. If configured is false or searches are empty, use configure_agent_source instead. The first call shows exact approval; a second user-approved call commits. Saved searches, budgets, LinkedIn resolution and other sources stay unchanged. A draft or paused agent does not collect until activated. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| app_id | string | Product ID; required for MCP accounts with multiple products (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| source* | string | One source |
| enabled* | boolean | |
| agent_id* | string | Owned agent ID (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| confirmation_token | string | One-use approval token, omit before approval |
| expected_updated_at | string | Version from get_agent_sources; optional on first call |
Change a campaign's manual review, send window, or sender assignments in the selected product. Read get_campaign first and copy its updated_at as expected_updated_at. Omitted settings remain unchanged. Explicit null sender clears one platform. First call returns an exact approval preview; approved execution saves all changes atomically. It never activates, enrolls, or sends. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| schedule | object | Full send window; all fields required when supplied |
| campaign_id* | string | Owned campaign id from get_campaign (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| review_mode | boolean | Require manual review before outreach |
| confirmation_token | string | One-use approval token; omit on first call |
| account_assignments | object | Only supplied platforms change |
| expected_updated_at | string | Exact updated_at from get_campaign; may be omitted for a server-filled first preview |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"schedule": {
"type": "object",
"required": [
"timezone",
"days",
"start_hour",
"end_hour"
],
"properties": {
"days": {
"type": "array",
"items": {
"type": "string"
},
"description": "Unique weekdays"
},
"end_hour": {
"type": "integer",
"maximum": 24,
"minimum": 1,
"description": "Exclusive local hour"
},
"timezone": {
"type": "string",
"description": "IANA timezone, such as Europe/Berlin"
},
"start_hour": {
"type": "integer",
"maximum": 23,
"description": "Inclusive local hour"
}
},
"description": "Full send window; all fields required when supplied"
},
"campaign_id": {
"type": "string",
"description": "Owned campaign id from get_campaign (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"review_mode": {
"type": "boolean",
"description": "Require manual review before outreach"
},
"confirmation_token": {
"type": "string",
"description": "One-use approval token; omit on first call"
},
"account_assignments": {
"type": "object",
"properties": {
"x": {
"type": [
"string",
"null"
],
"description": "Owned sender UUID, or null to clear this platform"
},
"email": {
"type": [
"string",
"null"
],
"description": "Owned sender UUID, or null to clear this platform"
},
"reddit": {
"type": [
"string",
"null"
],
"description": "Owned sender UUID, or null to clear this platform"
},
"linkedin": {
"type": [
"string",
"null"
],
"description": "Owned sender UUID, or null to clear this platform"
}
},
"description": "Only supplied platforms change"
},
"expected_updated_at": {
"type": "string",
"description": "Exact updated_at from get_campaign; may be omitted for a server-filled first preview"
}
}
}Update message content on existing steps in a draft or paused campaign. Prefer one-based message_order, which counts only message-bearing steps and automatically skips invite/follow steps: message_order 1, 2, 3 targets the first, second, and third messages even when raw workflow step 1 is an invite. step_order remains available only when an exact raw workflow order is already known. Provide exactly one selector plus the exact message_template for every item. In message_template use only {FirstName}, {LastName}, and {Company} personalization variables. This is a two-phase confirmed action: first call without confirmation_token returns a confirmation card; approved execution applies the exact stored workflow_messages through the campaign service. It never launches or sends. Always include campaign_name and app_name for a human-readable preview. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| app_name* | string | App name used in the confirmation preview |
| campaign_id* | string | Campaign id from a prior list_campaigns result (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| campaign_name* | string | Campaign name used in the confirmation preview |
| workflow_messages* | array | Exact message content to persist; prefer message_order 1..N for ordinary campaign copy |
Apply an ICP edit (description and/or filters JSON) to one agent. Two-phase: first call returns a confirmation token + preview; the user reviews the diff inline and confirms; second call (with confirmation_token) commits. ALWAYS call draft_icp_edit first so the user sees a before/after; never call update_icp directly without staging a diff. Pre-populate agent_name in the schema args so the preview is human-readable. Over MCP: call this tool once, without confirmation_token. It runs right away and returns the result.
| Argument | Type | Description |
|---|---|---|
| agent_id* | string | Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000) |
| agent_name | string | Agent name (used in the confirm preview) |
| icp_filters | object | New structured filters object. Use company_sizes and exclude_service_providers. excluded_companies accepts exact employer names or LinkedIn company URLs. URLs become slug names and remain separately in competitor_urls. Ask the user to verify the employer name. Omit to leave unchanged. |
| icp_description | string | New free-text ICP description (omit to leave unchanged) |
| industry_inputs | array | Explicit raw industry intent from draft_icp_edit ready_to_execute_args. Omit for canonical-only edits. Nested old metadata cannot restore removed raw intent. |
| confirmation_token |
| confirmation_token |
| string |
| One-use approval token; omit before approval |
| expected_updated_at | string | Version from get_agent_sources; optional on first call |
| auto_resolve_linkedin | boolean | Hacker News only; automatically resolve high-confidence leads through LinkedIn, which may use credits |
{
"type": "object",
"required": [
"agent_id",
"source",
"queries",
"enabled"
],
"properties": {
"app_id": {
"type": "string",
"description": "Product ID; required for MCP accounts with multiple products (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"source": {
"enum": [
"x",
"hackernews"
],
"type": "string",
"description": "Source to configure"
},
"enabled": {
"type": "boolean",
"description": "Whether source listening should be enabled after approval"
},
"queries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exact search phrases to save, 1-10"
},
"agent_id": {
"type": "string",
"description": "Owned agent ID (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"confirmation_token": {
"type": "string",
"description": "One-use approval token; omit before approval"
},
"expected_updated_at": {
"type": "string",
"description": "Version from get_agent_sources; optional on first call"
},
"auto_resolve_linkedin": {
"type": "boolean",
"description": "Hacker News only; automatically resolve high-confidence leads through LinkedIn, which may use credits"
}
}
}| app_name |
| string |
| App name (used in the confirm preview) |
| icp_filters | object | Optional structured ICP filters. Use job_titles, industries, regions, company_sizes, excluded_keywords, and exclude_service_providers. excluded_companies accepts exact employer names or LinkedIn company URLs. URLs become slug names and remain separately in competitor_urls. Ask the user to verify the employer name. Do not use unsupported excluded_industries. |
| max_signals | integer | Cap on enabled signals (default 15) |
| icp_description | string | Free-text ICP description for the new agent |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
| linkedin_account_ids | array | Local UUIDs of the workspace LinkedIn accounts selected for searches. Use [] for none. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Display name for the new agent (1-100 chars)"
},
"type": {
"enum": [
"signal",
"lookalike"
],
"type": "string",
"description": "Agent type (default 'signal')"
},
"signals": {
"type": "array",
"items": {
"type": "object",
"required": [
"platform",
"signal_category",
"signal_key",
"label",
"enabled"
],
"properties": {
"label": {
"type": "string",
"description": "User-visible signal name"
},
"config": {
"type": "object",
"description": "Exact signal configuration, such as keyword or job_titles"
},
"enabled": {
"type": "boolean",
"description": "Whether the signal is selected"
},
"platform": {
"enum": [
"linkedin"
],
"type": "string",
"description": "Discovery platform"
},
"signal_key": {
"type": "string",
"description": "Exact signal key, such as keyword_tracking_hiring"
},
"description": {
"type": "string",
"description": "Optional signal description"
},
"signal_category": {
"enum": [
"your_company",
"engagement_interest",
"linkedin_profiles",
"change_trigger_events",
"competitors_engagement",
"job_activity"
],
"type": "string",
"description": "Agent signal category"
}
}
},
"description": "Exact agent discovery signals. Omit to seed from ICP; use [] for none."
},
"app_name": {
"type": "string",
"description": "App name (used in the confirm preview)"
},
"icp_filters": {
"type": "object",
"description": "Optional structured ICP filters. Use job_titles, industries, regions, company_sizes, excluded_keywords, and exclude_service_providers. excluded_companies accepts exact employer names or LinkedIn company URLs. URLs become slug names and remain separately in competitor_urls. Ask the user to verify the employer name. Do not use unsupported excluded_industries."
},
"max_signals": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Cap on enabled signals (default 15)"
},
"icp_description": {
"type": "string",
"description": "Free-text ICP description for the new agent"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
},
"linkedin_account_ids": {
"type": "array",
"items": {
"type": "string",
"description": "Local LinkedIn account UUID"
},
"description": "Local UUIDs of the workspace LinkedIn accounts selected for searches. Use [] for none."
}
}
}| string |
| Cold outreach mode (default 'invite') |
| confirmation_token | string | Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Campaign name (1-100 chars)"
},
"list_id": {
"type": "string",
"description": "Optional owned lead list id. With an agent, omitted means its destination list. Otherwise the product default list is used or created. (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"agent_id": {
"type": "string",
"description": "Optional agent id (from a prior list_agents) that supplies leads to this campaign (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"app_name": {
"type": "string",
"description": "App name (used in the confirm preview)"
},
"workflow_steps": {
"type": "array",
"items": {
"type": "object",
"required": [
"step_type"
],
"properties": {
"is_final": {
"type": "boolean",
"description": "Whether this is the final workflow step"
},
"step_type": {
"enum": [
"invite",
"message",
"follow_up",
"inmail",
"email"
],
"type": "string",
"description": "Step type"
},
"delay_unit": {
"enum": [
"hours",
"days"
],
"type": "string",
"description": "Delay unit"
},
"delay_value": {
"type": "integer",
"maximum": 365,
"description": "Delay before this step"
},
"message_mode": {
"enum": [
"manual",
"ai_personalized"
],
"type": "string",
"description": "Message mode"
},
"message_template": {
"type": "string",
"description": "Optional message template. Supported personalization variables: {FirstName}, {LastName}, {Company}."
}
}
},
"description": "Optional custom workflow steps"
},
"cold_outreach_mode": {
"enum": [
"invite",
"inmail",
"email"
],
"type": "string",
"description": "Cold outreach mode (default 'invite')"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}{
"type": "object",
"required": [
"agent_id",
"source",
"enabled"
],
"properties": {
"app_id": {
"type": "string",
"description": "Product ID; required for MCP accounts with multiple products (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"source": {
"enum": [
"x",
"hackernews"
],
"type": "string",
"description": "One source"
},
"enabled": {
"type": "boolean"
},
"agent_id": {
"type": "string",
"description": "Owned agent ID (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"confirmation_token": {
"type": "string",
"description": "One-use approval token, omit before approval"
},
"expected_updated_at": {
"type": "string",
"description": "Version from get_agent_sources; optional on first call"
}
}
}| confirmation_token |
| string |
| Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"campaign_id",
"campaign_name",
"app_name",
"workflow_messages"
],
"properties": {
"app_name": {
"type": "string",
"description": "App name used in the confirmation preview"
},
"campaign_id": {
"type": "string",
"description": "Campaign id from a prior list_campaigns result (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"campaign_name": {
"type": "string",
"description": "Campaign name used in the confirmation preview"
},
"workflow_messages": {
"type": "array",
"items": {
"type": "object",
"required": [
"message_template"
],
"properties": {
"step_order": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Advanced fallback: exact one-based raw workflow step order"
},
"message_order": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Preferred one-based position among message-bearing steps; skips invite/follow steps"
},
"message_template": {
"type": "string",
"description": "Non-empty message template to persist. Supported personalization variables: {FirstName}, {LastName}, {Company}."
}
}
},
"description": "Exact message content to persist; prefer message_order 1..N for ordinary campaign copy"
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}| string |
| Phase-2 token (omit on phase-1) |
{
"type": "object",
"required": [
"agent_id"
],
"properties": {
"agent_id": {
"type": "string",
"description": "Agent id (from a prior list_agents) (UUID format, e.g. 550e8400-e29b-41d4-a716-446655440000)"
},
"agent_name": {
"type": "string",
"description": "Agent name (used in the confirm preview)"
},
"icp_filters": {
"type": "object",
"description": "New structured filters object. Use company_sizes and exclude_service_providers. excluded_companies accepts exact employer names or LinkedIn company URLs. URLs become slug names and remain separately in competitor_urls. Ask the user to verify the employer name. Omit to leave unchanged."
},
"icp_description": {
"type": "string",
"description": "New free-text ICP description (omit to leave unchanged)"
},
"industry_inputs": {
"type": "array",
"items": {
"type": "string",
"description": "Raw industry intent shown in approval"
},
"description": "Explicit raw industry intent from draft_icp_edit ready_to_execute_args. Omit for canonical-only edits. Nested old metadata cannot restore removed raw intent."
},
"confirmation_token": {
"type": "string",
"description": "Phase-2 token (omit on phase-1)"
}
}
}