Documentation

Everything you need to connect your ad accounts to AI and start managing campaigns through conversation.

Quick Start

Get PaidSync running in under 2 minutes. Four steps — no code, no downloads.

1

Create your account

Sign up at paidsync.ai/signup with Google or email. You start on the free plan with 15 tool calls per month.

2

Copy your MCP server URL

After signing in, go to your Dashboard → Connections page. Your unique MCP URL is displayed there. Copy it.

3

Add PaidSync to your AI assistant

Paste the MCP URL into your AI's settings. See the Connect Your AI section for platform-specific instructions.

4

Connect your ad accounts

On the Connections page, click Connect Google Ads or Connect Meta Ads. Authorize via OAuth — PaidSync never sees your password.

That's it. Open your AI assistant and say "Show me my Google Ads campaigns" — PaidSync is live.

Connect Your AI

PaidSync is an MCP server — a way to give your AI new abilities. You paste one URL into your AI's settings and it gains full access to your ad accounts. No plugins, no code, no downloads.

Claude (claude.ai)

The fastest way to get started — works directly in your browser.

  1. Go to claude.ai → click your name (bottom-left) → Settings
  2. Click IntegrationsAdd MCP Server
  3. Paste your MCP URL from the PaidSync dashboard
  4. Click Add — done

Start a new chat and PaidSync tools are available immediately. Try: "Show me my campaigns."

ChatGPT

  1. Open ChatGPT → SettingsTools & Plugins
  2. Click Add MCP Server
  3. Paste your MCP URL and click Save

Claude Desktop App

If you prefer the desktop app over the browser:

  1. Open Claude Desktop → SettingsDeveloperEdit Config
  2. Add this to the config file:
{
  "mcpServers": {
    "paidsync": {
      "url": "YOUR_MCP_URL_HERE"
    }
  }
}

Save and restart Claude Desktop.

Other AI tools

PaidSync works with any AI that supports MCP — Cursor, Windsurf, Claude Code, and more. Just add your MCP URL in the tool's MCP settings. No API key needed — the URL itself is your authentication.

Connect Google Ads

PaidSync connects to Google Ads through OAuth 2.0. Your credentials are never shared with PaidSync or your AI.

1

Go to Connections

In your PaidSync dashboard, navigate to Connections and click Connect Google Ads.

2

Authorize with Google

A Google sign-in window opens. Sign in with the Google account that has access to your Google Ads account. Grant PaidSync permission to manage your campaigns.

3

Select your account

If you have multiple Google Ads accounts or an MCC, select the account you want to manage. You can connect multiple accounts.

Once connected, your AI can immediately start managing campaigns, keywords, ads, and more.

Connect Meta Ads

PaidSync supports two connection methods for Meta (Facebook & Instagram) ads.

Option 1: OAuth (Personal accounts)

  1. Go to ConnectionsConnect Meta Ads
  2. Sign in with your Facebook account
  3. Grant access to your ad accounts

OAuth tokens expire after 60 days — you'll need to reconnect when prompted.

Option 2: System User Token (Agencies)

For agencies managing multiple clients, use a System User permanent token:

  1. Open Meta Business ManagerBusiness SettingsSystem Users
  2. Create a System User (Admin role) and assign it to your ad accounts
  3. Generate a token with ads_management and ads_read permissions
  4. Paste the token in your PaidSync dashboard under Connections → Meta Ads → Agency Token

System User tokens never expire — no need to reconnect every 60 days.

Meta Ads Tools

37+ tools for managing Facebook and Instagram advertising.

Campaigns & Ad Sets

Create campaigns with CBO or ad set budgets. Configure targeting, placements, budgets, and schedules. Advantage+ placements supported.

Ads & Creatives

Create ads with images. Manage creatives with validation before publishing.

Audiences

Build custom audiences from customer lists, website visitors, or app activity. Create lookalike audiences for prospecting.

Reporting & Pacing

Performance breakdowns by age, gender, placement, device, and country. Monitor daily spend pacing and budget utilization.

Example Commands

PaidSync works through natural conversation. Here are real examples of what you can ask your AI to do.

Creating campaigns

"Create a new Search campaign called 'Spring Sale' targeting 'running shoes' and 'athletic shoes' with a $50/day budget"
Creates a live Google Ads Search campaign with keywords and budget.
"Launch a Meta lead generation campaign targeting 25-44 year olds in New York interested in fitness"
Creates a Meta Ads campaign with demographic and interest targeting.

Optimizing performance

"Pause all ad groups with ROAS below 2x in the last 30 days"
Finds underperforming ad groups and pauses them.
"Add negative keywords from last week's search terms report that have a CTR below 1%"
Analyzes search terms and blocks wasteful queries.
"Increase the budget on Campaign D by 20%"
Immediately adjusts the daily budget in your ad account.

Reporting

"Show me this week's performance for all campaigns — spend, conversions, CPA, and ROAS"
Pulls real-time performance data across all campaigns.
"Which campaigns are spending the most with the lowest conversion rate?"
Identifies waste by ranking campaigns by spend vs. performance.
"Break down last month's Meta performance by age group and placement"
Returns detailed demographic and placement analytics.

Account management

"Add sitelink extensions to Campaign A with links to our pricing, features, and demo pages"
Creates and attaches sitelink extensions to a campaign.
"Create a lookalike audience based on our top 1,000 converters from Q1"
Builds a lookalike audience in Meta from your best customers.

Billing & Plans

PaidSync offers four plans. Every plan includes both Google Ads and Meta Ads.

Plan Monthly Annual Tool Calls
LimitedFreeFree15/month
Plus$49/mo$490/yr ($41/mo)150/month
Pro$99/mo$999/yr ($83/mo)600/month
Max$199/mo$2,000/yr ($167/mo)4,000/month

What counts as a tool call?

Each action your AI executes counts as one tool call — creating a campaign, pulling a report, pausing an ad group, adding a keyword. Browsing the tool list or reading descriptions does not count.

Running out of calls

When you exhaust your monthly allowance, you can top up instantly from your dashboard (charges one plan's worth of additional calls) or upgrade to a higher plan.

Upgrading and downgrading

Upgrades take effect immediately — you're charged a prorated amount and your call pool increases right away. Downgrades are scheduled for your next renewal so you keep your current allocation until the end of the billing cycle.

Security

PaidSync is designed so that your ad accounts, credentials, and data remain secure at every step.

OAuth 2.0

All ad platform connections use standard OAuth. PaidSync never sees or stores your Google or Meta password.

Encrypted Storage

OAuth tokens are encrypted at rest using AES-256-GCM. They're only decrypted in memory at the moment of an API call.

No Data Storage

PaidSync does not store your ad performance data. Every report is fetched in real-time from the ad platform when you request it.

API Key Isolation

Each user gets a unique API key embedded in their MCP URL. Never share your MCP URL publicly — it is your authentication.

Frequently Asked Questions

Which AI assistants work with PaidSync?

Any AI assistant that supports the Model Context Protocol (MCP). This includes Claude Desktop, claude.ai, ChatGPT, and other MCP-compatible tools like Cursor, Windsurf, and Claude Code.

Can I connect multiple ad accounts?

Yes. You can connect multiple Google Ads accounts (including MCC manager accounts) and multiple Meta ad accounts under a single PaidSync account.

Is my ad account data safe?

Yes. PaidSync uses OAuth 2.0 — your ad platform credentials are never shared with the AI. OAuth tokens are encrypted at rest. PaidSync does not store your ad performance data.

What happens when I exceed my call limit?

You'll see a notification in your dashboard. You can instantly top up for more calls or upgrade your plan. Your ad accounts remain connected — you just can't execute new actions until you add more calls.

Can PaidSync break my campaigns?

PaidSync executes exactly what your AI tells it to. Your AI assistant will confirm actions before executing them. You can always review changes in your Google Ads or Meta Ads dashboard.

Do I need technical knowledge?

No. PaidSync works through natural language. Just describe what you want — "create a campaign," "show me performance," "pause this ad group" — and the AI handles the execution.

How do I cancel?

Go to your Dashboard → Settings → Danger Zone → Cancel Plan. Your current plan stays active until the end of your billing cycle. Your ad accounts remain connected on the free plan.

Need Help?

Email us at support@paidsync.ai — we respond within 24 hours. Or book a demo for a guided walkthrough.