Connector · Claude, ChatGPT, any MCP client
Run PPCleaner from Claude, ChatGPT or any AI assistant
The PPCleaner MCP connector lets your AI assistant read and act on your Cleaners. Ask what was blocked last night and what it saved, review the searches waiting for you, block or keep them, undo a block, switch a Cleaner's mode, pause or resume it. Every action shows a preview first and waits for your confirmation.
By Alain Abulafya, founder of PPCleaner · Updated
https://mcp.ppcleaner.com/mcpPaste it where your assistant adds a connector. You sign in with your PPCleaner account; no key to copy.
What you can ask
- What did PPCleaner block last night, and how much did that save?
- Show me the searches waiting for my review on the Shoes account.
- Keep "running shoes size 12" and block the three searches about free shoes.
- Switch the Brand Cleaner to Review first and pause the Shopping one until Monday.
Install it in two minutes
Claude (claude.ai and Claude Desktop)
- Open Customize → Connectors, click + Add, then Add custom connector.
- Name it PPCleaner and paste the server URL above.
- Click Connect, sign in to PPCleaner, then click Allow.
- In a conversation, open + → Connectors and make sure PPCleaner is on.
On Team and Enterprise plans, an owner adds the connector once in Organization settings → Connectors; each member then clicks Connect.
ChatGPT
- Open Settings → Apps → Advanced settings and turn on Developer mode.
- Back in Apps, click Create app, name it PPCleaner and paste the server URL.
- Choose OAuth as the authentication, create the app, sign in to PPCleaner and click Allow.
- Pick PPCleaner from the tools menu of a conversation.
Custom apps need a paid ChatGPT plan and run on ChatGPT web. On Business and Enterprise, a workspace admin may have to allow developer mode first. OpenAI moves these menus from time to time; the steps stay the same.
Claude Code
Run this command, then type /mcp in Claude Code and choose PPCleaner to sign in.
claude mcp add --transport http ppcleaner https://mcp.ppcleaner.com/mcp
Cursor and other MCP clients
Add the server to the client's MCP configuration. Any client that supports remote servers over HTTP with OAuth works; it opens the PPCleaner sign-in on first use.
{
"mcpServers": {
"ppcleaner": {
"url": "https://mcp.ppcleaner.com/mcp"
}
}
}Sign-in and permissions
The connector uses OAuth. Your assistant sends you to app.ppcleaner.com, you sign in the usual way with the link we e-mail you, and a screen names the app asking for access. Nothing happens until you click Allow.
The assistant then sees what you see in PPCleaner, no more: your workspace, your accounts, your Cleaners. You can cut its access at any time from Settings in the app, one connection at a time.
What the connector can do
Read
| Tool | What it does |
|---|---|
| list_accounts | Your connected Google Ads accounts and their currency. |
| list_cleaners | Each Cleaner, its mode, its campaigns and whether it is running. |
| get_savings | Searches blocked and estimated money saved, by account and period. |
| list_pending_searches | Searches waiting for your decision, grouped by intent. |
| get_history | What was blocked or kept, when, and by which Cleaner. |
| explain_decision | Why a search was blocked or kept, in plain words. |
Act, after a preview and your confirmation
| Tool | What it does |
|---|---|
| block_searches | Adds searches as negative keywords on the right campaigns. |
| keep_searches | Marks searches as good so they are never blocked. |
| undo_blocks | Removes a negative keyword PPCleaner added. |
| set_cleaner_mode | Switches a Cleaner between Autopilot, Review first and My rules. |
| pause_cleaner | Stops a Cleaner from running. |
| resume_cleaner | Starts a paused Cleaner again. |
Built so a chat cannot hurt an account
- Every action first returns a preview of what will change. Nothing is written to Google Ads until you confirm.
- The same guardrails as the app apply: protected terms, your rules and your subscription are checked on our servers, every time.
- Every block can be undone, from the app or from the assistant.
- Search terms are treated as data, never as instructions. A search cannot make the assistant do something you did not ask.
Frequently asked questions
Is the PPCleaner MCP connector free?
The connector is included with every PPCleaner plan and the free trial. Reading works on any account; actions need an active trial or subscription, exactly as in the app.
Can the assistant change my Google Ads account without asking?
No. Each action returns a preview, and the change is applied only after you confirm it in the conversation. Blocks stay reversible with undo_blocks or from the app.
What data does the assistant see?
Only what your PPCleaner account sees: your accounts, Cleaners, searches and history. It never sees your Google password or the Google access token, which stay encrypted on our servers.
How do I disconnect an assistant?
Open Settings in the PPCleaner app and revoke the connection. The assistant loses access immediately.
Which assistants does it work with?
Claude (web, desktop and Claude Code), ChatGPT with developer mode, Cursor, and any client that supports remote MCP servers with OAuth.
PPCleaner
No PPCleaner account yet? Start the trial, connect Google Ads, then plug your assistant in.
Start 7 days free