MCP Server for PhantomBuster

A Model Context Protocol (MCP) server that provides tools to interact with the PhantomBuster automation platform. Manage your agents (phantoms), monitor executions, and retrieve results — all through MCP-compatible AI assistants.

Features

• 🤖 Agent Management — List, get, launch, stop, and delete agents

• 📦 Container Monitoring — List and inspect execution containers

• 📊 Results Retrieval — Get agent output and structured result objects

• 🔒 Secure — API key via environment variable, never hardcoded

Related MCP server: MCP Server Demo

Quick Start

Using npx (recommended)

No installation required:

npx globodai-mcp-phantombuster

Install globally

npm install -g globodai-mcp-phantombuster
mcp-phantombuster

Configuration

Environment Variable

Set your PhantomBuster API key:

export PHANTOMBUSTER_API_KEY="YOUR_API_KEY"

📝 Get your API key from PhantomBuster Workspace Settings

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "phantombuster": {
      "command": "npx",
      "args": ["-y", "globodai-mcp-phantombuster"],
      "env": {
        "PHANTOMBUSTER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "phantombuster": {
      "command": "npx",
      "args": ["-y", "globodai-mcp-phantombuster"],
      "env": {
        "PHANTOMBUSTER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Available Tools

Agent Tools

Container Tools

Result Tools

Usage Examples

List all your agents

"List all my PhantomBuster agents"

Launch an agent with custom arguments

"Launch PhantomBuster agent 12345 with argument: {"search": "AI startups"}"

Monitor an execution

"What's the output of agent 12345? Is it still running?"

Get results from a run

"Get the results from container abc123"

Development

# Clone the repository
git clone https://github.com/globodai-group/mcp-phantombuster.git
cd mcp-phantombuster

# Install dependencies
npm install

# Run in development mode
PHANTOMBUSTER_API_KEY="YOUR_API_KEY" npm run dev

# Build
npm run build

# Type check
npm run lint

API Reference

This MCP server wraps the PhantomBuster API v2:

• Base URL: https://api.phantombuster.com/api/v2

• Auth: X-Phantombuster-Key header

• Full API Documentation

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

MIT

Built with ❤️ by GlobodAI