AdWeave — Meta Ads MCP Server
ai.adweave/meta-ads-mcp
50 toolsauthHTTPregistry active
Summary
This is a comprehensive integration with Meta's advertising platform, exposing 47 tools that let you manage the full lifecycle of Facebook and Instagram campaigns programmatically. You get operations for creating and updating campaigns, designing ad creatives, building custom and lookalike audiences, and pulling performance insights without leaving your Claude workflow. Reach for this when you're running paid social at scale and want to automate campaign adjustments, analyze results, or spin up audience segments based on data analysis. The streamable HTTP transport means you can connect to Adweave's hosted instance without managing authentication tokens yourself, which saves the usual Meta API credential headache.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
50 tools
tool_get_ad_accountsGet ad accounts accessible by the current user. Returns account details including name, status, currency, spend, and balance. Amounts are returned in currency units (e.g. USD dollars), not cents.1 params
Get ad accounts accessible by the current user. Returns account details including name, status, currency, spend, and balance. Amounts are returned in currency units (e.g. USD dollars), not cents.
Parameters* required
limitintegerdefault: 200
tool_get_account_infoGet detailed information about a specific ad account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX)1 params
Get detailed information about a specific ad account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX)
Parameters* required
account_idstringtool_get_account_pagesGet Facebook Pages associated with a Meta Ads account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX)1 params
Get Facebook Pages associated with a Meta Ads account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX)
Parameters* required
account_idstringtool_get_campaignsGet campaigns for a Meta Ads account with optional filtering. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) limit: Maximum number of campaigns to return (default: 10) status_filter: Filter by effective status (e.g. ACTIVE, PAUSED, ARCHIVED) objective_filter: Fi...5 params
Get campaigns for a Meta Ads account with optional filtering. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) limit: Maximum number of campaigns to return (default: 10) status_filter: Filter by effective status (e.g. ACTIVE, PAUSED, ARCHIVED) objective_filter: Fi...
Parameters* required
afterstringdefault:
limitintegerdefault: 10
account_idstringstatus_filterstringdefault:
objective_filterstringdefault:
tool_get_campaign_detailsGet detailed information about a specific campaign. Args: campaign_id: Meta Ads campaign ID1 params
Get detailed information about a specific campaign. Args: campaign_id: Meta Ads campaign ID
Parameters* required
campaign_idstringtool_create_campaignCreate a new campaign in a Meta Ads account. Always set daily_budget (CENTS: "500" = $5/day) and bid_strategy="LOWEST_COST_WITHOUT_CAP". Do NOT set budget on ad sets. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) name: Campaign name objective: OUTCOME_AWARENESS...13 params
Create a new campaign in a Meta Ads account. Always set daily_budget (CENTS: "500" = $5/day) and bid_strategy="LOWEST_COST_WITHOUT_CAP". Do NOT set budget on ad sets. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) name: Campaign name objective: OUTCOME_AWARENESS...
Parameters* required
namestringstatusstringdefault: PAUSED
bid_capstringdefault:
objectivestringspend_capstringdefault:
account_idstringbuying_typestringdefault:
bid_strategystringdefault:
daily_budgetstringdefault:
lifetime_budgetstringdefault:
special_ad_categoriesstringdefault: []
use_adset_level_budgetsbooleandefault: false
campaign_budget_optimizationstringdefault:
tool_update_campaignUpdate an existing campaign. Args: campaign_id: Meta Ads campaign ID name: New campaign name status: New status (ACTIVE, PAUSED) daily_budget: New daily budget in cents lifetime_budget: New lifetime budget in cents bid_strategy: New bid strategy spend_cap: New spending limit i...7 params
Update an existing campaign. Args: campaign_id: Meta Ads campaign ID name: New campaign name status: New status (ACTIVE, PAUSED) daily_budget: New daily budget in cents lifetime_budget: New lifetime budget in cents bid_strategy: New bid strategy spend_cap: New spending limit i...
Parameters* required
namestringdefault:
statusstringdefault:
spend_capstringdefault:
campaign_idstringbid_strategystringdefault:
daily_budgetstringdefault:
lifetime_budgetstringdefault:
tool_duplicate_campaignDuplicate a campaign with all its settings. Args: campaign_id: Meta Ads campaign ID to duplicate name_suffix: Suffix for the new campaign name new_status: Status for the new campaign (ACTIVE or PAUSED) new_daily_budget: Override daily budget in cents4 params
Duplicate a campaign with all its settings. Args: campaign_id: Meta Ads campaign ID to duplicate name_suffix: Suffix for the new campaign name new_status: Status for the new campaign (ACTIVE or PAUSED) new_daily_budget: Override daily budget in cents
Parameters* required
new_statusstringdefault: PAUSED
campaign_idstringname_suffixstringdefault: - Copy
new_daily_budgetstringdefault:
tool_get_adsetsGet ad sets for a Meta Ads account, optionally filtered by campaign. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) limit: Maximum number of ad sets to return (default: 10) campaign_id: Optional campaign ID to filter by3 params
Get ad sets for a Meta Ads account, optionally filtered by campaign. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) limit: Maximum number of ad sets to return (default: 10) campaign_id: Optional campaign ID to filter by
Parameters* required
limitintegerdefault: 10
account_idstringcampaign_idstringdefault:
tool_get_adset_detailsGet detailed information about a specific ad set. Args: adset_id: Meta Ads ad set ID1 params
Get detailed information about a specific ad set. Args: adset_id: Meta Ads ad set ID
Parameters* required
adset_idstringtool_create_adsetCreate a new ad set in a Meta Ads account. Budget is controlled at the campaign level (CBO). Any daily_budget or lifetime_budget passed here will be ignored to avoid Meta API errors. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) campaign_id: Campaign ID this ad...17 params
Create a new ad set in a Meta Ads account. Budget is controlled at the campaign level (CBO). Any daily_budget or lifetime_budget passed here will be ignored to avoid Meta API errors. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) campaign_id: Campaign ID this ad...
Parameters* required
namestringstatusstringdefault: PAUSED
end_timestringdefault:
targetingstringdefault:
account_idstringbid_amountstringdefault:
start_timestringdefault:
campaign_idstringbid_strategystringdefault:
daily_budgetstringdefault:
billing_eventstringbid_constraintsstringdefault:
lifetime_budgetstringdefault:
promoted_objectstringdefault:
destination_typestringdefault:
optimization_goalstringis_dynamic_creativestringdefault:
tool_update_adsetUpdate an ad set with new settings. Args: adset_id: Meta Ads ad set ID name: New name status: ACTIVE, PAUSED daily_budget: In cents lifetime_budget: In cents bid_amount: In cents bid_strategy: LOWEST_COST_WITHOUT_CAP, COST_CAP, etc. bid_constraints: JSON string targeting: JSON...12 params
Update an ad set with new settings. Args: adset_id: Meta Ads ad set ID name: New name status: ACTIVE, PAUSED daily_budget: In cents lifetime_budget: In cents bid_amount: In cents bid_strategy: LOWEST_COST_WITHOUT_CAP, COST_CAP, etc. bid_constraints: JSON string targeting: JSON...
Parameters* required
namestringdefault:
statusstringdefault:
adset_idstringtargetingstringdefault:
bid_amountstringdefault:
bid_strategystringdefault:
daily_budgetstringdefault:
bid_constraintsstringdefault:
lifetime_budgetstringdefault:
optimization_goalstringdefault:
is_dynamic_creativestringdefault:
frequency_control_specsstringdefault:
tool_duplicate_adsetDuplicate an ad set with its settings. Args: adset_id: Ad set ID to duplicate target_campaign_id: Optional campaign to place the copy in name_suffix: Suffix for the new name new_status: ACTIVE or PAUSED new_daily_budget: Override daily budget in cents new_targeting: Override t...6 params
Duplicate an ad set with its settings. Args: adset_id: Ad set ID to duplicate target_campaign_id: Optional campaign to place the copy in name_suffix: Suffix for the new name new_status: ACTIVE or PAUSED new_daily_budget: Override daily budget in cents new_targeting: Override t...
Parameters* required
adset_idstringnew_statusstringdefault: PAUSED
name_suffixstringdefault: - Copy
new_targetingstringdefault:
new_daily_budgetstringdefault:
target_campaign_idstringdefault:
tool_get_adsGet ads for a Meta Ads account with optional filtering. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) limit: Maximum number of ads to return (default: 10) campaign_id: Optional campaign ID to filter by adset_id: Optional ad set ID to filter by4 params
Get ads for a Meta Ads account with optional filtering. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) limit: Maximum number of ads to return (default: 10) campaign_id: Optional campaign ID to filter by adset_id: Optional ad set ID to filter by
Parameters* required
limitintegerdefault: 10
adset_idstringdefault:
account_idstringcampaign_idstringdefault:
tool_get_ad_detailsGet detailed information about a specific ad. Args: ad_id: Meta Ads ad ID1 params
Get detailed information about a specific ad. Args: ad_id: Meta Ads ad ID
Parameters* required
ad_idstringtool_create_adCreate a new ad with an existing creative. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) name: Ad name adset_id: Ad set ID where this ad will be placed creative_id: ID of an existing creative to use status: Initial status (default: PAUSED) bid_amount: Optional...7 params
Create a new ad with an existing creative. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) name: Ad name adset_id: Ad set ID where this ad will be placed creative_id: ID of an existing creative to use status: Initial status (default: PAUSED) bid_amount: Optional...
Parameters* required
namestringstatusstringdefault: PAUSED
adset_idstringaccount_idstringbid_amountstringdefault:
creative_idstringtracking_specsstringdefault:
tool_update_adUpdate an ad with new settings. Args: ad_id: Meta Ads ad ID status: ACTIVE, PAUSED bid_amount: In cents creative_id: New creative to associate tracking_specs: JSON array of tracking specs5 params
Update an ad with new settings. Args: ad_id: Meta Ads ad ID status: ACTIVE, PAUSED bid_amount: In cents creative_id: New creative to associate tracking_specs: JSON array of tracking specs
Parameters* required
ad_idstringstatusstringdefault:
bid_amountstringdefault:
creative_idstringdefault:
tracking_specsstringdefault:
tool_duplicate_adDuplicate an ad, optionally changing the destination URL. When link_url is provided, the creative is also duplicated with the new URL so the new ad points to a different destination. Args: ad_id: Ad ID to duplicate target_adset_id: Optional ad set to place the copy in name_suf...5 params
Duplicate an ad, optionally changing the destination URL. When link_url is provided, the creative is also duplicated with the new URL so the new ad points to a different destination. Args: ad_id: Ad ID to duplicate target_adset_id: Optional ad set to place the copy in name_suf...
Parameters* required
ad_idstringlink_urlstringdefault:
new_statusstringdefault: PAUSED
name_suffixstringdefault: - Copy
target_adset_idstringdefault:
tool_get_ad_creativesGet creative details for a specific ad. Requires an ad_id. Args: ad_id: Meta Ads ad ID1 params
Get creative details for a specific ad. Requires an ad_id. Args: ad_id: Meta Ads ad ID
Parameters* required
ad_idstringtool_get_creative_detailsGet detailed information about a specific ad creative by its ID. Args: creative_id: Meta Ads creative ID1 params
Get detailed information about a specific ad creative by its ID. Args: creative_id: Meta Ads creative ID
Parameters* required
creative_idstringtool_create_ad_creativeCreate a new ad creative using an uploaded image hash or video ID. Supports simple, dynamic creative, and FLEX (Advantage+) modes. Video thumbnail is auto-fetched from Meta if not provided. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) page_id: Facebook Page ID...20 params
Create a new ad creative using an uploaded image hash or video ID. Supports simple, dynamic creative, and FLEX (Advantage+) modes. Video thumbnail is auto-fetched from Meta if not provided. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) page_id: Facebook Page ID...
Parameters* required
namestringdefault:
messagestringdefault:
page_idstringdefault:
headlinestringdefault:
link_urlstringdefault:
messagesstringdefault:
url_tagsstringdefault:
video_idstringdefault:
headlinesstringdefault:
account_idstringad_formatsstringdefault:
image_hashstringdefault:
descriptionstringdefault:
descriptionsstringdefault:
image_hashesstringdefault:
thumbnail_urlstringdefault:
lead_gen_form_idstringdefault:
instagram_user_idstringdefault:
optimization_typestringdefault:
call_to_action_typestringdefault:
tool_update_ad_creativeUpdate an existing ad creative's name or optimization settings. IMPORTANT: Meta's API does NOT allow updating content (text, images, video, URLs, CTA) on existing creatives. Only the name and optimization_type can be changed. To modify content, use tool_duplicate_creative inst...3 params
Update an existing ad creative's name or optimization settings. IMPORTANT: Meta's API does NOT allow updating content (text, images, video, URLs, CTA) on existing creatives. Only the name and optimization_type can be changed. To modify content, use tool_duplicate_creative inst...
Parameters* required
namestringdefault:
creative_idstringoptimization_typestringdefault:
tool_duplicate_creativeDuplicate a creative, optionally overriding content fields. Args: creative_id: Creative ID to duplicate name_suffix: Suffix for the new name new_primary_text: Override primary text new_headline: Override headline new_description: Override description new_cta_type: Override CTA...7 params
Duplicate a creative, optionally overriding content fields. Args: creative_id: Creative ID to duplicate name_suffix: Suffix for the new name new_primary_text: Override primary text new_headline: Override headline new_description: Override description new_cta_type: Override CTA...
Parameters* required
creative_idstringname_suffixstringdefault: - Copy
new_cta_typestringdefault:
new_headlinestringdefault:
new_descriptionstringdefault:
new_primary_textstringdefault:
new_destination_urlstringdefault:
tool_create_carousel_ad_creativeCreate a carousel ad creative with 2-10 cards. Args: account_id: Meta Ads account ID page_id: Facebook Page ID child_attachments: JSON array of cards, each with link, image_hash/video_id, name, description message: Primary text above the carousel link: Default destination URL...7 params
Create a carousel ad creative with 2-10 cards. Args: account_id: Meta Ads account ID page_id: Facebook Page ID child_attachments: JSON array of cards, each with link, image_hash/video_id, name, description message: Primary text above the carousel link: Default destination URL...
Parameters* required
linkstringdefault:
messagestringdefault:
page_idstringaccount_idstringchild_attachmentsstringinstagram_user_idstringdefault:
call_to_action_typestringdefault:
tool_get_insightsGet performance insights for a campaign, ad set, ad, or account. Args: object_id: ID of the campaign, ad set, ad, or account time_range: Preset (e.g. "last_7d", "last_30d") or JSON {"since":"2025-01-01","until":"2025-01-31"} time_breakdown: Optional: "day", "week", or "month"...7 params
Get performance insights for a campaign, ad set, ad, or account. Args: object_id: ID of the campaign, ad set, ad, or account time_range: Preset (e.g. "last_7d", "last_30d") or JSON {"since":"2025-01-01","until":"2025-01-31"} time_breakdown: Optional: "day", "week", or "month"...
Parameters* required
afterstringdefault:
levelstringdefault: ad
limitintegerdefault: 25
breakdownstringdefault:
object_idstringtime_rangestringdefault: maximum
time_breakdownstringdefault:
tool_bulk_get_insightsFetch performance insights for multiple ad accounts in parallel. Args: level: Aggregation level: account, campaign, adset, ad account_ids: JSON array of account IDs (empty = all accounts) time_range: Preset string or JSON {"since":"...", "until":"..."} time_breakdown: Optional...13 params
Fetch performance insights for multiple ad accounts in parallel. Args: level: Aggregation level: account, campaign, adset, ad account_ids: JSON array of account IDs (empty = all accounts) time_range: Preset string or JSON {"since":"...", "until":"..."} time_breakdown: Optional...
Parameters* required
levelstringdefault: account
limitintegerdefault: 20
fieldsstringdefault:
offsetintegerdefault: 0
compactbooleandefault: false
adset_idsstringdefault:
breakdownstringdefault:
time_rangestringdefault: last_7d
account_idsstringdefault:
campaign_idsstringdefault:
time_breakdownstringdefault:
ad_name_containsstringdefault:
campaign_name_containsstringdefault:
tool_search_interestsSearch for interest targeting options by keyword. Args: query: Search term (e.g. "baseball", "cooking", "travel") limit: Max results (default: 25)2 params
Search for interest targeting options by keyword. Args: query: Search term (e.g. "baseball", "cooking", "travel") limit: Max results (default: 25)
Parameters* required
limitintegerdefault: 25
querystringtool_search_geo_locationsSearch for geographic targeting locations. Args: query: Search term (e.g. "New York", "California", "Japan") location_types: JSON array of types: country, region, city, zip, geo_market limit: Max results (default: 25)3 params
Search for geographic targeting locations. Args: query: Search term (e.g. "New York", "California", "Japan") location_types: JSON array of types: country, region, city, zip, geo_market limit: Max results (default: 25)
Parameters* required
limitintegerdefault: 25
querystringlocation_typesstringdefault:
tool_search_demographicsGet demographic targeting options. Args: demographic_class: demographics, life_events, industries, income, family_statuses, user_device, user_os limit: Max results (default: 50)2 params
Get demographic targeting options. Args: demographic_class: demographics, life_events, industries, income, family_statuses, user_device, user_os limit: Max results (default: 50)
Parameters* required
limitintegerdefault: 50
demographic_classstringdefault: demographics
tool_search_behaviorsGet all available behavior targeting options. Args: limit: Max results (default: 50)1 params
Get all available behavior targeting options. Args: limit: Max results (default: 50)
Parameters* required
limitintegerdefault: 50
tool_get_interest_suggestionsGet interest suggestions based on existing interests. Args: interest_list: JSON array of interest names (e.g. ["Basketball", "Soccer"]) limit: Max suggestions (default: 25)2 params
Get interest suggestions based on existing interests. Args: interest_list: JSON array of interest names (e.g. ["Basketball", "Soccer"]) limit: Max suggestions (default: 25)
Parameters* required
limitintegerdefault: 25
interest_liststringtool_estimate_audience_sizeEstimate audience size for targeting specifications. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) targeting: JSON string of targeting specs optimization_goal: REACH, LINK_CLICKS, IMPRESSIONS, CONVERSIONS3 params
Estimate audience size for targeting specifications. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) targeting: JSON string of targeting specs optimization_goal: REACH, LINK_CLICKS, IMPRESSIONS, CONVERSIONS
Parameters* required
targetingstringaccount_idstringoptimization_goalstringdefault: REACH
tool_upload_ad_imageUpload an image to use in Meta Ads creatives. Returns an image_hash. Accepts EITHER: • image_url — any publicly-accessible URL (e.g. from an image-generation API like DALL-E, Flux, a CDN link, or an AdWeave creative URL). The image is downloaded and uploaded to Meta. • file_pa...4 params
Upload an image to use in Meta Ads creatives. Returns an image_hash. Accepts EITHER: • image_url — any publicly-accessible URL (e.g. from an image-generation API like DALL-E, Flux, a CDN link, or an AdWeave creative URL). The image is downloaded and uploaded to Meta. • file_pa...
Parameters* required
namestringdefault:
file_pathstringdefault:
image_urlstringdefault:
account_idstringtool_upload_ad_videoUpload a video to a Meta Ads account. Accepts EITHER: • video_url — publicly accessible URL. Meta fetches it directly. • file_path — absolute path to a local video file on disk. The file is staged to Supabase Storage first, then uploaded to Meta. Args: account_id: Meta Ads acc...6 params
Upload a video to a Meta Ads account. Accepts EITHER: • video_url — publicly accessible URL. Meta fetches it directly. • file_path — absolute path to a local video file on disk. The file is staged to Supabase Storage first, then uploaded to Meta. Args: account_id: Meta Ads acc...
Parameters* required
namestringdefault:
titlestringdefault:
file_pathstringdefault:
video_urlstringdefault:
account_idstringdescriptionstringdefault:
tool_get_ad_imageGet the image URL for a specific ad. Args: ad_id: Meta Ads ad ID1 params
Get the image URL for a specific ad. Args: ad_id: Meta Ads ad ID
Parameters* required
ad_idstringtool_bulk_upload_ad_imagesUpload multiple images to Meta Ads accounts. Args: items: JSON array, each: {"account_id": "act_XXX", "image_url": "https://...", "name": "optional"} OR: {"account_id": "act_XXX", "file_path": "/path/to/image.jpg", "name": "optional"}1 params
Upload multiple images to Meta Ads accounts. Args: items: JSON array, each: {"account_id": "act_XXX", "image_url": "https://...", "name": "optional"} OR: {"account_id": "act_XXX", "file_path": "/path/to/image.jpg", "name": "optional"}
Parameters* required
itemsstringtool_bulk_upload_ad_videosUpload multiple videos to Meta Ads accounts. Args: items: JSON array, each: {"account_id": "act_XXX", "video_url": "https://...", "title": "optional"} OR: {"account_id": "act_XXX", "file_path": "/path/to/video.mp4", "title": "optional"}1 params
Upload multiple videos to Meta Ads accounts. Args: items: JSON array, each: {"account_id": "act_XXX", "video_url": "https://...", "title": "optional"} OR: {"account_id": "act_XXX", "file_path": "/path/to/video.mp4", "title": "optional"}
Parameters* required
itemsstringtool_bulk_update_campaignsUpdate multiple campaigns with individual or uniform parameters. Mode 1 (explicit): Provide campaign_updates JSON array. Mode 2 (filter): Provide filter_criteria + updates JSON objects. Args: account_id: Meta Ads account ID campaign_updates: JSON array of per-campaign update s...6 params
Update multiple campaigns with individual or uniform parameters. Mode 1 (explicit): Provide campaign_updates JSON array. Mode 2 (filter): Provide filter_criteria + updates JSON objects. Args: account_id: Meta Ads account ID campaign_updates: JSON array of per-campaign update s...
Parameters* required
limitintegerdefault: 20
dry_runbooleandefault: false
updatesstringdefault:
account_idstringfilter_criteriastringdefault:
campaign_updatesstringdefault:
tool_bulk_update_adsetsUpdate multiple ad sets with individual or uniform parameters. Args: account_id: Meta Ads account ID adset_updates: JSON array of per-adset update specs filter_criteria: JSON object with status, campaign_id, name_contains, adset_ids updates: JSON object with uniform updates to...6 params
Update multiple ad sets with individual or uniform parameters. Args: account_id: Meta Ads account ID adset_updates: JSON array of per-adset update specs filter_criteria: JSON object with status, campaign_id, name_contains, adset_ids updates: JSON object with uniform updates to...
Parameters* required
limitintegerdefault: 20
dry_runbooleandefault: false
updatesstringdefault:
account_idstringadset_updatesstringdefault:
filter_criteriastringdefault:
tool_bulk_update_adsUpdate multiple ads with individual or uniform parameters. Args: account_id: Meta Ads account ID ad_updates: JSON array of per-ad update specs filter_criteria: JSON object with status, campaign_id, adset_id, name_contains, ad_ids updates: JSON object with uniform updates to ap...6 params
Update multiple ads with individual or uniform parameters. Args: account_id: Meta Ads account ID ad_updates: JSON array of per-ad update specs filter_criteria: JSON object with status, campaign_id, adset_id, name_contains, ad_ids updates: JSON object with uniform updates to ap...
Parameters* required
limitintegerdefault: 20
dry_runbooleandefault: false
updatesstringdefault:
account_idstringad_updatesstringdefault:
filter_criteriastringdefault:
tool_searchSearch through Meta Ads data and return matching records. Args: query: Search query string1 params
Search through Meta Ads data and return matching records. Args: query: Search query string
Parameters* required
querystringtool_fetchFetch complete record data by ID. Args: record_id: Format "type:id" (e.g. "account:act_123", "campaign:12345")1 params
Fetch complete record data by ID. Args: record_id: Format "type:id" (e.g. "account:act_123", "campaign:12345")
Parameters* required
record_idstringtool_search_pages_by_nameSearch for pages by name within an account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) search_term: Optional name filter2 params
Search for pages by name within an account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX) search_term: Optional name filter
Parameters* required
account_idstringsearch_termstringdefault:
tool_get_instagram_accountsGet Instagram business accounts associated with an ad account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX)1 params
Get Instagram business accounts associated with an ad account. Args: account_id: Meta Ads account ID (format: act_XXXXXXXXX)
Parameters* required
account_idstringtool_create_budget_scheduleCreate a budget schedule for a campaign. Args: campaign_id: Meta Ads campaign ID budget_value: Amount of budget increase budget_value_type: ABSOLUTE or MULTIPLIER time_start: Unix timestamp for start time_end: Unix timestamp for end5 params
Create a budget schedule for a campaign. Args: campaign_id: Meta Ads campaign ID budget_value: Amount of budget increase budget_value_type: ABSOLUTE or MULTIPLIER time_start: Unix timestamp for start time_end: Unix timestamp for end
Parameters* required
time_endintegertime_startintegercampaign_idstringbudget_valuenumberbudget_value_typestringtool_create_email_reportCreate an email report for ad performance. Args: account_id: Meta Ads account ID cadence: once, daily, or weekly emails: JSON array of recipient emails time_range: Time period for the report4 params
Create an email report for ad performance. Args: account_id: Meta Ads account ID cadence: once, daily, or weekly emails: JSON array of recipient emails time_range: Time period for the report
Parameters* required
emailsstringdefault:
cadencestringdefault: once
account_idstringtime_rangestringdefault: last_7d
tool_get_partnership_accountsList all creators with partnership ad access for a brand IG account. Returns approved, pending, and revoked partnerships with creator usernames. Args: brand_ig_id: The brand's Instagram Business Account ID1 params
List all creators with partnership ad access for a brand IG account. Returns approved, pending, and revoked partnerships with creator usernames. Args: brand_ig_id: The brand's Instagram Business Account ID
Parameters* required
brand_ig_idstringtool_get_creator_mediaFetch posts/reels from a creator's Instagram account. Requires approved partnership ad access to the creator's account. Args: creator_ig_id: The creator's Instagram user ID limit: Max number of posts to return (default 25) media_type: Filter by type: IMAGE, VIDEO, CAROUSEL_ALB...3 params
Fetch posts/reels from a creator's Instagram account. Requires approved partnership ad access to the creator's account. Args: creator_ig_id: The creator's Instagram user ID limit: Max number of posts to return (default 25) media_type: Filter by type: IMAGE, VIDEO, CAROUSEL_ALB...
Parameters* required
limitintegerdefault: 25
media_typestringdefault:
creator_ig_idstringtool_get_creator_media_insightsGet engagement stats for a specific creator post. Returns impressions, reach, likes, comments, shares, saves, plays. Args: media_id: The Instagram media/post ID1 params
Get engagement stats for a specific creator post. Returns impressions, reach, likes, comments, shares, saves, plays. Args: media_id: The Instagram media/post ID
Parameters* required
media_idstringtool_create_ad_from_partnership_codeCreate a partnership ad from a creator's ad code string (e.g. adcode-Q9jTBB...). Use this when a creator has shared an ad code. The code encodes the creator's content and permissions, so no creator IG ID or media ID is needed. Args: account_id: Ad account ID name: Ad name (e.g...6 params
Create a partnership ad from a creator's ad code string (e.g. adcode-Q9jTBB...). Use this when a creator has shared an ad code. The code encodes the creator's content and permissions, so no creator IG ID or media ID is needed. Args: account_id: Ad account ID name: Ad name (e.g...
Parameters* required
namestringstatusstringdefault: PAUSED
page_idstringadset_idstringaccount_idstringpartnership_ad_codestringFeatured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
