Recommended
For a personOAuth 2.1 in the browser
Claude, ChatGPT, Cursor and Claude Code open a sign-in window. You approve, the client keeps the token, and nothing is pasted.
The Meta ads MCP server for AI agents.
Find the ads that pay, and launch the next one paused. Claude, ChatGPT, Cursor or any MCP client gets 88 tools for your ad account.
7 days free with every feature. Cancel anytime.
https://winandscale.com/api/mcp- Sign in with OAuth 2.1 in the browser. A headless agent sends an
rsk_API key as a Bearer instead. - Server card winandscale.com/.well-known/mcp/server-card.json
What is the Win & Scale MCP server?
Win & Scale is a Meta ads MCP server for AI agents. Claude, ChatGPT, Cursor or any MCP client reads your ad account, briefs the next test, and launches every ad paused. Every dashboard action is also a meta_* tool.
How do I add the Meta ads MCP server to my agent?
Paste one URL into your client and approve the sign-in in the browser. No key and no config file to keep secret.
Claude Code
One command adds the server. Run /mcp afterwards and approve the sign-in in the browser.
Terminalclaude mcp add --transport http winandscale https://winandscale.com/api/mcpClaude and ChatGPT
Claude: Customize, then Connectors, then Add custom connector. ChatGPT: a developer-mode app with OAuth. Both take the URL as is.
MCP server URLhttps://winandscale.com/api/mcpCursor
Add the server to your MCP config. The file holds no credential, so it is safe to commit. Each person signs in as themselves.
~/.cursor/mcp.json{ "mcpServers": { "winandscale": { "url": "https://winandscale.com/api/mcp" } } }Any MCP client
Register a streamable HTTP server with the URL above. The client discovers OAuth 2.1 on its own. The agent guides cover every client.
What can an agent do with the Win & Scale MCP server?
Each tool is badged read-only, write, or needs approval. Your agent can read everything, and anything that spends waits for you.
Read
36 toolsWhat ran, what each creative is, and what it bought.
- Read-only
meta_get_overviewAccount totals, the funnel and the top ads for a window. - Read-only
meta_get_ad_performancePer-ad spend, results and cost for a period. - Read-only
meta_suggest_nextCut, keep, double down or watch: a verdict on every live ad. - Read-only
meta_get_evidence_healthWhether the data is fit to judge anything yet. - Read-only
meta_get_history_winnersWhat wins and loses across the account's whole history. - Read-only
meta_get_strategy_rollupSpend and results per angle, persona, format and offer.
+30 more read toolsShow fewer
- Read-only
meta_get_performance_cubeGroup and cross performance on any dimension. - Read-only
meta_get_cross_analysisTwo dimensions against each other inside one funnel. - Read-only
meta_get_breakdownsPlacement, age and gender, or video retention, read live from Meta. - Read-only
meta_get_audience_breakdownWho responds to each Value, by age, gender or placement. - Read-only
meta_get_account_historyEverything that ever ran on the account, with its copy. - Read-only
meta_list_campaignsCampaigns and ad sets with their status and objective. - Read-only
meta_list_creativesThe library's creatives, with Values and lifetime results. - Read-only
meta_get_creativeOne creative to look at: its image, tags and transcript. - Read-only
meta_list_taxonomyThe creative taxonomy and the workspace's Values. - Write
meta_set_creative_linksSet a creative's Values by hand. - Write
meta_tag_creativesTag many creatives at once by Value name. - Write
meta_update_creativeRename and re-tag one library upload. - Write
meta_create_taxonomy_valueAdd a persona, angle, offer or other Value. - Write
meta_update_taxonomy_valueRename, describe, approve or archive a Value. - Write
meta_merge_taxonomy_valuesFold two names for one idea into one. - Write
meta_answer_merge_suggestionMerge or keep apart a pair the reconcile pass flagged. - Write
meta_transcribe_creativeRead a video's transcript now, or retry one. - Write
meta_delete_creativesDelete library uploads that never became an ad. - Read-only
meta_list_report_viewsSaved views of the Ads report, and the templates. - Read-only
meta_get_report_viewOpen a report view and read its rows. - Write
meta_save_report_viewSave an Ads report as a named view. - Write
meta_set_thresholdsSet the goal event, targets and the funnel the account is judged on. - Read-only
meta_get_workspaceWhich workspace and ad account this session is on. - Read-only
meta_list_workspacesEvery workspace you belong to. - Write
meta_switch_workspaceMove the session to another workspace. - Write
meta_sync_nowPull the latest insights and ads from Meta. - Write
meta_backfill_insightsFill the daily warehouse back in time. - Write
meta_pull_account_historyPull every ad's lifetime insights and creative. - Write
meta_pull_account_defaultsRead audience and link defaults from the best recent campaign. - Read-only
meta_get_api_usageThis hour's Meta API quota.
Research
16 toolsCustomer language, competitors' ads and the brand's own strategy.
- Read-only
meta_search_ad_librarySearch the Meta Ad Library by keyword or advertiser. - Read-only
meta_list_swipesThe swipe file: saved reference ads. - Write
meta_save_swipeSave a reference ad from a link. - Write
meta_update_swipeReplace a swipe's tags or note. - Read-only
meta_get_recipeThe layout, copy and swappable slots of one static. - Read-only
meta_list_personasWho the ads speak to, with pains and desires.
+10 more research toolsShow fewer
- Read-only
meta_list_anglesWhat the ads argue: promise, mechanism, pain. - Read-only
meta_list_formatsReusable creative shapes from the swipe file and library. - Read-only
meta_list_verbatimsCustomer quotes, exactly as written. - Write
meta_link_verbatimsFile quotes under a persona or an angle. - Read-only
meta_list_research_sourcesEvery research source and what it has fed. - Write
meta_add_research_sourceAdd reviews, a page or pasted text as research. - Write
meta_refresh_research_sourceFetch a source again for new material. - Write
meta_delete_research_sourceRemove a source and everything mined from it. - Read-only
meta_get_strategyThe workspace's brand and strategy: offer, pains, voice, proof. - Write
meta_update_strategyChange the brand and strategy.
Make
23 toolsBrief the next test, write the copy, draft the creative, and keep what you learn.
- Read-only
meta_list_briefsThe Briefs board. - Read-only
meta_get_briefOne brief in full. - Write
meta_save_briefPut one brief on the board as a draft. - Write
meta_save_briefsBrief the next tests from the account's own winners. - Write
meta_update_briefChange a brief's fields, status or links. - Read-only
meta_list_testsCommitted tests and where they stand.
+17 more make toolsShow fewer
- Read-only
meta_get_testOne test: its frozen question, links and observations. - Write
meta_create_testCommit to a next test; its question is frozen. - Write
meta_link_test_artifactsTie drafts, uploads and ads to a test. - Write
meta_observe_testRecord how a test is doing now, append-only. - Write
meta_conclude_testRecord a test's conclusion, once. - Write
meta_abandon_testStop a test without a conclusion. - Read-only
meta_list_learningsThe account's learnings: why something works here. - Read-only
meta_get_learningOne learning with its evidence and history. - Write
meta_save_learningRecord a learning. - Write
meta_update_learningChange or retire a learning. - Read-only
meta_list_messagingCopy lines with their status and the quotes they cite. - Write
meta_draft_messagingWrite copy lines for an angle from its evidence. - Write
meta_save_messagingAdd or edit a copy line by hand. - Write
meta_set_messaging_statusApprove, reject or send copy lines back to draft. - Write
meta_delete_messagingDelete copy lines written in error. - Read-only
meta_list_draftsGenerated drafts, newest first. - Write
meta_generate_draftGenerate a static that replicates a swipe's format.
Launch
13 toolsEvery ad is created paused. Spending starts only when you approve it.
- Write
meta_launch_adsCreate ads paused, from the library or a link. - Needs approval
meta_activateTurn a launch on. Needs your approval. - Needs approval
meta_pause_launchPause a launch's ads. - Needs approval
meta_set_ad_statusPause or resume one ad. - Needs approval
meta_update_ad_set_targetingChange an ad set's placements or age range. - Needs approval
meta_relink_launchChange a live launch's CTA, link or ad text.
+7 more launch toolsShow fewer
- Read-only
meta_list_launchesRecent launches with their Meta ids and status. - Read-only
meta_list_presetsLaunch presets: where ads go and who sees them. - Write
meta_save_presetCreate or update a launch preset. - Read-only
meta_list_pages_and_pixelsThe Page, pixel and Instagram account behind the ad account. - Read-only
meta_list_lead_formsThe Page's instant forms. - Write
meta_create_lead_formCreate an instant form on the Page. - Write
meta_send_test_leadSend a test lead through a form.
How does an agent sign in?
A person signs in with OAuth in the browser. A headless agent sends an API key. Your Meta token never travels over MCP.
What does meta_launch_ads do?
The campaign, ad set and ads land on Meta paused. Spend starts only when a person approves meta_activate.
Your agent calls
meta_launch_adsWith a launch preset, only the creatives are required. Ad names follow your taxonomy.
The credential is checked
Launching needs write scope. A read-only key stops here.
The copy is held to your strategy
Numbers and claims your strategy doesn't back come back as cautions for you to read.
Creatives upload with Advantage+ opted out
Meta can't rewrite the copy you approved.
Campaign, ad set and ads are created paused
The launch is recorded with its Meta ids, ready for review in Ads Manager.
meta_activatewaits for youActivating needs the approval grant and your go-ahead in the conversation. Then spend starts.
What should I ask first?
Start read-only. Then hand your agent a real job.
- Evidence checkAnswered in the conversation: Run an evidence health check on our Meta account and tell me which numbers I shouldn't trust yet. Don't change anything.
- What workedWhat worked over the last 90 days? Show the winners and the traits behind them: angle, hook and persona.
- Next testSuggest the next test, with its basis and what would reverse it. If I agree, commit it as a Test.
- Ad LibraryFind what our top three competitors are running in the Ad Library and save the strongest hooks to our swipe file.
- ResearchTurn our customer reviews into personas and angles, each traced to a quote, then draft messaging for the strongest angle.
- Launch pausedBuild the launch from the approved drafts: one campaign, one ad set, three ads. Leave it paused for my review.
Your agent · Win & Scale MCP
Run an evidence health check on our Meta account and tell me which numbers I shouldn't trust yet. Don't change anything.
meta_get_evidence_healthFreshness, coverage and untagged spend, before any claim.Read-only
Here is how fresh the data is, what the check flagged, and which numbers to hold back on until the gaps are fixed. Nothing was changed.
Where to go next
Questions, answered
Everything else is in the docs.
- Is there an MCP server for Meta ads?
- Yes, there is an MCP server for Meta ads. Win & Scale is a remote MCP server for Meta ads at https://winandscale.com/api/mcp, with 88 tools that read your ad account and launch new ads paused.
- Can my agent spend money without asking?
- No, your agent can't spend money without asking. meta_launch_ads creates the campaign, ad set and ads paused. Turning them on is meta_activate, which needs the approval grant and your go-ahead.
- Which AI agents work with it?
- Any client that speaks remote MCP works with Win & Scale. Claude, Claude Code, ChatGPT, Cursor, Codex, Gemini, VS Code and Windsurf each have a setup guide.
- Do I need an API key?
- No, you don't need an API key. Win & Scale signs in with OAuth 2.1 in the browser. An rsk_ API key is only for headless agents that can't open one.
- How does it reach my Meta ad account?
- A workspace admin enters a System User token and the ad account id in the app, once. The token is stored encrypted and never travels over MCP.
- What does it cost?
- Win & Scale starts with a 7-day free trial with every feature. After that it is a flat monthly price per ad account, set by its ad spend, and agent calls use no AI credits.