The PhantomBuster MCP (Model Context Protocol) server connects PhantomBuster to AI tools like Claude and ChatGPT, so you can launch Phantoms, manage your leads, and handle most of what you'd do in your PhantomBuster Workspace without leaving the chat. Instead of opening PhantomBuster, you describe what you want in your AI tool, and it talks to PhantomBuster on your behalf. This guide explains how to connect the MCP and start using it.
Before you start
You'll need:
- An active PhantomBuster Workspace.
- An MCP-compatible AI tool. This guide covers Claude and ChatGPT below.
The MCP connects to a single Workspace at a time. When you connect, you'll log in to PhantomBuster and choose the Workspace you want to use. The MCP server only ever acts within that selected Workspace. To work in a different Workspace, you'll need to reconnect.
What you can do from the chat
Once connected, your AI tool can do most of what you'd normally do in your PhantomBuster Workspace, including the bigger actions:
- Launch, schedule, and stop your Phantoms
- Check what's currently running and adjust a Phantom's settings
- Retrieve a Phantom's results, outputs, and logs
- Search and update your stored leads
- Build and maintain filtered (dynamic) lead lists
- Create new Phantoms or delete existing ones
- Explore your Workspace (agents, scripts, and usage)
The set of actions evolves over time. Your AI tool picks up the current list automatically once connected, so you don't need to keep track of it.
You stay in control. Most AI tools will ask you to confirm before running a bigger action (creating, deleting, mass-updating). Read what's being suggested before you say yes, and if in doubt, do it yourself in your PhantomBuster Workspace.
How to connect to your AI tool
Connect to Claude
- Open Claude and log in to your account.
- In the left toolbar, select Customize > Connectors.
- Click the + symbol, then Add custom connector.
- In the popup, give it a name and add the server URL: https://mcp.phantombuster.com
- Select Add.
- Log in to your PhantomBuster account when prompted.
- Choose the workspace you want to connect to.
- Click Allow access.
If you see a "This connector has no tools" message, refresh the tools list to reload.
Connect to ChatGPT
- Open ChatGPT and log in to your account.
- In the bottom left, select your Profile.
- Click Settings.
- Select Apps, then Create an app.
- If you can't see the Create an app button, click Advanced settings to enable Developer mode.
- Name the app PhantomBuster.
- Add the URL in the Connection field: https://mcp.phantombuster.com
- Click Create after accepting permissions.
- Log in to your PhantomBuster account when prompted.
If you see a "This connector has no tools" message, refresh the tools list to reload.
Start using the PhantomBuster MCP
Once connected, you can manage your Phantoms directly from the chat. The examples below cover the most common actions, but the MCP can do much more! Your AI tool will discover the available actions automatically once connected.
For the full, up-to-date list of capabilities, the other supported clients (Cursor, Claude Code CLI, Gemini CLI, and Codex CLI), and how authentication works, see our developer documentation: MCP server.
A note on account safety: Social platforms like LinkedIn enforce rate limits and anti-automation measures. Running too many actions, too quickly, or in large bursts can get your connected account temporarily restricted or banned. The MCP is designed to act cautiously, but you stay in control. Keep to small batches and reasonable delays, and review what your AI tool is about to do before confirming large jobs.
How to launch a Phantom
To launch a Phantom, describe what you want to do in your chat window. Your AI tool will identify the right Phantom in your Workspace and launch it.
Example prompt: "Launch my LinkedIn Auto Invitation Withdrawer"
- Type your request in the chat window.
- Your AI tool will confirm which Phantom it's launching and ask for approval if needed.
- Once confirmed, the Phantom launches immediately.
You can also ask your AI tool to schedule a Phantom, for example: "Schedule my LinkedIn Auto Invitation Withdrawer to run once per day."
Or chain actions in one go, for example: "Launch my Sales Navigator Search Export, and once it's finished, give me the top 10 results."
How to update a Phantom's settings
To update a Phantom's settings, describe what you want to change in plain language.
Example prompt: "Update my LinkedIn Search Export to scrape 50 results per launch and to launch once per working hour"
- Type your request in the chat window.
- Your AI tool will confirm the change it's about to make.
- Approve the update and the new settings are saved immediately.
How to retrieve Phantom results
To check what a Phantom returned, ask your AI tool to fetch the output.
Example prompt: "What did my Sales Navigator Search Export return?"
- Type your request in the chat window.
- Your AI tool will fetch the latest output from that Phantom.
- You can then ask it to summarise the results or surface any errors directly in the chat.
How to work with your leads
Beyond running Phantoms, you can ask your AI tool to search and organise the leads stored in your Workspace.
Example prompt: "Find all the leads from fintech companies and add them to a new list called 'Fintech prospects'."
- Type your request in the chat window.
- Your AI tool will search your stored leads using the filters you describe.
- Confirm, and it saves the results to a new or existing list.
Frequently asked questions
Can I create or delete a Phantom with the MCP?
Yes. Your AI tool can create new Phantoms and delete existing ones, the same way you would in your PhantomBuster Workspace. Most AI tools will ask you to confirm before doing it but make sure you read the prompt before you approve. If you'd rather handle these actions yourself, you can always do them directly in your Workspace.
Which AI tools can I use the MCP with?
Any MCP-compatible client. We give step-by-step instructions for Claude and ChatGPT above; the MCP also works with Cursor, Claude Code CLI, Gemini CLI, and Codex CLI (see the developer documentation).
Which plans is the MCP available on?
All of them. The MCP is included on every PhantomBuster plan.
Do I need an API key?
No. The connection uses OAuth. The first time you connect, you'll sign in to PhantomBuster and authorize access. There are no keys to copy or paste.
Can I use more than one Workspace at the same time?
No. The MCP acts within a single selected Workspace. To switch Workspaces, reconnect and choose the other one.
What can the MCP access in my account?
Only the Workspace you select when you connect, and only the actions the MCP exposes: running, managing, creating, and deleting Phantoms, retrieving results, working with leads and lists, and exploring Workspace resources.
Why do I get an "Unauthorized" error at mcp.phantombuster.com?
That's expected. The connection URL isn't a web page, it's a connector endpoint. Opening it directly in a browser will always return an "Unauthorized" message, and nothing is wrong with your account. It only works when you add it as a custom connector inside Claude or ChatGPT, following the steps above. Make sure you connect from a Workspace where you're an owner.
I see "This connector has no tools" - what should I do?
Refresh the tools list. On both Claude and ChatGPT, if the connector shows "This connector has no tools available" right after connecting, click Refresh tools list. The tools (fetch, launch, stop, delete, and more) load once the connection is made. This is the single most common setup hiccup, and a refresh resolves it.