Quickstart
Connect your agent to Win & Scale over MCP, or mint an rsk_ key and make a first REST call.
You need a workspace with a connected Meta ad account. If you have not connected one yet, start with Connect your ad account.
There are two ways in. Pick the one that matches who is calling.
- MCP for an agent a person is driving (Claude, ChatGPT, Cursor, Codex, Claude Code). It signs in with OAuth 2.1 in the browser, so there is no token to copy.
- REST for your own code or a headless agent. It uses an
rsk_API key.
Connect over MCP
The MCP server is one HTTP endpoint:
https://winandscale.com/api/mcpAdd the server to your client
claude mcp add --transport http winandscale https://winandscale.com/api/mcpInside Claude Code, run /mcp and sign in.
Or install the plugin, which bundles the server, a reference skill, the workflow skills and slash commands:
claude --plugin-url https://winandscale.com/api/mcp/plugin.zipConnecting lists the other clients (VS Code, Gemini CLI, Windsurf) and explains what an OAuth session reaches.
Approve a workspace
The first time you connect, the client opens a browser consent screen. Pick the workspace the agent may use. A session reaches that one workspace, and through it that one Meta ad account.
Ask a first question
Which workspace and ad account are you connected to? Then check whether the
evidence is fit to judge my ads, and tell me what it warns about.The agent calls meta_get_workspace and meta_get_evidence_health. The second
call judges nothing: it reports sync freshness, coverage gaps, untagged spend and
the outcomes Meta cannot see. Read its warnings before you trust any comparison.
Or make a REST call
Create an API key
A workspace admin opens Settings → API keys (/app/settings/api) and creates
a key. Choose a scope:
- Read for reports, history, creatives and tests.
- Write to also launch ads paused, sync, and edit Values, briefs, tests, swipes and research.
- Admin is the same as write today.
The approval grant is a separate checkbox, off by default and unavailable on a read key. Leave it off unless this key must be able to activate, pause or retarget ads. See Authentication.
Copy the key now. It is shown once and starts with rsk_.
Call the API
curl https://winandscale.com/api/v1/workspace \
-H "Authorization: Bearer $WINANDSCALE_KEY"The response names the workspace and the Meta ad account (adAccountId) every
call will hit. Response bodies are the tool's own payload, so field names are
camelCase. Request bodies and query parameters are snake_case.
Check the evidence
curl "https://winandscale.com/api/v1/evidence-health?window=90d" \
-H "Authorization: Bearer $WINANDSCALE_KEY"window is 30d, 90d (the default), 180d or lifetime.
Keys are server-side secrets. The API sends no CORS headers, and calling it from a browser is not supported.