DataLatte☕
Meta Ads MCP and CLI: What AI Agents Can Do (2026)
Marketing Strategy

Meta Ads MCP and CLI: What AI Agents Can Do (2026)

November 17, 2026·Nataliia Rumiantsewa· 10 min read All posts
Meta now offers two official ways for an AI agent to run Facebook and Instagram ads: a hosted MCP server and a command-line tool called Ads CLI. Both can create campaigns, ad sets and ads, pull performance reports and manage catalogs. Both create new ads as paused, so nothing spends until a separate activation step.
This guide reads Meta's own documentation: what each tool does, how access works, where write access can hurt a small budget and a 5-step setup that keeps control with the owner. Budget figures in the worked example are labelled assumptions.
7→

Tool categories in Meta's ads MCP server

Meta for Developers

3→

Ways to authenticate with the MCP server

Meta for Developers

PAUSED→

Default status of ads created by the Ads CLI

Meta for Developers

3.12+→

Python version the Ads CLI needs

Meta for Developers

Source: Meta for Developers, checked 17 November 2026

What Are Meta's Ads MCP Server and Ads CLI?

The ads MCP server is a Meta-hosted Model Context Protocol server. It lets an AI assistant manage Meta ads through chat, and it works with any MCP-compatible agent at https://mcp.facebook.com/ads. Meta calls it one of its ads AI connectors, a family of integrations that expose business surfaces through permission-scoped tools.
Ads CLI was announced on 29 April 2026 as a command-line tool for the Meta Marketing API. Meta's blog says developers and AI agents can create, edit and analyze campaigns from the terminal without writing custom code. Commands follow a noun-verb pattern, such as campaign list or insights get.
PAUSED

The status of campaigns, ad sets and ads created by Meta's write tools. Going live is a separate step: ads_activate_entity changes a paused item to active, which starts spending budget.

Meta for Developers: Ads MCP server, ad creation and management, checked 17 November 2026

For background on MCP itself, see what MCP is in plain words. For how other ad platforms compare, see the AI agent ad buying guide.

What Can an AI Agent Do With Them?

Meta groups the MCP server's tools into seven categories. Meta's documentation describes each in one line.
CategoryWhat the server can do
Comprehensive reportingPull detailed reports on campaign performance
Ad creation and managementCreate and edit ads, ad sets and campaigns
Catalog creation and managementCreate catalogs, add product data, troubleshoot feeds
Signals and datasetsShow signal health and quality information
Help and troubleshootingSearch Meta Business Help Center articles
A/B tests and conversion lift studiesCreate and manage tests and studies
Activity logsShow account changes, mirroring the Ads Manager campaign history page
Under ad creation, the tool list is specific. Separate tools create a campaign, an ad set and an ad, update an entity, activate an entity, create a creative and preview an ad in Feed, Story or Reels placements. Others list Instagram posts eligible for boosting, boost one, and search the public Meta Ad Library.
Audience tools can create, update and delete custom audiences, including adding or removing users from a customer list by uploading hashed data. Delete tools exist, so write access is broader than campaign drafting.
Ads CLI covers the same hierarchy. Campaigns, ad sets, ads and creatives each support list, create, get, update and delete. It also handles insights, product catalogs, product feeds and datasets (Pixels), plus ad accounts, Pages, recommendations and ad studies.

How Do You Connect Them?

The MCP server supports three authentication methods. OAuth opens a Facebook Login for Business dialog, where a person signs in with a Facebook account or a Meta Managed Account and approves permissions. A user access token and a system user access token are the other two, meant for programmatic setups.
Meta states one restriction: only Employee-role system user tokens work. Admin-role system user tokens cannot access the ads MCP server. At a minimum a token needs ads_mcp_management and either ads_read or ads_management. More permissions unlock more tools: catalog_management, business_management, pages_show_list and instagram_basic.
Meta's page shows the Claude Code connection as one command:
claude mcp add --transport http --client-id YOUR_META_APP_ID meta-ads https://mcp.facebook.com/ads
Meta also says owning a Meta app is not required to use the server, and points to a separate page, How to set up Meta ads AI connectors, for that route. The pages opened for this article do not say whether every ad account has access, so run a read-only prompt first, such as listing the ad accounts.
Ads CLI needs Python 3.12 or newer and pip or uv. It authenticates with a Meta system user access token and reads secrets from environment variables. Output comes as table, JSON or tab-separated plain text, and exit codes run from 0 to 5 for scripts.

MCP or CLI: Which Fits a Local Business?

Meta describes the audiences differently. The MCP server is for advertisers who want to manage ads through a chat interface instead of Ads Manager or code, and for developers building AI-native ad workflows. Ads CLI is for developers, operations teams running scripts and CI pipelines, and AI agents using a command line.
For a café, salon or clinic owner, the MCP route is closer to normal use: connect once, then ask for a summary of last month's spend. The CLI suits a freelancer or agency that wants repeatable scripts, such as a weekly report across several accounts.
Neither replaces judgement. Meta's pages do not claim better results from either tool, only a different interface to the same Marketing API. Pick the one the person running it already understands.

What Can Go Wrong With Write Access?

Four risks come straight from the documentation.
Activation spends money. Meta says ads_activate_entity starts spending budget, and that the AI client asks for confirmation before activation. Confirmation behaviour belongs to the client, so check how your assistant shows the prompt before connecting an account that holds a real card.
Budget units are easy to misread. Meta's blog example creates a campaign with a daily budget of 5000 and comments that this means a 50.00 budget, with the currency set on the ad account. The number entered is 100 times the displayed amount in that example.
Deleting is possible. Ads CLI supports delete for campaigns, ad sets, ads and creatives, and the MCP server has a tool that deletes custom audiences. A wrong prompt can remove something that took hours to build.
Look-alike names exist. Directories list many community servers called Meta Ads MCP. Only the server at mcp.facebook.com/ads is Meta's own. Third-party servers carry their own permissions and terms.
The activity log tool helps after the fact, because it mirrors the Ads Manager campaign history. Reviewing it weekly shows what an assistant changed.

What Is a Safe Setup for a Local Business?

  1. Start read-only. Request ads_mcp_management with ads_read, not ads_management, and run reporting prompts for two weeks. A summary of top-spending campaigns over 30 days is one of Meta's own first-prompt examples.
  2. Use a separate login. Connect through OAuth with a person who has limited access, or an Employee-role system user. Keep the Admin role out of automation.
  3. Cap spend outside the assistant. Set an ad account spending limit in Ads Manager. Meta's Business Help Center has a page titled Change your Ad Account Spending Limit; the page text did not render when checked, so read it in your account.
  4. Keep the paused default. Review every new campaign in Ads Manager, preview the creative, check the budget unit and only then activate.
  5. Audit weekly. Compare the activity log with what was asked for.
Assumption example. A café plans $15 a day, or $450 over 30 days. If a value is entered 100 times too high, the daily budget reads $1,500. At that rate the planned monthly budget would be spent in about 7 hours. Steps 3 and 4 exist to stop that case.
For the Meta features that matter once ads run, see the Meta Advantage+ guide for local business and the October 2026 Meta ads delivery update. Setup help for other tools sits in the MCP servers guide for local business.

FAQ

Is the Meta ads MCP server free to use?

Meta's documentation pages opened for this article do not list a fee for the server. Ad spend is charged as usual by Meta. Check Meta's current terms before connecting a paid workflow, because third-party connectors may charge separately.

Can an AI agent spend money without approval?

New campaigns, ad sets and ads are created paused, and activation is a separate tool. Meta says the AI client asks for confirmation first. That prompt depends on the client, so test it with a campaign on a low-risk account.

Do I need to code to use Meta's ads MCP server?

No for chat clients: Meta lists OAuth sign-in with no manual token setup. Code is needed only for the user token and system user token routes, or for Ads CLI, which runs in a terminal.

Which permissions does the MCP server need?

At minimum ads_mcp_management and either ads_read or ads_management. Extra tools need ads_management, catalog_management, business_management, pages_show_list or instagram_basic. Grant only what the task needs.

Is Ads CLI better than the MCP server?

Meta does not rank them. Ads CLI is built for scripts, pipelines and agents using a terminal. The MCP server is built for chat clients and AI-native workflows. Choose by who runs the work, not by claimed performance.

Sources

Want an agent connected to your ad account with the limits above in place? See the Meta Ads service or book a free audit.

Free for local businesses

Want this applied to your business?

I'll review your Google presence, local SEO, and ad accounts — and send you a specific action plan within 48 hours. No pitch, no pressure.

meta adsmcpai agentsads clilocal business advertising

Want hands-on help?

See how DataLatte handles Analytics & Reporting for local businesses.

Learn more
Nataliia — local marketing expert
Nataliia Rumiantsewa

Local marketing strategist with 10+ years at global agencies — OMD, Dentsu, GroupM, and BBDO. Now helping small businesses get the same data-driven edge. Based in Europe, working with clients in the US, UK, Australia, and beyond.

Want this applied to your business?

Let's review your current marketing setup together — free, no obligations.

Get Your Free Marketing Audit