使用说明
AdsPipe — Facebook Ads MCP Server
Manage Facebook Ads from Claude, Cursor, Windsurf, Cline, or any MCP-compatible AI tool.
AdsPipe is a hosted Model Context Protocol server that connects your AI tool directly to your Facebook Ads account. Analyze performance, create campaigns, manage budgets, and upload creative assets — all in natural language, without opening Ads Manager.
Features
- 35 MCP tools across three categories:
- Read (20 tools) — list campaigns, pull insights, access audiences, pixels, creatives, pages, and videos
- Write (10 tools) — create and update campaigns, ad sets, ads, and creatives; pause underperformers
- Media (5 tools) — upload images and videos, create video creatives
- Full ad creation — not just analytics. Create campaigns, build ad sets with targeting, deploy ads, and swap creatives via natural language
- Multi-client support — up to 10 isolated API keys (Agency plan), unlimited ad accounts
- Works with any MCP client: Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex CLI, Gemini CLI, Manus
Quickstart
Claude Code
claude mcp add --transport http adspipe https://api.adspipe.io/mcp \
--header "X-API-Key: YOUR_API_KEY"
Claude Desktop / Cursor / Windsurf
{
"mcpServers": {
"adspipe": {
"type": "http",
"url": "https://api.adspipe.io/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}
Get your API key at app.adspipe.io.
Example prompts
List my campaigns with ROAS for last week, ranked best to worst.
Pause all ad sets spending more than $50/day with ROAS below 1.5x.
Create a CONVERSIONS campaign called "Spring Sale" with a $200 daily budget.
What targeting is set on my retargeting ad set?
Upload hero.jpg to my ad account and create a creative with the headline "Free Inspection".
Available tools
| Tool | Description | Tier |
|---|---|---|
get_account_info |
Ad account details, currency, spend limits | Starter |
list_campaigns |
All campaigns with status, objective, budget | Starter |
get_campaign_insights |
Campaign-level ROAS, spend, CPM, CTR with breakdowns | Starter |
get_ad_insights |
Ad-level performance to find top/bottom creatives | Starter |
list_custom_audiences |
Custom and lookalike audiences with size estimates | Starter |
create_campaign |
Create a new campaign with objective and budget | Pro |
update_campaign |
Pause, activate, or update budget | Pro |
create_adset |
Create ad set with full targeting spec | Pro |
create_ad |
Deploy a new ad using an existing creative | Pro |
create_creative |
Create an ad creative with headline, copy, image | Pro |
upload_image |
Upload image to ad account asset library | Agency |
upload_video |
Upload video and initiate Meta encoding | Agency |
create_video_creative |
Create a video ad creative | Agency |
Pricing
| Plan | Price | API Calls | Tools |
|---|---|---|---|
| Starter | $29/mo | 5,000 | 20 read-only |
| Pro | $79/mo | 25,000 | 30 (read + write) |
| Agency | $199/mo | 100,000 | 35 (all tools) |
Links
- Website: adspipe.io
- Dashboard: app.adspipe.io
- Docs: adspipe.io/docs/getting-started/
- Support: hello@adspipe.io