HomeGuides & tutorialsAPI reference
Guides & tutorials
Back to Phantombuster.com →

MCP server

Give AI tools a secured access to your PhantomBuster automations and data

Suggest Edits

The PhantomBuster MCP (Model Context Protocol) server gives AI assistants like ChatGPT, Claude, and Cursor a secure, standardized way to work with your PhantomBuster data and automations directly from a conversation.
Instead of switching between PhantomBuster and your AI tool, you can ask your assistant to launch a Phantom, pull results, or build a filtered lead list, and it talks to PhantomBuster on your behalf.

What is the PhantomBuster MCP server?

MCP is an open standard that lets AI agents connect to external services through a single, consistent interface. Our MCP server is centrally hosted and managed by PhantomBuster, exposes a curated subset of the PhantomBuster API as tools, and is protected by OAuth. It works with any MCP-compatible client and supports the Streamable HTTP transport.

When you connect, you'll log in to your PhantomBuster account 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 can you do with it?

The MCP server lets your AI assistant interact with the core of your selected PhantomBuster workspace. At a high level, it can:

  • Run and manage your automations — launch Phantoms, check what's currently running, stop them, and adjust their configuration.
  • Retrieve results and outputs — pull the data and logs produced by your Phantoms so your assistant can summarize, analyze, or act on them.
  • Work with your leads — search across your stored leads using rich filters, and save or update records.
  • Build and maintain dynamic lists — create or update filtered lead lists (the same dynamic lists you'd build in the app) straight from a prompt.
  • Explore your workspace — look up your agents, scripts, and organization resources and usage to get context before taking action.

This is a curated set of capabilities focused on the most common workflows, not the entire PhantomBuster API. The available tools evolve over time, and your assistant will discover the current list automatically once connected.

Connecting to the server

The MCP server is available at:

https://mcp.phantombuster.com

Authentication uses OAuth: the first time your client connects, you'll be redirected to sign in to PhantomBuster and authorize access. No API keys to copy or paste. After that, your assistant will reuse this connection.

ChatGPT

Add a custom connector pointing to the MCP URL above.

Reference: https://developers.openai.com/apps-sdk/deploy/connect-chatgpt

Claude

From Customize → Connectors, add a custom connector with the MCP URL above.

Reference: https://claude.com/docs/connectors/custom/remote-mcp

Claude Code

Run the following command:

claude mcp add --transport http phantombuster https://mcp.phantombuster.com

Reference: https://code.claude.com/docs/en/mcp