MCP Tools Reference

Get ad account details including currency, timezone, spend limits, and account status.

Example: "What's my current ad account status and monthly spend limit?"

List all campaigns with status, objective, budget type, and spend to date.

Example: "Show me all my active campaigns and their current budgets."

Get full details for a single campaign by ID.

Example: "What's the objective and budget for campaign 120207890123456?"

List all ad sets within a campaign including targeting, budget, and schedule.

Example: "List all ad sets in my Summer 2026 campaign."

Get full details for a single ad set including audience targeting and placement settings.

Example: "What targeting is set on ad set 120207890123789?"

List all ads within an ad set with status and creative references.

Example: "Show me all ads in my retargeting ad set."

Get full details for a single ad including creative preview link.

Example: "What creative is running on ad 120207890124000?"

List ad creatives with titles, bodies, image hashes, and call-to-action types.

Example: "Show me all creatives associated with my account."

Get full creative details including headline, primary text, description, and image.

Example: "What's the copy on creative 120207890125000?"

Pull account-level performance data: impressions, clicks, CTR, spend, CPM, CPC, and ROAS.

Example: "What was my total spend and ROAS last week?"

Pull campaign-level insights with optional breakdowns by age, gender, placement, or device.

Example: "Which of my campaigns had the best ROAS in the last 30 days?"

Pull ad set level performance data with delivery and frequency metrics.

Example: "Which ad sets are underperforming against my CPA target?"

Pull ad-level performance data to identify top and bottom performers.

Example: "Rank my ads by ROAS and flag any with frequency above 5."

List Facebook Pages connected to the ad account.

Example: "Which Facebook Pages are linked to my ad account?"

Get details for a Facebook Page including follower count and engagement metrics.

Example: "What's the follower count on my business Page?"

List Meta Pixels installed on the account with event tracking status.

Example: "Are my pixels firing correctly? Show me all pixel IDs."

Get pixel details and a log of recent events received.

Example: "Is my purchase event firing on pixel 123456789?"

List all custom audiences and lookalikes with size estimates and retention windows.

Example: "What custom audiences do I have and how large are they?"

Get audience details including source, rules, and estimated size.

Example: "What's the source and size of my 180-day website visitor audience?"

List videos uploaded to the ad account with duration, thumbnails, and usage status.

Example: "Show me all video assets in my account."

Create a new campaign with a specified objective, budget type, and spend cap.

Example: "Create a CONVERSIONS campaign with a $500 daily budget called 'Q2 Lead Gen'."

Update campaign name, status (active/paused), budget, or spend cap.

Example: "Pause all campaigns that spent more than $1,000 with under 2x ROAS this week."

Permanently delete a campaign and all its ad sets and ads.

Example: "Delete the test campaign I created last month."

Create an ad set with targeting, placements, budget, schedule, and optimization goal.

Example: "Create an ad set targeting women 25-45 in Florida interested in home improvement, $100/day, optimizing for leads."

Update ad set budget, schedule, bid strategy, or targeting parameters.

Example: "Increase the daily budget on my best-performing ad set by 20%."

Delete an ad set and all ads within it.

Example: "Delete ad sets that have delivered fewer than 10 impressions in 7 days."

Create a new ad within an ad set using an existing creative.

Example: "Create an ad using creative 120207890125000 in my retargeting ad set."

Update an ad's status or swap in a new creative.

Example: "Pause all ads with CTR below 1% in my prospecting campaign."

Delete a specific ad from an ad set.

Example: "Delete the ad that's been running for 90 days with no conversions."

Create an ad creative with headline, primary text, description, image hash, and CTA.

Example: "Create a creative with the headline 'Free Roof Inspection' and image abc123."

Upload an image file to the ad account asset library and return its image hash.

Example: "Upload hero.jpg to my ad account so I can use it in a creative."

Upload a video file to the ad account and initiate Meta's encoding pipeline.

Example: "Upload my 30-second testimonial video to the ad account."

Check the encoding and processing status of an uploaded video.

Example: "Is my video done processing? Check the status of video upload 120207890200000."

Create a video ad creative using an uploaded video with title, message, and CTA.

Example: "Create a video creative using video 120207890200000 with 'Watch our story' as the title."

List all images uploaded to the ad account with hashes, dimensions, and creation dates.

Example: "Show me all image assets in my account uploaded in the last 30 days."