Connect
- Server URL: https://www.7275.com/api/mcp
- Transport: Streamable HTTP, stateless JSON-RPC (POST). GET returns 405.
- Auth: OAuth 2.1 authorization code with PKCE (S256). Clients discover the server through https://www.7275.com/.well-known/oauth-protected-resource and register themselves (RFC 7591 Dynamic Client Registration) at /api/mcp-oauth/register.
- Authorization URL: https://www.7275.com/api/mcp-oauth/authorize · Token URL: https://www.7275.com/api/mcp-oauth/token
- Redirect URIs must be https (or http://localhost for native apps). Recognised connector hosts include claude.ai, chatgpt.com and business.tiktok.com (TikTok Agentic Hub: https://business.tiktok.com/agentic/oauth/callback).
- Alternatively send an AdWhiz API key as Authorization: Bearer dxk_live_… (Settings → API keys).
Scopes
- adwhiz:read — the read-only tools below. Always granted.
- adwhiz:create — generate ad copy and ad videos with the plan's monthly allowance. Offered as a tick box on the consent page (ticked by default when the app asks for it). Connections authorized before October 2026 have read only: reconnect to add it.
- Access tokens last 30 days and refresh for 90 days. Revoke a connection any time in Settings → Security.
Tools
- list_ad_accounts (read-only) — connected Google Ads, Meta Ads and TikTok Ads accounts and their connection status.
- list_recommendations (read-only) — the AI's open optimization recommendations with reason, expected impact and confidence. Advisory: nothing is applied.
- get_savings_summary (read-only) — where to find the savings figures, plus the account and plan.
- get_recent_activity (read-only) — recent sign-ins, API key changes, ad-account connections and subscription changes.
- get_quota (read-only) — the current API rate-limit window.
- get_ad_video (read-only) — status of an ad video (pending, running, done with a download URL, failed with the reason); without a job id, recent videos and this month's allowance.
- generate_ad_copy (write, needs adwhiz:create) — TikTok-native ad copy for a product: hook, ad text (≤100 characters), call to action, captions and a 15-second storyboard of 3 shots per variant, plus why it works and compliance notes. Explanations and a translation come back in the user's own language when the ad is in another one. Counts toward the plan's monthly AI generation allowance; identical briefs are served from cache.
- create_ad_video (write, needs adwhiz:create) — renders up to 3 storyboard shots into one 9:16 video with AI voice-over and captions. Uses one video from the plan's monthly allowance (Personal plan and up). Asynchronous: poll get_ad_video. The output is AI-generated and should be disclosed as such when published.
No tool creates, changes, pauses or enables campaigns, ad groups or ads, and no tool spends ad budget. To publish a video on TikTok, use the TikTok for Business MCP Server (file_video_ad_upload, then create the ad paused).
Plans and allowances
- Read-only tools work on every plan, within the plan's API rate limit (see get_quota).
- Ad copy needs a paid plan. Ad videos need the Personal plan or higher (Starter includes none; a free trial includes one). The monthly video allowance depends on the plan (see Pricing). A video that fails before any shot is rendered is not counted; there is also a limit of 6 video requests per 24 hours, failed ones included.
Errors
- insufficient_scope — the connection lacks adwhiz:create (reconnect and keep the tick box) or tried a write the connection is not allowed to make.
- plan_required — creative tools need a paid plan.
- monthly_limit — the plan's monthly AI or video allowance is used up (Starter includes no videos).
- daily_limit — 6 video requests in the last 24 hours, failed ones included; try again later.
- video_busy — another video for the same account is being started; retry in a few seconds.
- rate_limited — too many requests; wait and retry (Retry-After header).
Support, privacy and terms
- Support: [email protected] or Tickets in the dashboard.
- Privacy policy: https://www.7275.com/en/legal/privacy · Terms of service: https://www.7275.com/en/legal/terms