Get started
Updated: Jul 14, 2026
Copy for LLM
Owning a Meta app is not a prerequisite on using the ads MCP server. For access without owning a Meta app, follow How to set up Meta ads AI connectors instead.
To use the ads MCP server with your own Meta app, you must follow some key steps to set up your environment and gain access.
Create or reuse a Meta developer app
- Go to developers.facebook.com/apps and create a new app, or open an existing app.
- Add the Create & manage ads with ads MCP server use case.
Authentication
The ads MCP server supports two authentication methods.
OAuth
The MCP client redirects you to the Facebook Login for Business dialog. You sign in with your Facebook account or your Meta Managed Account (MMA) and approve the requested permissions. No manual token setup is required.
Make sure your Meta developer app’s redirect URL is configured correspondingly with your choice of MCP client in the Facebook Login for Business settings.
User access token
To generate a token, use the Graph API Explorer or your own OAuth flow. Grant the following permissions when requesting the token:
ads_mcp_managementads_readads_managementcatalog_managementbusiness_managementpages_show_listinstagram_basic
Connect to ads MCP server
Sever URL of the ads MCP server
https://mcp.facebook.com/ads
Connect to the ads MCP server from Claude Code
To add the ads MCP server to Claude Code, run the command below.
claude mcp add --transport http --client-id <META_APP_ID> meta-ads https://mcp.facebook.com/ads
Connect to the ads MCP server from ChatGPT
Set the redirect URL of your Meta developer app according to ChatGPT’s specification.
Follow ChatGPT instruction:
- Select “OAuth” as Authentication method
- Input https://mcp.facebook.com/ads as the Server URL
- In Advanced OAuth Settings, input your Meta developer app ID as the OAuth Client ID.
Connect to the ads MCP server with user access token
For programmatic setups, pass an user access token to in the request to the ads MCP server in the
Authorization: Bearer <ACCESS_TOKEN> header.curl -i -X POST "https://mcp.facebook.com/ads" \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
--data-raw '{"jsonrpc":"2.0","method":"tools/list","id":1}'
Run your first prompts
Once connected, try:
- “List my ad accounts.”
- “Create a new traffic campaign in ad account
<AD_ACCOUNT_ID>.” - “Draft an ad set for my
<CAMPAIGN_ID>campaign that optimizes for link clicks.” - “Summarize the top-spending campaigns in
<AD_ACCOUNT_ID>over the last 30 days.”