[ 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/mcp

If 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/mcp

Then 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

Run your TikTok campaigns from one dashboard.