facebook-ads-readonly
Read Facebook ad accounts, campaigns, ad sets, ads, creatives, and detailed Ads Insights through the Meta Marketing API.
Connect this API to an AI agent Browse all specs
What you can do with facebook-ads-readonly via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /me/adaccounts |
listFacebookAdAccounts | List ad accounts available to the connected Facebook user |
| GET | /act_{adAccountId} |
getFacebookAdAccount | Get detailed ad account information |
| GET | /act_{adAccountId}/campaigns |
listFacebookAdCampaigns | List campaigns in an ad account |
| GET | /act_{adAccountId}/adsets |
listFacebookAdSets | List ad sets with budget, optimization, schedule, and targeting |
| GET | /act_{adAccountId}/ads |
listFacebookAds | List ads with creative and tracking details |
| GET | /{adId} |
getFacebookAd | Get one ad with detailed creative and tracking configuration |
| GET | /act_{adAccountId}/adcreatives |
listFacebookAdCreatives | List detailed creative assets in an ad account |
| GET | /act_{adAccountId}/insights |
getFacebookAdAccountInsights | Get detailed Ads Insights for an ad account |
| GET | /{objectId}/insights |
getFacebookAdObjectInsights | Get Insights for one campaign, ad set, or ad |
Authentication
FacebookAdsOAuth2
OAuth 2.0
Scopes: ads_read
Facebook Login OAuth2 for read-only Marketing API access. Meta's web authorization code flow does not use PKCE in this template.
Usage guide
Connect a Facebook account through OAuth2 with the ads_read permission. This template is read-only and contains GET operations only. It cannot create, update, delete, publish, pause, or spend advertising money.
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “facebook-ads-readonly” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.