Connect the Meta Ads API
Integrate the Meta Ads API through Modiva’s unified REST API and hosted MCP server. Plan, launch and report on Facebook & Instagram ad campaigns. OAuth, token refresh, rate limits and 12 typed tools are handled for you — connect once and call Meta Ads from any agent or app through a single endpoint.
What you can do with the Meta Ads API
- ✓ Campaign management
- ✓ Reporting
- ✓ Audiences
- ✓ Creative upload
- — Webhooks (Most ad APIs are poll-based)
Meta Ads MCP tools & scopes
- accounts_
- list · health · status
- ads_campaigns
- list · create · pause · resume
- ads_reporting
- spend · conversions · roas
- analytics_
- unified · breakdown
OAuth scopes requested
- Read ad accounts
- Create & manage campaigns
- Read spend & conversion reporting
Connect Meta Ads in your agent
# Add Modiva's MCP server to your agent
{
"mcpServers": {
"modiva": {
"url": "https://mcp.modiva.ai",
"headers": { "Authorization": "Bearer $MODIVA_MCP_KEY" }
}
}
}
# Then connect Meta Ads and call its tools, e.g.
accounts_list(provider="meta-ads")Frequently asked questions
How do I connect the Meta Ads API with Modiva?
Create a Modiva account, generate an MCP key, and connect Meta Ads from your dashboard. Modiva runs the full OAuth flow and stores the encrypted token for you — no client secrets in your code.
What can I do with the Meta Ads API through Modiva?
Plan, launch and report on Facebook & Instagram ad campaigns. You get 12 typed tools grouped by resource (accounts_, ads_campaigns, ads_reporting, analytics_), callable over REST or the MCP server.
Do I need to handle OAuth or token refresh myself?
No. Modiva handles the Meta Ads OAuth handshake, token storage (envelope-encrypted) and automatic refresh. You call a single unified endpoint.
Can an AI agent use the Meta Ads API?
Yes — that is the point. Modiva exposes Meta Ads as Model Context Protocol (MCP) tools, so agents like Claude, Cursor or your own app can read and act on Meta Ads through one endpoint.