Integration

PhantomBuster integration

Social media automation and scraping platform API. Launch and manage Phantoms (automated scrapers and workflows) to extract data from LinkedIn, Instagram, Twitter, Facebook, and other platforms. Features include agent execution, output retrieval, container management, lead storage, and scheduling. Build data pipelines for lead generation, profile scraping, outreach automation, and social media analytics.

Connect PhantomBuster How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in PhantomBuster.Built from the 42 PhantomBuster tools below, on the connection you add once.

Common PhantomBuster use cases

audit execution history
clean up unused phantoms
stop a long-running scraper
audit deleted phantom history
discover available lead lists
debug failed phantom execution
remove obsolete custom scripts
audit phantom execution history
poll phantom execution progress
discover available phantom types

What you can do with PhantomBuster

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Agent, 10 operations

delete_agentDelete agentPOSTPermanently deletes a PhantomBuster agent. This removes the agent and its configuration. Execution history may still be accessible via containers.
fetch_agentFetch agentGETRetrieves a PhantomBuster agent by ID. Returns agent details including name, script ID, launch configuration, execution counts, proxy settings, and current running/queued container status.
fetch_all_agentsFetch all agentsGETLists all PhantomBuster agents (Phantoms) in the organization. Returns an array of agent objects with their configurations, statuses, and execution counts.
fetch_deleted_agentsFetch deleted agentsGETLists all deleted PhantomBuster agents (Phantoms) in the organization. Returns an array of previously deleted agent objects with their configurations and metadata.
launch_agentLaunch agentPOSTLaunches a PhantomBuster agent (Phantom) by adding it to the execution queue. Pass the agent ID and optional arguments. Returns immediately while the agent runs asynchronously. Use fetch-output to monitor progress.
launch_agent_soonLaunch agent soonPOSTSchedules a PhantomBuster agent to launch within a specified number of minutes. The agent will be queued for execution before the time window expires.
launch_agent_syncLaunch agent syncPOSTLaunches a PhantomBuster agent synchronously and streams results via NDJSON. Blocks until completion, returning heartbeats, logs, and a summary with containerId, executionTime, and exitCode.
save_agentSave agentPOSTCreates or updates a PhantomBuster agent. Provide an ID to update an existing agent, or omit it to create a new one. Configure name, script, default arguments, timeouts, and proxy settings.
stop_agentStop agentPOSTStops a running PhantomBuster agent. Supports soft abort for graceful shutdown, cascade to stop dependent agents, and options to cancel scheduled launches or switch to manual mode.
unschedule_all_agentsUnschedule all agentsPOSTDisables all automatic and scheduled launches across every agent in the organization. Emergency stop for all phantom schedules.

Organization, 9 operations

export_agent_usageExport agent usageGETExports a CSV of agent usage data for the organization over a given period (up to 6 months).
export_container_usageExport container usageGETExports a CSV of container execution usage data for the organization over a given period (up to 6 months).
fetch_crm_accessFetch crm accessGETRetrieves CRM integration access permissions for the organization (HubSpot, Salesforce, Pipedrive).
fetch_crm_resourcesFetch crm resourcesGETRetrieves available CRM resources (contact fields, pipelines, stages) from connected CRM integrations.
fetch_orgFetch orgGETRetrieves the current organization's full details. Returns name, resource limits (execution time, email, captcha, storage), billing info, timezone, plan details, proxy configuration, and CRM integrations.
fetch_org_agent_groupsFetch org agent groupsGETRetrieves the agent groups and their display order for the current organization. Returns group names, IDs, and the agents assigned to each group.
fetch_org_resourcesFetch org resourcesGETRetrieves the current organization's resource usage and remaining quotas. Returns consumption metrics across execution time, emails, captchas, storage, and other platform services.
fetch_org_running_containersFetch org running containersGETLists all currently running containers (active executions) across the entire organization. Returns container details for every Phantom currently in execution.
save_org_agent_groupsSave org agent groupsPOSTCreates or updates agent group configurations for the organization, controlling how phantoms are grouped and displayed.

Script, 7 operations

delete_scriptDelete scriptPOSTPermanently deletes a custom script from the organization. Only scripts owned by the organization can be deleted.
fetch_all_scriptsFetch all scriptsGETLists all scripts available in the organization. Returns both public PhantomBuster scripts (official Phantom types) and custom user-created scripts with their metadata.
fetch_scriptFetch scriptGETRetrieves a PhantomBuster script by ID. Returns script metadata including name, description, category, and configuration schema used by agents running this script.
fetch_script_codeFetch script codeGETRetrieves the source code of a PhantomBuster script. Returns the JavaScript/CoffeeScript code that defines the Phantom's behavior. Only available for custom scripts owned by the organization.
manage_script_access_listManage script access listPOSTManages the access list for a custom script, specifying which organizations or users are permitted to use it.
save_scriptSave scriptPOSTCreates or updates a custom PhantomBuster script. Provide an ID to update an existing script or omit it to create a new one.
set_script_visibilitySet script visibilityPOSTSets the visibility of a custom script to public or private within the organization.

Branch, 5 operations

create_branchCreate branchPOSTCreates a new branch in the current organization. Used for script version management, allowing development of script changes in isolation.
delete_branchDelete branchPOSTPermanently deletes a branch from the current organization. Removes the branch and any unreleased script changes it contained.
diff_branchDiff branchGETCompares a branch against the production script to show what code changes are pending release.
fetch_all_branchesFetch all branchesGETLists all branches in the current organization. Returns branch metadata including names and IDs. Branches are used for versioning and managing script development.
release_branchRelease branchPOSTReleases a branch's changes to production, making them the active script version for all agents using that script.

Container, 3 operations

attach_containerAttach containerGETAttaches to a running PhantomBuster container to receive its real-time output stream. Returns live console output as the Phantom executes.
fetch_all_containersFetch all containersGETLists all execution containers (runs) for a specific PhantomBuster agent. Filter by end date, limit results, and optionally include runtime events. Returns container history with status, timing, and exit information.
fetch_containerFetch containerGETRetrieves a specific PhantomBuster container (execution run) by ID. Optionally includes the result object (scraped data), console output, runtime events, and links to adjacent containers.

Lead, 2 operations

save_leadsSave leadsPOSTSaves a single lead record to the PhantomBuster organization storage. Include lead data fields and optionally assign to a specific list.
save_leads_bulkSave leads bulkPOSTSaves multiple lead records to PhantomBuster organization storage in a single bulk operation. Efficiently import large sets of leads with optional list assignment.

Output, 2 operations

fetch_agent_outputFetch agent outputGETRetrieves the most recent execution output of a PhantomBuster agent. Designed for incremental polling with position tracking. Returns container ID, status, console output, progress, and runtime events.
fetch_container_outputFetch container outputGETRetrieves the console output log from a PhantomBuster container execution. Choose between JSON-formatted or raw text output mode.

Crm contact, 1 operation

save_crm_contactSave crm contactPOSTSaves or updates a contact in the connected CRM integration (HubSpot, Salesforce, or Pipedrive).

List, 1 operation

fetch_all_listsFetch all listsGETRetrieves all lead lists from the PhantomBuster organization storage. Returns list metadata including names, IDs, and lead counts.

Result, 1 operation

fetch_container_result_objectFetch container result objectGETRetrieves the result object (scraped data) from a specific PhantomBuster container execution. Returns the raw JSON result string containing extracted data like profiles, leads, or posts.

User, 1 operation

fetch_userFetch userGETRetrieves the authenticated user's account information. Returns email, remaining time/email/captcha/storage quotas, and a summary of all agents with their statuses. Note: this is a v1 endpoint at /api/v1/user.

Use PhantomBuster from Claude Code, Cursor or Codex

Connect PhantomBuster in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its PhantomBuster operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect PhantomBuster

Create your workspace
Sign up free. Nothing to install.
Connect PhantomBuster once
Add your PhantomBuster connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

PhantomBuster integration FAQ

What can you do with the PhantomBuster integration?

LiveContext exposes 42 operations on PhantomBuster, covering agent, organization, script and branch. Common uses include audit execution history, clean up unused phantoms and stop a long-running scraper.