ADS Beast
Work with your ads from Claude, ChatGPT or Cursor
ADS Beast exposes your workspace over the Model Context Protocol. The assistant reads clients, campaigns, leads, reports and alerts, writes lead outcomes back, and can propose changes that wait for your approval in the cabinet. It cannot change an ad account directly.
Server
- MCP URL
https://adsbeast.pro/api/mcp/workspace- Transport
- Streamable HTTP, JSON-RPC 2.0
- Sign-in
- OAuth 2.1 with PKCE and dynamic client registration, or an
absk_API key in the Authorization header - Scopes
read(everything read-only) ·propose(read + lead outcomes + change proposals + campaign drafts)- Metadata
https://adsbeast.pro/api/oauth/metadata
Claude (web, desktop)
- 1Open Customize → Connectors → Add custom connector. Availability depends on your plan and organization policy.
- 2Name it ADS Beast and paste the MCP URL above. Choose OAuth sign-in; the client registers itself, no key is needed.
- 3Click Connect, sign in to ADS Beast and allow access. Start with
read; addproposeonly if the assistant should suggest changes. - 4In a chat enable the connector and ask: "Call whoami from ADS Beast". Then try "Show the Agency Kit for client <name>".
ChatGPT (custom MCP)
- 1Open the connectors or developer settings and add a custom MCP server with the MCP URL above.
- 2Choose OAuth. Sign in to ADS Beast and allow access.
- 3In a new chat select ADS Beast and call
whoamito confirm the connection.
Cursor, Claude Code, scripts
- 1In ADS Beast open API keys and create an integration key with the scopes you need (read:* for reading, write:leads and write:proposals for outcomes and proposals).
- 2Add the MCP server with the URL above and the header
Authorization: Bearer absk_.... - 3Keys and OAuth connections are revoked in the cabinet; a revoked token stops working at once.
What stays under human control
- Every change the assistant proposes is a proposal with a reason; a person approves it in the cabinet or in Telegram, and it can be undone.
- The client's write policy and the workspace emergency stop apply to proposals exactly as to agents.
- Numbers come from the system only: campaign metrics, leads and reports, in the currency of each ad account.
- The assistant can assemble a campaign as a draft in the builder: type, geo, budget, keywords or audiences, ad texts. Nothing goes to the ad platform: a person opens the draft, sees what the check found and publishes the campaign paused.
- The Agency Kit the assistant reads contains no contacts, tokens or keys.
Setup details for operators: docs/MCP_OAUTH.md in the repository. Questions: support@adsbeast.pro.