Skip to content
Get MCP AdsGet MCP Ads, home
Start free

Authentication

OAuth 2.1 with dynamic client registration, and what each advertising scope grants.

How a client connectsLink to this section

The endpoint speaks OAuth 2.1. Given only the URL, a client bootstraps itself: it receives a 401 carrying a WWW-Authenticate header, reads the protected resource metadata, registers itself, and walks the authorisation flow with PKCE.

DocumentURL
Protected resource metadata (RFC 9728)https://mcp.getmcpads.com/.well-known/oauth-protected-resource
Authorization server metadata (RFC 8414)https://mcp.getmcpads.com/.well-known/oauth-authorization-server
Dynamic client registration (RFC 7591)Advertised in the metadata above
MCP manifesthttps://www.getmcpads.com/.well-known/mcp

What the gateway asks each platformLink to this section

A scope is what the platform grants. It is not what the gateway does with it. Where a platform publishes no read-only scope, the restriction is enforced here instead: on the Free plan no write tool is announced, and calling one is refused before it reaches the platform.

Requested scopes, by source

SourceScopeGrantsWrites
Meta Adsads_readRead Meta campaigns, insights, creatives and audiences.No
Meta Adsads_managementPause, resume and change budgets on Meta campaigns, ad sets and ads. Only reachable on a paid plan.Yes
Pinterest Adsads:readRead Pinterest campaigns, ad groups, ads and analytics.No
Pinterest Adsads:writePause, resume and change budgets on Pinterest campaigns. Only reachable on a paid plan.Yes
Google Adshttps://www.googleapis.com/auth/adwordsRead and write on Google Ads. Google publishes no read-only alternative, so read-only enforcement is done by this gateway, not by Google.Yes
TikTok Adsnone in the authorization URLTikTok attaches permissions to the app in Business Center.n/a
Search Consolehttps://www.googleapis.com/auth/webmasters.readonlyRead Search Console performance, index coverage and sitemaps. Cannot modify anything.No
Google Analytics 4https://www.googleapis.com/auth/analytics.readonlyRead GA4 reports, metadata and property configuration. Cannot modify anything.No
Esc

Type to search