Tool reference

Sixteen tools, grouped the way you use them. Each lists its arguments and its safety annotation — the hint MCP clients use to decide what to run automatically and what to confirm with you first.

​

Agent

​

run_agent

Run the ManyPI agent on a natural-language goal: scrape sites, research, analyse data, turn a site into an API. Asynchronous — returns a run_id and conversation_id. For finding leads, prefer generate_leads.

​

get_agent_run

Check the status and result of agent and lead-gen runs. Statuses: queued / planning / running (working), paused (waiting on you — the question is in result_summary), completed / failed / cancelled (done — see result_summary).

​

reply_to_agent

Answer an agent that is waiting for input, or send a follow-up to a finished run. Resumes the same run if it was paused; otherwise starts a follow-up run in the same conversation.

​

Lead generation

​

generate_leads

Find and enrich B2B leads. Describe your ideal customer; poll get_agent_run for progress and read results with search_leads.

​

search_leads

Search the workspace’s saved leads.

​

Outreach content

​

list_inboxes

List connected sending inboxes with per-inbox health: today’s sends versus the warmup-aware cap, 14-day delivered/failed/opened, and a 0–100 health score. Use an inbox id as smtp_config_id elsewhere. Takes no arguments.

​

list_sequences

List saved email sequences with their inline steps. Takes no arguments.

​

create_sequence

Create the email steps a campaign sends. Each step: subject, body_html, wait_days (0–90), thread_mode (new / reply). Step 0 goes out on enrollment and is always new; a reply step threads under the first email. Merge variables: {{first_name}}, {{company}}, {{title}}, {{domain}}, {{location}}. Bodies are simple HTML — <p>, <br>, <strong>, <a>.

​

draft_email

AI-draft a cold email or a whole follow-up sequence. Returns {subject, html} or {steps: […]}. Persists nothing — feed the result into create_sequence or send_email.

​

Campaigns

​

list_campaigns

List campaigns with per-campaign stats — enrolled, active, completed, sent, opened, replied. Takes no arguments.

​

get_campaign

One campaign’s full analytics: headline stats, a per-step sent/opened breakdown, and every enrolled lead with its progress.

​

create_campaign

Bind a sequence to a sending inbox.

​

update_campaign

Pause, resume, archive, or change a campaign’s name, reply-to or daily limit. Pausing stops further sends without losing progress. Annotated destructive because it overwrites existing fields and archiving is this API’s closest thing to a delete — but applying the same patch twice lands on the same state, so it is also idempotent.

​

Sending

​

enroll_leads

Enroll leads into a campaign, queuing the sequence for real sending and respecting the inbox’s warmup and daily caps. Leads with no email, or already enrolled, are skipped.

​

send_email

Send a single one-off email to a lead now, outside any sequence. Renders merge variables against the lead, respects the inbox’s cap, and marks the lead contacted.

​

outreach_stats

Workspace-wide activity: 14 days of sends (sent/failed/opened per day), replies per day, active enrollments, and today’s sent versus the combined cap. Takes no arguments.

​

Scraping

​

list_scrapers

List the workspace’s scrapers — id, name, target URL, type. Takes no arguments.

​

run_scraper

Run a saved scraper. Asynchronous — returns a runId; read the extracted data with get_scraper_runs.

​

get_scraper_runs

Recent scraper runs with status and extracted data.