PhantomBuster MCP server
56 operations0 webhooks
Web automation and data extraction platform for scraping websites and automating workflows.
Try PhantomBuster with your agent
Connect PhantomBuster, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in PhantomBuster on my account, then run one read-only example and show me the result.
PhantomBuster tools and triggers
Tools are what your agent can do in PhantomBuster through Corsair's MCP server. Triggers are the PhantomBuster events a routine can start from.
Agents
- DeleteDestructive
Delete a PhantomBuster agent by ID
agents.delete
- FetchRead-only
Get details for a specific PhantomBuster agent by ID
agents.fetch
- Fetch AllRead-only
Get all PhantomBuster agents (Phantoms) in the organization
agents.fetchAll
- Fetch DeletedRead-only
Get all deleted agents in the organization
agents.fetchDeleted
- Fetch OutputRead-only
Get the output of the most recent container for an agent, including status, progress, console log, and result object
agents.fetchOutput
- LaunchWrite
Add a PhantomBuster agent to the launch queue
agents.launch
- Launch SoonWrite
Schedule a PhantomBuster agent to launch before a specific time
agents.launchSoon
- SaveWrite
Create a new agent or update an existing one
agents.save
- StopWrite
Stop a currently running PhantomBuster agent
agents.stop
- Unschedule AllWrite
Disable automatic launch for all agents in the organization
agents.unscheduleAll
Orgs
- Export Agent UsageRead-only
Export agent usage CSV for the organization
orgs.exportAgentUsage
- Export Container UsageRead-only
Export container usage CSV for the organization
orgs.exportContainerUsage
- FetchRead-only
Get the current organization info
orgs.fetch
- Fetch Agent GroupsRead-only
Get agent groups and order for the organization
orgs.fetchAgentGroups
- Fetch ResourcesRead-only
Get the organization resource usage (slots, limits)
orgs.fetchResources
- Fetch Running ContainersRead-only
Get the organization's running containers
orgs.fetchRunningContainers
- Save Agent GroupsWrite
Update agent groups and order for the organization
orgs.saveAgentGroups
Scripts
- DeleteDestructive
Delete a script by ID
scripts.delete
- FetchRead-only
Fetch a script by ID
scripts.fetch
- Fetch AllRead-only
Fetch all scripts for the current user
scripts.fetchAll
- Fetch CodeRead-only
Get the code of a script
scripts.fetchCode
- SaveWrite
Create a new script or update an existing one
scripts.save
- Update Access ListWrite
Update a script's access list
scripts.updateAccessList
- Update VisibilityWrite
Update the visibility of a script
scripts.updateVisibility
Storage
- Delete Lead ObjectsDestructive
Delete lead objects from organization storage
storage.deleteLeadObjects
- Save Company ObjectWrite
Save a company object to organization storage
storage.saveCompanyObject
- Save Lead ObjectWrite
Save a lead object to organization storage
storage.saveLeadObject
- Save Many Company ObjectsWrite
Bulk-save company objects to organization storage
storage.saveManyCompanyObjects
- Save Many Lead ObjectsWrite
Bulk-save lead objects to organization storage
storage.saveManyLeadObjects
- Search Company ObjectsRead-only
Search company objects in organization storage
storage.searchCompanyObjects
- Search Lead ObjectsRead-only
Search lead objects in organization storage
storage.searchLeadObjects
Branches
- CreateWrite
Create a new branch
branches.create
- DeleteDestructive
Delete a branch by ID
branches.delete
- Fetch AllRead-only
Fetch all branches in the organization
branches.fetchAll
- Fetch DiffRead-only
Get the staging/release diff for script branches
branches.fetchDiff
- ReleaseWrite
Release a script branch
branches.release
Containers
- FetchRead-only
Get details for a specific run container by ID
containers.fetch
- Fetch AllRead-only
Get all run containers for a specific agent
containers.fetchAll
- Fetch OutputRead-only
Get the console output for a specific container
containers.fetchOutput
- Fetch Result ObjectRead-only
Get the result object (JSON data) from a specific container
containers.fetchResultObject
Leads
- Delete ManyDestructive
Delete multiple leads by their IDs
leads.deleteMany
- Fetch By ListRead-only
Fetch leads belonging to a specific lead list
leads.fetchByList
- SaveWrite
Save a single lead to PhantomBuster org storage
leads.save
- Save ManyWrite
Bulk-save multiple leads to PhantomBuster org storage
leads.saveMany
Lists
- DeleteDestructive
Delete a lead list by ID
lists.delete
- FetchRead-only
Get details for a specific lead list by ID
lists.fetch
- Fetch AllRead-only
Get all lead lists in the organization
lists.fetchAll
- SaveWrite
Create a new lead list or update an existing one
lists.save
Misc
- Fetch Ip LocationRead-only
Retrieve the country of an IP address
misc.fetchIpLocation
- Request Ai CompletionWrite
Request a text completion from the AI module
misc.requestAiCompletion
- Solve HCaptchaWrite
Solve an hCaptcha challenge
misc.solveHCaptcha
- Solve RecaptchaWrite
Solve a reCAPTCHA challenge (v2 or v3)
misc.solveRecaptcha
Identities
- Generate TokenWrite
Generate an identity token
identities.generateToken
- Save EventWrite
Save an identity event
identities.saveEvent
Users
- Fetch MeRead-only
Get info about the currently authenticated PhantomBuster user
users.fetchMe
- Update MeWrite
Update the current user's info
users.updateMe
Connect PhantomBuster to Claude, ChatGPT or Cursor
- 1
Connect PhantomBuster in Corsair
Add your PhantomBuster API key once in Corsair. Corsair stores the credential encrypted and makes the PhantomBuster API calls for your agent, so it never goes into a prompt or a config file. Connect PhantomBuster
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs PhantomBuster. On a ChatGPT personal plan, connect PhantomBuster here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, PhantomBuster's read and write operations run right away and its 6 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
PhantomBuster works with
FAQ
Install corsair and @corsair-dev/phantombuster, add the PhantomBuster plugin, and connect with an API key. Then call methods like corsair.phantombuster.api.agents.delete() from your app. Corsair keeps each tenant isolated.
Yes. PhantomBuster requires an API key from your PhantomBuster account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit PhantomBuster, GitHub, Notion, Stripe, and the rest. Trigger PhantomBuster from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for web automation and data extraction platform for scraping websites and automating workflows. Common builds include sync jobs, admin tooling, and agents that call PhantomBuster APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per PhantomBuster API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/phantombuster in the open repo. When PhantomBuster ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your PhantomBuster data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store PhantomBuster data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put PhantomBuster on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 6 destructive PhantomBuster operations. You can change a link's mode at hub.corsair.dev/me.