paid-ads-integrations git:20260813.0906da3A

Immutable. This exact content is served forever at /api/v1/blob/15b9df9a76a2c0b4.

---
name: paid-ads-integrations
description: Discover, connect, and verify NotFair paid-ad integrations and their actual capabilities. Use when asked to connect an ad account, configure an ads MCP, check available tools, troubleshoot access, or determine whether NotFair can read or change a platform.
argument-hint: "<platform or connection issue>"
---

# Paid Ads Integrations

Read `../shared/operating-contract.md`. Treat tool discovery as the source of truth; product documentation describes intent, not the current session's authorization.

## Verify before promising

1. Inspect the available tool list and use the Google or Meta shared preamble when that surface is requested. For X Ads and LinkedIn Ads, resolve the platform-specific connector and require a harmless account/setup read before claiming access.
2. Confirm OAuth/account access with a harmless account-list or read operation when the connector exposes one.
3. Record the exact platform, selected account, accessible date range, and whether the surface is read-only or mutation-capable.
4. If authorization fails, state the error and give the documented connection path. Do not retry a destructive operation or fall back to another account.

## Capability map

| Platform | NotFair path | Safe response when unavailable |
|---|---|---|
| Google Ads | `https://notfair.co/api/mcp/google_ads`; use the Google shared preamble | Connect/re-authenticate, then use the Google skills |
| Meta Ads | `https://notfair.co/api/mcp/meta_ads`; use the Meta shared preamble | Connect/re-authenticate, then use the Meta skills |
| X Ads | `https://notfair.co/api/mcp/x_ads`; resolve `~~x-ads` | Connect/re-authenticate, then use `/notfair:paid-ads-x` |
| LinkedIn Ads | `https://notfair.co/api/mcp/linkedin_ads`; resolve `~~linkedin-ads` | Connect/re-authenticate, then use `/notfair:paid-ads-linkedin` |
| TikTok, Amazon, ChatGPT Ads | No first-party NotFair surface declared by this plugin | Request a verified connector or export; stay plan/review-only |

Never invent a router, endpoint, tool name, account ID, or platform capability. Quote prices, quotas, and platform eligibility only from current official documentation when a user asks; do not infer them from a plan or another connector.