# PhantomBuster MCP for AI Agents AI Agent Connect

> PhantomBuster MCP lets you manage your lead generation and web scraping workflows directly from your AI client. Instead of jumping between tabs, you can launch automations, check results, and audit configurations using natural language. It's the fastest way to keep your data scraping and outreach workflows moving without manual oversight.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_cEm1qpekB7GtJpKhz0j9McLvg4Hh97Lo7G4lguN0/ai-agent-connect
- **Tags:** automation, data-extraction, lead-gen, workflow-automation, browser-automation

## Description

Managing a fleet of browser automations usually means jumping between multiple tabs, watching progress bars, and manually inputting arguments for every new run. It's tedious work that breaks your focus. This Connector changes that by bringing your entire PhantomBuster account into your AI workspace. You can talk to your agent to see which automations are currently running, grab the latest leads from a finished scrape, or double-check the settings of a workflow before you hit go. It's about moving from manual execution to high-level oversight. By connecting through the Vinkius catalog, you get a direct line to your automation suite where you can launch, stop, and monitor everything in one conversation. You'll spend less time babysitting bots and more time actually using the data they find.

## Tools

### get_phantombuster_account
Get account settings and usage info. Use this to check how much execution time you have left for the month.

### get_phantom_setup
Get configuration arguments for a Phantom. This lets you audit the logic of a specific bot to ensure it's set up correctly.

### get_phantom_output
Get output results from a Phantom. Use this to pull the actual data scraped by a bot into your current chat.

### get_phantom
Get details for a specific Phantom. This provides the core metadata and status for any bot in your account.

### get_workflow
Get details for a specific workflow. This shows you the structure and state of an automation workflow.

### launch_phantom
Start a Phantom execution. Use this to trigger a new scrape or automation task with custom arguments.

### list_containers
List all Phantom containers. This gives you a high-level view of all your active automation environments.

### list_phantoms
List all Phantom agents. Use this to see every bot available in your account at a glance.

### list_workflows
List all automation workflows. This helps you keep track of all your saved automation sequences.

### abort_phantom
Stop a running Phantom immediately. Use this if a bot starts scraping the wrong site or hits a rate limit.

## Prompt Examples

**Prompt:** 
```
List all my Phantoms and tell me which ones are currently running.
```

**Response:** 
```
I've checked your PhantomBuster account and found the following active Phantoms:

| Phantom Name | Status | Last Run |
| :--- | :--- | :--- |
| **LinkedIn Search Export** | Running | 2 mins ago |
| **Web Scraper** | Ready | 1 hour ago |
| **Sales Navigator Scrape** | Success | 3 hours ago |

Would you like me to fetch the results for the completed 'Sales Navigator Scrape'?
```

**Prompt:** 
```
Launch the LinkedIn scraper with the URL 'example.com' and tell me when it's done.
```

**Response:** 
```
I've launched the **LinkedIn Search Export** Phantom with the URL `example.com`. 

I'll keep an eye on it for you. Once the execution is finished, I'll let you know and can pull the extracted leads directly into this chat.
```

**Prompt:** 
```
Show me the results from my last web scraping run.
```

**Response:** 
```
I've retrieved the results from your last **Web Scraper** run. It successfully extracted 42 leads:

* **Company:** TechFlow Inc. | **Title:** CTO | **Link:** [Profile]
* **Company:** DataViz | **Title:** Head of Sales | **Link:** [Profile]
* ... (38 more)

Would you like me to format this into a table or save it to a file?
```

## Capabilities

### Launch and stop automations
Start new scraping tasks or kill running processes immediately via chat.

### Fetch scraped data
Pull the results of a finished run directly into your current conversation.

### Audit configuration settings
Review the arguments and logic of a specific bot before you trigger it.

### Monitor account usage
Check your remaining execution time and account status in real time.

### List active workflows
Get a full overview of your saved automations and their current status.

## Use Cases

### Automated LinkedIn Lead Scraping
A marketer asks the agent to launch a specific Phantom to scrape a list of profiles and then requests the output once it's done.

### Real-time CRM Data Enrichment
A sales op uses the agent to fetch results from a web scraper to see if new leads are available for import into their CRM.

### Debugging Scraper Logic
A data engineer asks the agent to show the configuration of a specific Phantom to verify that the correct URLs and arguments are being passed.

### Quota and Usage Tracking
A manager asks the agent to check the account settings to see how many execution minutes are left in the monthly quota.

## Benefits

- Stop babysitting bots by using launch_phantom to trigger your scrapes with specific arguments via chat.
- Get data faster by using get_phantom_output to pull leads directly into your workspace for analysis.
- Prevent wasted credits by using get_phantombuster_account to monitor your remaining execution time.
- Audit your logic easily with get_phantom_setup to ensure your automation parameters are correct before running.
- Maintain a clean workspace by using list_phantoms to see every bot's status without switching tabs.

## How It Works

The bottom line is you get a voice-controlled dashboard for your web automation suite.

1. Connect your PhantomBuster account by providing your API key in the Connector settings.
2. Ask your AI client to list your active Phantoms or check the status of a specific workflow.
3. Give direct commands to launch a new run, abort a process, or fetch the latest results.

## Frequently Asked Questions

**Can I use PhantomBuster MCP to start my scrapers?**
Yes, you can trigger any Phantom execution using natural language commands. Your agent can launch specific bots with custom arguments without you needing to log into the web dashboard.

**How do I see my lead generation results?**
You can ask your agent to pull the output from a specific Phantom directly into your chat. It will fetch the latest data extracted by the bot and display it for you immediately.

**Can this Connector help me save on execution time?**
Yes, you can use it to check your account settings and see how much time you have left. It provides a quick way to monitor your usage limits while you work.

**Can I check if my scraper is configured correctly?**
You can ask your agent to show the setup and arguments for any specific Phantom. This allows you to verify the logic and parameters before you trigger a run.

**Does PhantomBuster MCP work with Claude?**
Yes, it works with any MCP-compatible client including Claude, Cursor, and Windsurf. Once connected, your agent can manage your entire PhantomBuster suite.

**Can I stop a bot if it starts doing something wrong?**
Yes, you can use the abort command to stop any running Phantom immediately. This is helpful if a bot starts scraping the wrong site or hits a rate limit.

**How do I find my PhantomBuster API Key?**
In your PhantomBuster account, click on your name in the top right, go to **Org settings** or **Workspace settings**, and look for the **API Key** section.

**Can I provide arguments when launching a Phantom?**
Yes! The `launch_phantom` action accepts an optional `argument` field where you can provide a JSON string of parameters to override the default Phantom configuration.

**How do I see the data extracted by a Phantom?**
Use the `get_phantom_output` tool with the specific agent ID. It will return the results of the last successful execution of that Phantom.