TikTok Ads MCP · Updated September 5, 2026
TikTok Ads MCP Server: run your TikTok Ads from Claude or ChatGPT
Paste one link into Claude or ChatGPT, sign in with TikTok for Business, and your AI can read and manage your TikTok Ads account. No developer app, no access token, nothing to install, about a minute of setup. Everything below the link is the full reference for you and your AI agent.
https://connector.get-ryze.ai/mcp- 01Copy your MCP link:
https://connector.get-ryze.ai/mcp - 02In Claude go to Settings → Connectors → Add custom connector. Name it Ryze AI, paste the link, click Add. In ChatGPT it is Settings → Apps → Create app.
- 03Click Connect, sign in with TikTok for Business, pick your workspace. Open a new chat and ask: “Which TikTok campaigns had the highest cost per conversion this month?”
01 — Overview
What this TikTok Ads MCP server does
The short version
- One URL,
https://connector.get-ryze.ai/mcp, works in Claude, ChatGPT, Claude Code, Cursor and any MCP client. - Sign in with TikTok for Business. No developer app, no app review, no access token, no Python, no server to run.
- Read tools for advertisers, reports, campaigns, ad groups, ads and creatives, plus approval-gated write tools for budgets, status, bids and new campaigns.
- Same endpoint carries Google Ads, Meta Ads, GA4, Search Console and Shopify — 150+ tools in total.
- Free to connect. Paid Ads Autopilot is $89/mo flat if you want Ryze AI to run the optimizations for you.
- Server name
- Ryze AI (TikTok Ads MCP)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over Streamable HTTP
- Auth
- OAuth 2.0 (TikTok for Business sign-in, one Ryze workspace per connection)
- Hosting
- Hosted by Ryze AI — nothing to install or run
- TikTok Ads tools
- Read + write (writes approval-gated)
- Also on this endpoint
- Google Ads, Meta Ads, GA4, Search Console, Shopify — 150+ tools
- Developer app / token
- Not required
- Price
- Free to connect · Paid Ads Autopilot $89/mo flat
- Updated
- September 5, 2026
MCP (Model Context Protocol) is the open standard AI assistants use to call external tools. A TikTok Ads MCP server turns your advertiser account into a set of those tools, so an assistant can pull an integrated report, rank creatives by CTR or pause an ad group from a chat instead of TikTok Ads Manager. TikTok announced an official Ads MCP server at TikTok World in May 2026 but has not published an endpoint; the open-source servers on GitHub are local processes you configure with your own developer app and access token. This one is hosted, so the whole setup is a URL and a TikTok for Business sign-in. The comparison further down covers each route.
/01
Managed TikTok OAuth
Browser sign-in with TikTok for Business, tokens exchanged and refreshed server-side. No developer app, no app review, no long-lived access token to guard.
/02
Integrated reports
Advertiser, campaign, ad-group and ad-level reports with spend, impressions, CPM, CTR, conversions, cost per conversion and ROAS, broken down by day, placement, age, gender, country or device.
/03
Full object reads
Campaigns, ad groups, ads, creatives, identities, pixels and audiences with their status, objective, budget mode, targeting and schedule.
/04
Approval-gated writes
Change budgets, bids, schedules and status, or create new campaigns and ad groups, through per-tool approval. Deletes use a separate, explicit path.
/05
Creative performance
Rank videos by CTR, 2-second and 6-second view rates and cost per result to spot fatigue before spend decays.
/06
Smart+ and Spark Ads aware
Reads and manages Smart+ campaigns, Spark Ads that boost organic posts, and standard auction campaigns in the same calls.
/07
Multi-advertiser
Discover every advertiser the login can reach through its Business Center and pass advertiser_id per call for agency setups.
/08
Six platforms, one URL
The same endpoint carries Google Ads, Meta Ads, GA4, Search Console and Shopify toolsets — one login instead of six servers.
02 — Tool reference
What the TikTok Ads tools cover
Every call takes an advertiser_id — the numeric TikTok Ads account ID. The exact tool names appear in your client’s tool list the moment TikTok Ads is connected to the workspace; the table groups them by what they do. Write capabilities are approval-gated.
| Capability | Access | What it does | What you pass |
|---|---|---|---|
Advertiser discovery | read | Every advertiser account the signed-in TikTok for Business login can reach, with currency and timezone. The assistant calls this first. | none |
Account summary | read | Spend, impressions, clicks, conversions, CPA and ROAS for a date range in one call. | advertiser_id · start_date · end_date |
Integrated report | read | Any Marketing API integrated report: data level, dimensions, metrics, filters and date range, paged up to 1,000 rows per page. | advertiser_id · data_level · dimensions · metrics · filters · start_date · end_date · page · page_size |
Campaign, ad group and ad reads | read | Objects with objective, status, budget_mode, budget, bid, schedule, placements and targeting. | advertiser_id · filtering · fields · page · page_size |
Creative and identity reads | read | Videos, images, identities and Spark Ads post authorizations with their IDs and status. | advertiser_id · filtering |
Pixel and audience reads | read | Pixels with their events, and custom or lookalike audiences with size and status. | advertiser_id |
Status, budget and bid updates | write | Enable, disable, or change budget, bid and schedule on campaigns, ad groups and ads. | advertiser_id · ids · operation | fields |
Campaign and ad group creation | write | Create campaigns and ad groups with objective, budget mode, placements, optimization event, targeting and schedule. | advertiser_id · body |
Ad creation from existing creatives | write | Create ads that reference uploaded videos or images and an identity. | advertiser_id · adgroup_id · creatives[] |
Delete | write | Remove campaigns, ad groups or ads. Only runs on an explicit, item-by-item approved list. | advertiser_id · ids |
The same endpoint exposes the Google Ads, Meta Ads, GA4, Search Console and Shopify toolsets. The cross-platform list lives in the advertising API & MCP tools reference; Google Ads and Meta have their own pages at Google Ads MCP and Meta Ads MCP.
03 — Prerequisites
What you need before you start
You need
- A TikTok for Business login with Operator or Admin access to the advertiser account (or the Business Center above it).
- A free Ryze AI account — created during the OAuth step if you don’t have one.
- An MCP client: Claude Pro, Team or Max (custom connectors are not on the free plan), ChatGPT Plus, Pro or Business with Developer mode, or Claude Code, Cursor, Windsurf, VS Code on any plan.
You don’t need
- A TikTok for Business developer app, app review or a Marketing API access token — the hosted server brings its own API access.
- A sandbox advertiser, an app ID and secret, or a token-refresh job.
- Python, Node, a virtual environment, a
.envfile or a process to keep running.
04 — Setup
Install in every MCP client
All routes end in the same OAuth screen: sign in with Ryze AI, choose your workspace, click Allow. Connect TikTok Ads once under Workspace Settings → Integrations in Ryze (it opens the TikTok for Business consent screen); the tools appear in the next chat. One connection maps to one workspace, so agencies with several client workspaces reconnect per workspace. Screenshots for the Claude route are in how to connect Claude to the Ryze AI MCP.
Claude (web and desktop)
- 01On claude.ai, click your avatar (bottom-left) → Settings.
- 02Open the Connectors tab and click Customize, then the + next to Connectors.
- 03Name: Ryze AI. Remote MCP server URL:
https://connector.get-ryze.ai/mcp. Click Add. - 04Click Connect on the new connector, sign in, pick your workspace and click Allow Claude to connect.
- 05A green confirmation lists the available tools. Start a new chat and ask your first question.
Requires Claude Pro, Team or Max. The Claude desktop app uses the same Settings → Connectors flow; if you prefer the config file, use the mcp-remote entry under “Claude Desktop config file” below.
ChatGPT
- 01Settings → Apps. Under Advanced settings, turn on Developer mode.
- 02Click Create app. Name: Ryze AI. MCP server URL:
https://connector.get-ryze.ai/mcp— choose Server URL, not Tunnel. - 03Authentication: OAuth. Tick the acknowledgment and click Create.
- 04On the authorization page choose Sign in with Ryze AI, pick your workspace and click Allow.
- 05Start a new chat: “Pull the last 7 days of TikTok Ads spend, CPM, CTR and conversions by campaign.”
Requires a ChatGPT plan that supports apps and connectors (Plus, Pro or Business).
Claude Code
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcpThen run /mcp inside Claude Code to complete the OAuth sign-in. Add --scope user to make it available in every project.
Cursor, Windsurf and any mcp.json client
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Save, then approve the OAuth prompt the client opens. Windsurf uses the key serverUrl instead of url.
VS Code (GitHub Copilot agent mode)
{
"servers": {
"ryze": {
"type": "http",
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Claude Desktop config file (optional)
{
"mcpServers": {
"ryze": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://connector.get-ryze.ai/mcp"]
}
}
}macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json. Restart Claude Desktop; the first call opens the browser for OAuth. Most people won’t need this — Settings → Connectors does the same without Node.
05 — Usage
What to ask once connected
Reporting
- >“Pull the last 7 days of TikTok Ads spend, CPM, CTR and conversions by campaign.”
- >“Build my Monday TikTok report: spend, cost per conversion, top 5 ads, and what to fix.”
- >“Break last month's spend down by placement and country.”
Creative fatigue
- >“Rank my active TikTok ads by CTR trend over the last 4 weeks and flag the ones decaying.”
- >“Which videos have a 6-second view rate under 10% and spend over $200 this month?”
- >“Compare Spark Ads vs non-Spark creatives on cost per conversion, last 30 days.”
Structure
- >“List every ad group with its optimization event, bid and daily budget.”
- >“Which campaigns are Smart+ and which are manual auction?”
- >“Show me the pixel events firing on the account this week.”
Changes (approval-gated)
- >“Raise the daily budget on the best-ROAS ad group by 20% — show me the plan first.”
- >“Pause every ad with CTR under 0.4% and spend over $100 this month.”
- >“Create a paused Conversions campaign with a $100 daily budget targeting US, 25–44, using the three top creatives.”
Ready-made workflows: TikTok’s official MCP announcement and how to connect Claude today, AI for TikTok advertising, ChatGPT prompts for TikTok Ads and connecting Google, Meta, TikTok, GA4, Search Console and Shopify in one MCP.
06 — Request examples
Report requests you can describe in the chat
You rarely need to write these — the assistant builds them. When you want exact control, describe the request in Marketing API terms and the server runs it as an integrated report or an object update. Three that come up daily:
Campaign report, last 30 days
{
"advertiser_id": "7000000000000000000",
"data_level": "AUCTION_CAMPAIGN",
"dimensions": ["campaign_id"],
"metrics": ["campaign_name", "spend", "impressions", "cpm", "ctr",
"conversion", "cost_per_conversion", "complete_payment_roas"],
"start_date": "2026-08-06",
"end_date": "2026-09-04",
"page_size": 200
}Spend comes back in the advertiser's currency as whole units, not micros. Ad-level breakdowns are best kept to 30 days per call.
Ad-level daily report with placement breakdown
{
"advertiser_id": "7000000000000000000",
"data_level": "AUCTION_AD",
"dimensions": ["ad_id", "stat_time_day", "placement"],
"metrics": ["ad_name", "spend", "ctr", "video_views_p25",
"video_watched_6s", "conversion"],
"start_date": "2026-08-29",
"end_date": "2026-09-04",
"page_size": 1000
}Add stat_time_day to dimensions for daily rows; placement, age, gender and country are also valid breakdown dimensions.
Read ad groups, then an approval-gated budget change
// read
{ "advertiser_id": "7000000000000000000",
"filtering": { "campaign_ids": ["1800000000000000000"] },
"fields": ["adgroup_id", "adgroup_name", "budget_mode", "budget",
"optimization_event", "operation_status"] }
// update (approval-gated)
{ "advertiser_id": "7000000000000000000",
"adgroup_id": "1800000000000000001",
"budget": 120 }budget_mode is BUDGET_MODE_DAY or BUDGET_MODE_TOTAL; budget is in the advertiser currency. Updates need approval before they run.
07 — Compare
Hosted vs TikTok's announced MCP vs self-hosted
| What you operate | Ryze AI hosted server | TikTok's official MCP (announced) | Open source (GitHub) |
|---|---|---|---|
| Availability | Live | Announced at TikTok World, May 2026 — no public endpoint yet | Live, community-maintained |
| Runtime | None — remote HTTP | Unconfirmed | Local Node or Python process you run |
| Credentials you manage | TikTok for Business sign-in only | Unconfirmed | Developer app + app review + access token |
| When the API version changes | Ryze updates the server | TikTok | You wait for a repo update |
| Platforms | TikTok + Google Ads, Meta, GA4, Search Console, Shopify | TikTok only | TikTok only |
| Write approval controls | Per-tool, on by default | Unconfirmed | Varies by project |
Self-hosting is the right call when the data must never leave your machine or you are building your own agent on the raw Marketing API. For that route and for the state of TikTok’s own server: TikTok Ads MCP: the official server and how to connect today. For the other platforms on this endpoint, see Google Ads MCP and Meta Ads MCP.
08 — Security & permissions
Safe by default
OAuth 2.0 only
You sign in on TikTok for Business's page. Your password never touches Ryze, and tokens are refreshed server-side.
One workspace per connection
Each connection is authorized against a single Ryze workspace, chosen on the consent screen. Switching workspaces means reconnecting and starting a new chat.
Approval-gated writes
Read tools are automatic. In Claude, open Settings → Connectors → Ryze AI and keep every write and delete tool on 'Needs approval' — the recommended default for live accounts.
Deletes are separate and explicit
Deleted TikTok campaigns and ad groups cannot be restored, so deletion only runs on an item-by-item approved list. Disabling is the reversible path.
Revoke any time
Disconnect TikTok Ads under Workspace Settings → Integrations in Ryze, or remove the authorization in TikTok for Business → Business Center → Authorizations.
Policies
Read the MCP privacy policy, MCP terms, security policy and MCP permissions best practices.
09 — Quotas & limits
What to know before a heavy session
| Developer app & tokens | Not yours to manage — the hosted server runs on Ryze AI's TikTok Marketing API access. Self-hosted servers need a developer app, app review and a token you refresh. |
| Report paging | Integrated reports return up to 1,000 rows per page; the assistant pages through with page and page_size. Keep ad-level breakdowns to about 30 days per call. |
| Money fields | Spend, budgets and bids are whole units in the advertiser's currency, not micros. Currency and timezone come from the advertiser object. |
| Reporting freshness | TikTok reporting can lag a few hours; today's numbers are partial until the advertiser's day closes in its timezone. |
| Budget rules | Minimum daily budgets apply per objective and currency (typically $50 at campaign level and $20 at ad-group level in USD). Budget mode is day or lifetime and cannot be switched after launch. |
| Learning phase | Ad groups re-enter learning after large bid or budget changes; the assistant keeps single changes under about 20–30% unless told otherwise. |
| Creatives | Videos and images must already be in the account's creative library or uploaded there; the server references existing creative IDs when creating ads. |
| Client plans | Claude custom connectors: Pro, Team or Max. ChatGPT connectors: Plus, Pro or Business with Developer mode. |
10 — Troubleshooting
Common errors and the fix
| Symptom | Cause | Fix |
|---|---|---|
| Tools don't show up in the chat | The chat was opened before the connector existed. | Start a new chat — Claude and ChatGPT bind connectors when a conversation starts. |
| No 'custom connector' option in Claude | Free Claude plan. | Custom connectors need Claude Pro, Team or Max. ChatGPT needs Plus, Pro or Business with Developer mode on. |
| No TikTok tools, only Google and Meta | TikTok Ads is not connected to this workspace. | Connect it under Workspace Settings → Integrations in Ryze, then start a new chat. |
| "advertiser_id is required" or the wrong account | No advertiser chosen yet. | Ask for accessible advertisers first and name one. IDs are 19-digit numbers. |
| Report returns no rows | Wrong data level, or the range predates the objects. | Match data_level to the dimension (AUCTION_AD with ad_id) and check the date range against the campaign schedule. |
| Numbers don't match Ads Manager | Different attribution window or timezone. | Ads Manager reports in the advertiser timezone with its attribution settings; ask for the same window and confirm the timezone. |
| A write action 'did nothing' | It is waiting for your approval. | Approve the tool call in the chat, or review the tool's setting under Settings → Connectors → Ryze AI. |
| Budget update rejected | Below the minimum, or the budget mode does not allow it. | Check the objective's minimum daily budget and whether the ad group uses day or lifetime budget mode. |
| Data from the wrong client account | The connection is authorized to another workspace. | Each connection is one Ryze workspace. Reconnect, pick the right workspace, and start a new chat. |
Still stuck? Email support@get-ryze.ai. Agencies juggling many accounts: MCP config for multiple ad accounts.
11 — FAQ
TikTok Ads MCP server questions
What is the TikTok Ads MCP server?
It is an MCP (Model Context Protocol) server that exposes a TikTok Ads advertiser account as tools an AI assistant can call. Ryze AI's TikTok Ads MCP server is hosted and remote: you add one URL to Claude, ChatGPT, Cursor or Claude Code, connect TikTok for Business via OAuth, and the assistant can run integrated reports, read campaigns and creatives, and make approval-gated changes.
What is the TikTok Ads MCP server URL?
The server URL is https://connector.get-ryze.ai/mcp. It is a remote MCP server over Streamable HTTP with OAuth 2.0. The same endpoint serves the Google Ads, Meta Ads, TikTok, GA4, Search Console and Shopify toolsets, so one connector covers the whole ad stack. Each connection is authorized against one Ryze workspace.
Does TikTok have an official Ads MCP server?
TikTok announced an official Ads MCP server and a TikTok Ads Skills toolkit at TikTok World on May 12–13, 2026, naming Claude and ChatGPT as example clients. As of September 2026 there is no public endpoint, tool list or general-availability date. Ryze AI's hosted server connects TikTok Ads to those clients today.
Do I need a TikTok for Business developer app or access token?
No. The hosted server runs on Ryze AI's own Marketing API access. You sign in with a TikTok for Business login that has Operator or Admin access to the advertiser and you are done. Open-source servers require you to create a developer app, pass app review, generate an access token and keep a local process running.
What can the TikTok Ads tools do?
Read: discover advertisers, pull account summaries and integrated reports at advertiser, campaign, ad-group and ad level with breakdowns, and read campaigns, ad groups, ads, creatives, identities, pixels and audiences. Write, with approval: change status, budgets, bids and schedules, create campaigns, ad groups and ads from existing creatives, and delete objects from an explicit list.
Can the MCP server change my TikTok campaigns, or only read data?
Both. Read tools work the moment the connection completes. Write tools are approval-gated: in Claude you set each one to 'Needs approval' under Settings → Connectors → Ryze AI. Deletion is separate and only runs on an item-by-item approved list because deleted TikTok objects cannot be restored.
Does it support Smart+ campaigns and Spark Ads?
Yes. Smart+ campaigns, Spark Ads built on organic posts and standard auction campaigns are all objects on the Marketing API, so the reads and the approval-gated updates cover them in the same calls. Creating a Spark Ad still needs the post authorization code from the creator.
How do I pull a TikTok report through MCP?
Ask in plain English or describe the integrated report: data level (advertiser, campaign, ad group or ad), dimensions such as campaign_id, stat_time_day or placement, the metrics you want, and the date range. Spend arrives in the advertiser's currency as whole units, and results page at up to 1,000 rows.
Can I use it with several advertiser accounts or clients?
Yes. The assistant lists every advertiser the login can reach through its Business Center and passes advertiser_id on each call. One connection maps to one Ryze workspace, so agencies keeping clients in separate workspaces reconnect per workspace and start a new chat.
What does the TikTok Ads MCP server cost?
Connecting is free — a Ryze AI account costs nothing to create and the connector has no per-call fee. Paid Ads Autopilot is $89/month flat with a 7-day free trial if you want Ryze AI to run the optimizations for you. On the client side you need a Claude plan that allows custom connectors (Pro, Team or Max) or a ChatGPT plan with connectors (Plus, Pro or Business).
Is the TikTok Ads MCP server secure?
Access is OAuth 2.0 only, so your TikTok password never touches Ryze. Each connection is scoped to one Ryze workspace, write and delete tools are approval-gated by default, and you can revoke access at any time from Business Center authorizations or from Workspace Settings → Integrations in Ryze. The MCP privacy policy, MCP terms and security policy are linked on this page.
Why doesn't Claude see the TikTok Ads tools after I connected?
Two common reasons. First, start a new chat — Claude and ChatGPT bind connectors when a conversation starts. Second, TikTok Ads must be connected to the workspace under Workspace Settings → Integrations in Ryze; a workspace with only Google connected shows only Google tools.
How is this different from the open-source TikTok MCP servers on GitHub?
Those are local processes built on the Marketing API: you create a developer app, pass review, manage the access token, run the server and get TikTok only. The Ryze AI server is hosted, needs nothing beyond a TikTok for Business sign-in, adds Google Ads, Meta, GA4, Search Console and Shopify on the same endpoint, and ships approval controls for every write.
12 — Compatibility
Works in every MCP client
13 — Related
Keep reading
One OAuth login · TikTok Ads read + write tools · Live in ~60 seconds
Add TikTok Ads to your AI today.
Free to connect. Upgrade to Paid Ads Autopilot ($89/mo flat, 7-day free trial) when you want Ryze AI to run the optimizations for you, 24/7.
2,000+ clients · 700+ agencies · $500M+ managed · No dev token · No server to run
