
PaidSync.ai
io.github.PaidSyncPublished by GitHub account PaidSyncv2.3.1Updated Oct 24, 2026
Run ads on Google, Meta, LinkedIn, TikTok and more from AI. 610+ tools across 14 platforms.
Overview
Hosted MCP server that lets an AI assistant build and manage ad campaigns across ten ad platforms plus GA4, GTM, Search Console and Merchant Center.
- What you can do
- Build and manage campaigns on Google Ads, Meta, LinkedIn and ChatGPT Ads
- Manage existing campaigns on TikTok, Microsoft, Snapchat, Reddit, Pinterest and X
- Read GA4 reports and make admin changes such as key events and Google Ads links
- Read and change GTM tags, triggers, variables and workspaces, publishing on confirmation
- Read Search Console data and handle Merchant Center products, feeds and Google Ads links
- Discover tools on demand through context, tool-detail and exec meta-tools
- When to use it
- Useful for brands, agencies and in-house marketing teams that already run paid media and want to audit, pause, rebalance or build campaigns from a chat instead of switching between ad managers. It also suits teams setting up conversion tracking across GA4, GTM and Google Ads.
- Requirements
- A remote streamable-HTTP endpoint; no local install or API key. OAuth sign-in to PaidSync is required, plus OAuth connections to each ad and measurement platform you want to use. A PaidSync account is needed; the free tier covers 15 tasks a month, and paid plans start at $99 a month.
Installation
In SourceWeft
- Open PaidSync.ai in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.PaidSync%2Fpaidsync/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"paidsync-ai": {
"type": "http",
"url": "https://mcp.paidsync.ai/mcp"
}
}
}README
PaidSync. The MCP for Running Ads with AI
PaidSync connects Claude, ChatGPT and other AI assistants to your ad accounts. It builds new campaigns on Google Ads, Meta, LinkedIn and ChatGPT Ads, and manages existing campaigns on TikTok, Microsoft, Snapchat, Reddit, Pinterest and X. Plus Google Analytics 4, Google Tag Manager, Search Console (read-only) and Merchant Center. 630+ tools across 14 platforms.
[Google Partner] [Meta Business Partner] [TikTok Marketing Partner] [License: MIT] [Star History Chart]
paidsync.ai · Run Ads with AI · Compare · Docs · Pricing
What this is
PaidSync is a hosted MCP server that lets your AI assistant act on your ad accounts, not just describe them. One connection covers ten ad platforms (Google Ads, Meta, LinkedIn, ChatGPT Ads, TikTok, Microsoft, Snapchat, Reddit, Pinterest and X) plus four measurement and tracking platforms (Google Analytics 4, Google Tag Manager, Google Search Console and Google Merchant Center).
On Google Ads, Meta, LinkedIn and ChatGPT Ads it builds new campaigns. On TikTok, Microsoft, Snapchat, Reddit, Pinterest and X it manages the campaigns you already run there. Search Console is read-only in PaidSync.
PaidSync changes campaign settings only. It never moves money or processes payments, and billing stays directly between you and each ad platform.
Who PaidSync is for
PaidSync was built for both ends of the paid media market.
DTC and ecommerce brands running their own ad spend across Meta, Google, TikTok, Pinterest, and Snapchat. One operator managing that many ad platforms is a recipe for tab fatigue. PaidSync collapses the workflow. Ask Claude to audit, pause, and rebalance. Done in one chat.
B2B agencies and consultants managing 5 to 100+ client accounts. Multi-Client-Center support on Google Ads. Business Manager system user tokens on Meta. Advertiser switching on TikTok. Identity-walk authentication so one user can manage every account across multiple OAuth identities.
In-house marketing teams at SaaS, lead-gen, and high-consideration B2B brands who need conversion tracking across LinkedIn, Google, and Meta synchronized through GTM and GA4.
If you are running real ad spend and tired of switching tools to do basic optimization work, PaidSync is for you.
Ad platforms (10)
Measurement and tracking platforms (4)
Total: 630+ executable tools across 14 platforms in a single MCP endpoint. The platform rows add up to fewer than 630 because some tools, such as connect, account and cross-channel report tools, belong to no single platform.
New campaigns are built on Google Ads, Meta, LinkedIn and ChatGPT Ads. On the other six ad platforms PaidSync manages the campaigns you create in their own ad managers. PaidSync is honest about the line so your AI assistant never promises an action the platform does not expose.
Quick start
In Claude
- Open PaidSync in Claude's connector directory: claude.ai/directory/connectors/paidsync-mcpp and click Connect.
- Sign in to PaidSync (free, no card) and approve.
- Connect your ad account and ask.
In ChatGPT
- Open Plugins in ChatGPT, search PaidSync and install: PaidSync in ChatGPT.
- Sign in and approve.
- Connect your ad account and ask.
Any other MCP client
Add https://mcp.paidsync.ai/mcp as a custom connector (streamable HTTP) and sign in when your client asks. No API key is needed.
Free for 15 tasks a month with no credit card, then priced by usage, from $99 a month for 600 tasks.
Agent-native architecture with a thin dispatcher
630+ tools is a lot of surface area. Loading every tool schema into the model's context the moment you connect would burn a large share of the context window before you have typed a single prompt.
PaidSync does the opposite. The whole catalog sits behind three meta-tools:
paidsync_contextreturns the live map of what is connected and which capabilities are available.paidsync_tool_detailpulls the schema for one specific tool only when the model needs it.paidsync_execruns the chosen tool.
The model discovers tools on demand and spends the rest of its context budget on your actual work, not on schema it will never call. The 630+ tools are real and executable. They are simply not all dumped into the conversation at once.
Example prompts
Once PaidSync is connected, paste any of these into Claude, ChatGPT, Claude Code or Cursor. See examples/prompts.md for 30+ more.
Cross-channel work
Conversion tracking setup
Account audits
Paid plus organic blends
TikTok
LinkedIn B2B
Agency workflow
How PaidSync compares
For a side-by-side view of PaidSync and other ad connectors, see paidsync.ai/compare.
Pricing
All 14 platforms (Google Ads, Meta, LinkedIn, ChatGPT Ads, TikTok, Microsoft, Snapchat, Reddit, Pinterest, X, GA4, GTM, Search Console, Merchant Center) are on every plan, including Free. MCC and Business Manager support start on Pro.
Start free at paidsync.ai/signup
Architecture
PaidSync is delivered as a hosted streamable-HTTP MCP server. The actual integrations sit on Google Cloud Run with session-affinity routing and per-platform OAuth identity stores in Firestore. The MCP endpoint is the single entry point. Every AI client speaks the same protocol.
How a request flows
- An AI client (for example Claude or ChatGPT) sends a tool call to
https://mcp.paidsync.ai/mcp - PaidSync checks the signed-in user, then walks all connected OAuth identities for the target platform
- The platform-specific client (Google Ads, Meta, LinkedIn, TikTok) executes against the account you named or your active account
- Result returned to the AI client, which surfaces it back to the user in natural language
Per-platform notes
- Google Ads: Uses the Google Ads API with both
google-ads-apilibrary andrestQuery/restMutatepaths for resources the library does not support. Customer ID is required for every call. MCC walking is supported. - Meta (Facebook + Instagram): Long-lived tokens (~60 days). System User tokens supported alongside OAuth user tokens. All IDs are strings (Meta IDs are 18 digits and exceed JS safe integer range).
- LinkedIn: Refresh token model (60-day access, 365-day refresh). Pairs objective with
cost_typeat the campaign level. New campaign groups, campaigns and Sponsored Content ads are created as drafts by default. - TikTok: Advertiser switching supported. App approval status is checked before write operations.
- GTM: Workspace-based change model. Tag, trigger, variable creates happen in a draft workspace, then
publish_gtm_versionships the change. - GA4: Reads reports through the Data API and makes the admin changes you ask for, such as marking key events, through the Admin API.
- Search Console: Read-only in PaidSync. Used for paid plus organic blending against Google Ads keyword data.
Changes and approvals
PaidSync changes campaign settings only. It never moves money or processes payments. New LinkedIn campaign groups, campaigns and Sponsored Content ads are created as drafts by default, so nothing spends until you turn it on. In Claude you can also set each PaidSync tool to "Needs approval" under Settings, Connectors, so every change waits for your click.
Security and authentication
- OAuth 2.0 sign-in for AI clients; no API key to paste
- OAuth flows per platform with state validation
- Tokens encrypted at rest with AES-256-GCM
- Session affinity on Cloud Run (MCP is stateful per session)
- Per-platform scope hygiene: GTM dropped the
delete.containersscope to shrink the consent screen
Full technical docs at paidsync.ai/docs.
Frequently asked questions
Does PaidSync work with ChatGPT, or only Claude?
Both. PaidSync is in Claude's connector directory and in ChatGPT's plugins. It uses the open Model Context Protocol, so it also works with other MCP clients such as Claude Code, Cursor and Codex.
Is there a free tier?
Yes. Free for 15 tasks a month with no credit card, then priced by usage, from $99 a month for 600 tasks. All 14 platforms are included.
Can the AI run wild and burn my ad spend?
PaidSync changes campaign settings only and never moves money. New LinkedIn campaign groups, campaigns and Sponsored Content ads start as drafts, so nothing spends until you turn it on. In Claude you can set each PaidSync tool to "Needs approval", so every change waits for your click.
Can I use PaidSync for client accounts as an agency?
Yes. Google Ads MCC, Meta Business Manager with System User tokens, LinkedIn campaign building, TikTok advertiser switching. You connect once and access every client account from chat.
What is the Model Context Protocol (MCP)?
MCP is an open standard, originally introduced by Anthropic, that lets AI assistants talk to external tools through a standardized interface. PaidSync is an MCP server. Your AI client is an MCP client. The standard means PaidSync works with any AI client that speaks MCP, not just Claude.
How is PaidSync different from other ad connectors?
PaidSync covers ten ad platforms plus Google Analytics 4, Google Tag Manager, Search Console and Merchant Center in one connection, and builds new campaigns on Google Ads, Meta, LinkedIn and ChatGPT Ads. For a side-by-side view, see paidsync.ai/compare.
How is PaidSync different from Google's native Google Ads MCP?
Google's native Google Ads MCP is read-only. PaidSync builds and changes Google Ads campaigns, and does the same on Meta, LinkedIn and ChatGPT Ads. Read-only means the AI can describe what is wrong. PaidSync means the AI can also fix it.
Can PaidSync set up conversion tracking?
Yes. Tell Claude what you want to track and on which page. PaidSync creates the GA4 event, builds the GTM tag and trigger, publishes the workspace when you confirm, and links the conversion back to Google Ads.
What about TikTok?
PaidSync manages existing TikTok campaigns with 13 tools (pause, enable, budgets, bids and names) next to Google, Meta and LinkedIn in one chat, with advertiser switching and performance reporting. We are a TikTok Marketing Partner.
Is my data safe?
Tokens are encrypted at rest with AES-256-GCM, and OAuth state is validated. Changes run as a dry-run preview by default, and deletes and pauses need an explicit confirmation. PaidSync is built by Ahmed Ashraf, who has spent 10+ years in paid media.
Can I use it for a single brand or only for agencies?
Both. DTC brands managing their own spend get the same toolset as agencies managing 100+ clients. MCC and Business Manager support start on the Pro plan.
What happens if PaidSync goes down?
PaidSync runs on Google Cloud Run with auto-scaling and session affinity. Your ad accounts are unaffected. PaidSync is a layer on top of the platform APIs, not a replacement.
Is there an API I can use without an AI assistant?
PaidSync is an MCP server. The MCP interface is the API. If you want raw HTTP access, you can call the MCP endpoint directly with any HTTP client. The underlying ad platform APIs are also accessible via PaidSync's run_gaql_query (Google Ads) and similar passthrough tools.
How does PaidSync handle multiple ad accounts under one OAuth identity?
Identity walking. When you connect Google Ads, PaidSync discovers every account accessible via that OAuth identity, including all sub-accounts under any MCC. When you connect Meta, it discovers every ad account in every Business Manager you have access to. When you connect TikTok, every advertiser. You name the account in your question, switch the active account from chat (set_active_account, set_active_tiktok_advertiser, etc.), or run cross-account audits without switching.
Acknowledgments
PaidSync builds on the open Model Context Protocol introduced by Anthropic. The MCP ecosystem is growing fast. We respect the other servers in this space, including:
Partner credentials
- Founder Ahmed Ashraf is a Google Premier Partner, with $500M+ in ad spend managed across a decade in paid media
- PaidSync (the company) is a Google Partner
- Meta Business Partner
- TikTok Marketing Partner
Documentation and resources
- Run Ads with AI, the overview page
- Google Ads MCP details
- Meta Ads MCP details
- LinkedIn Ads MCP details
- TikTok Ads MCP details
- Comparison: PaidSync and other MCP ad servers
- Blog (60+ articles on AI ad management)
- Docs
- Book a demo
- Changelog and paidsync.ai/changelog
- llms.txt for AI engines and llms-full.txt
Connect
- Website: paidsync.ai
- Email: [email protected]
- LinkedIn: PaidSync
- Instagram: @paidsync
- Founder LinkedIn: Ahmed Ashraf
Contributing
This repo documents the hosted PaidSync MCP service. The MCP server code itself is closed source, but the example configurations, prompt library, and integration guides in this repo are open for contributions. See CONTRIBUTING.md for how to add a new client integration example, a prompt recipe, or a bug fix in the docs.
License
MIT. See LICENSE.
The PaidSync MCP service itself is a proprietary managed service. This repository documents how to use it, with example configurations and integration guides. No source code for the hosted server is included.
Maintained by PaidSync. Operated by Advanced Technology Labs LLC (Wyoming, USA).
Source: README.md at commit 265f1c0
Tools
0Version history
3- v2.3.1LatestOct 1, 2026
- v2.3.0Sep 22, 2026
- v2.1.0Sep 16, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts