[ Developers ]
SumAds for developers
Run your SumAds workspace from Claude. SumAds is an MCP server: an AI app reads your campaigns, spend, revenue and settings through SumAds' own tools, and every change it asks for waits for your Confirm.
Quick start — add SumAds as a connector
In Claude, open Settings → Connectors, choose Add custom connector, name it SumAds and paste:
https://www.sumads.com/mcpIf Claude asks, pick Register automatically. Claude opens SumAds: sign in with your access key and press Allow. The connector then works in Claude on the web, on the desktop and in the phone apps. You need a SumAds access key — request access.
Command-line clients
In Claude Code:
claude mcp add --transport http sumads https://www.sumads.com/mcpThen type /mcp in Claude Code to sign in. Other MCP clients that sign in with OAuth, such as Gemini CLI, use the same address and the same sign-in page.
What an AI app can do
- Read. Reports across every ad account; campaigns, ad groups and ads; spark codes, offers, rules and settings. Answered at once.
- Change. Launch, pause, edit, appeal and more. Each change arrives in SumAds as a proposal, and nothing happens until you press Confirm — in SumAds or on Telegram.
- Nothing more. Turn off Allow changes in the assistant's Setup and an app sees only the reads. Ask it what it can do: it lists the tools your workspace allows.
Safety model
- Your workspace only. A connection belongs to the access key that pressed Allow; the app on the other end cannot name another workspace.
- Changes wait for you. Every write is a proposal you confirm in SumAds, never inside the AI app.
- Credentials stay here. An app never sees your TikTok, affiliate network or Telegram credentials, and SumAds keeps the tokens it issues only as hashes.
- Short-lived access. An access token lasts an hour and renews while you use it.
- Revoke any time. Assistant → Setup → Claude → Revoke ends one connection; revoking your access key ends them all.
Reference
- MCP endpoint
https://www.sumads.com/mcp— JSON-RPC over HTTP POST- OAuth discovery
https://www.sumads.com/.well-known/oauth-protected-resource- Questions
- legal@sumads.com