Meta Ads Connector
meta_ads_connectorRead-onlyIdempotent
Facebook and Instagram advertising: campaigns, ad sets, ads, account-level spend, impressions, clicks, CPM, CPC, CTR, ROAS, and audience insights. When the user asks for a visual, trend, comparison, or recap, call chart_render with the numeric values returned by this connector. If the connector result includes a verified chart_provenance token, the same authenticated user may pass it as provenance_token within 15 minutes, on any replica, and map every value to its exact source_path so chart_render preserves verified provenance. Without a valid connector receipt, chart_render labels values as unverified_model_data. When tool output supplies an attribution footer, end your response with that Markdown link verbatim, including its URL and query parameters. Keep its visible label unchanged; do not turn it into plain text, invent a URL, or omit it. Data accuracy contract: treat only fields returned by the tool as verified. Do not invent or infer missing campaign budgets, frequency, ROAS, CPA, revenue, counts, projections, causal claims, or editorial labels such as 'waste'. Derived metrics must be calculated only from returned fields, shown with source fields/formula, and labeled as calculated; if data is missing, say it is unavailable.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | get_facebook_account: Get the authenticated Facebook user's profile (id, name, and email when Meta supplies it). Email may be null because the | get_facebook_account_insights: Get account-level Facebook Ads performance summary: impressions, clicks, spend, reach, frequency, CPM, CPC, CTR, convers | list_facebook_campaigns: List Facebook/Meta ad campaigns with status, objective, budget, and dates. Campaigns are hierarchy metadata, not ads or | get_facebook_campaign_insights: Get performance metrics for a specific Facebook campaign: impressions, clicks, spend, reach, CPM, CPC, CTR, and conversi | list_facebook_ad_accounts: List all Facebook/Meta ad accounts accessible to the authenticated user. Returns account IDs, names, status, currency, a | get_facebook_ad_account: Get detailed information about the connected Facebook ad account: name, status, currency, timezone, total spend, balance | get_facebook_campaign: Get full details for a single Facebook campaign: objective, bid strategy, budget, schedule, and special ad categories | list_facebook_ad_sets: List Facebook ad sets with budget, targeting summary, and optimization goal. Optionally filter by campaign | get_facebook_ad_set: Get full details for a single Facebook ad set: targeting rules, optimization goal, bid strategy, and promoted object | list_facebook_ads: List individual Facebook ads with available top-level attached creative preview fields (title, body, image, thumbnail, U | get_facebook_campaign_insights_daily: Get daily performance breakdown for a Facebook campaign: day-by-day impressions, clicks, spend, reach, CPM, CPC, and CTR | get_facebook_age_gender_insights: Get Facebook Ads performance breakdown by age range and gender | get_facebook_geographic_insights: Get Facebook Ads performance breakdown by country | get_facebook_device_platform_insights: Get Facebook Ads performance breakdown by device and publisher platform | get_facebook_placement_insights: Get Facebook Ads performance breakdown by ad placement and publisher platform | list_facebook_pages: List Facebook Pages the authenticated user manages. Returns Page id, name, category, fan_count, link, and the permitted_ | list_facebook_page_posts: List recent posts on a Facebook Page. Returns post id, message, created_time, permalink, and attachments | get_facebook_post_insights: Get organic insights for a Facebook Page post: impressions, unique reach, engaged users, clicks, and reactions by type. | get_facebook_post_comments: Get comments on a Facebook Page post: author, message, created_time, like_count, and reply count | list_facebook_leadgen_forms: List Lead Ads forms on a Facebook Page. Returns form id, name, status, locale, created_time, leads_count, expired_leads_ | list_facebook_leads: List leads captured by a Lead Ads form: lead id, created_time, ad/adset/campaign attribution, organic flag, platform, an | list_instagram_business_accounts: List Instagram Business/Creator accounts linked to the user's Facebook Pages. Returns ig_account_id, username, followers | list_instagram_media: List recent media (posts/reels/stories) on an Instagram Business account. Returns media id, caption, media_type, permali | get_instagram_media_insights: Get insights for an Instagram Business media item: impressions, reach, engagement, saves. Requires instagram_manage_insi | get_instagram_account_insights: Get account-level Instagram Business insights. Supports both engagement-style metrics (reach, profile_views, accounts_en | get_instagram_comments: Get comments on an Instagram Business media item. Returns comment id, text, username, timestamp, like_count, and replies | |
| params | No | Action-specific parameters. get_facebook_account: none | get_facebook_account_insights: {start_date?: string, end_date?: string, date_preset?: string, account_id?: string} | list_facebook_campaigns: {limit?: integer, status_filter?: string, after?: string, account_id?: string} | get_facebook_campaign_insights: {campaign_id: string, start_date?: string, end_date?: string, date_preset?: string} | list_facebook_ad_accounts: none | get_facebook_ad_account: {account_id?: string} | get_facebook_campaign: {campaign_id: string} | list_facebook_ad_sets: {limit?: integer, campaign_id?: string, status_filter?: string, after?: string, account_id?: string} | get_facebook_ad_set: {ad_set_id: string} | list_facebook_ads: {limit?: integer, campaign_id?: string, ad_set_id?: string, status_filter?: string, after?: string, account_id?: string} | get_facebook_campaign_insights_daily: {campaign_id: string, start_date?: string, end_date?: string, date_preset?: string} | get_facebook_age_gender_insights: {start_date?: string, end_date?: string, date_preset?: string, campaign_id?: string, account_id?: string} | get_facebook_geographic_insights: {start_date?: string, end_date?: string, date_preset?: string, campaign_id?: string, account_id?: string} | get_facebook_device_platform_insights: {start_date?: string, end_date?: string, date_preset?: string, campaign_id?: string, account_id?: string} | get_facebook_placement_insights: {start_date?: string, end_date?: string, date_preset?: string, campaign_id?: string, account_id?: string} | list_facebook_pages: none | list_facebook_page_posts: {page_id: string, limit?: integer, since?: string, until?: string} | get_facebook_post_insights: {post_id: string, metrics?: array} | get_facebook_post_comments: {post_id: string, limit?: integer} | list_facebook_leadgen_forms: {page_id: string, limit?: integer} | list_facebook_leads: {form_id: string, limit?: integer} | list_instagram_business_accounts: none | list_instagram_media: {ig_account_id: string, limit?: integer, since?: string, until?: string} | get_instagram_media_insights: {media_id: string, metrics?: array} | get_instagram_account_insights: {ig_account_id: string, metrics?: array, period?: string, since?: integer, until?: integer} | get_instagram_comments: {media_id: string, limit?: integer} |