Read your Ad Atlas research and connected-account advertising analytics in an AI assistant.
Framework exposes a stateless Streamable HTTP MCP server at https://api.newform.ai/mcp. Requests use POST with a bearer access token. GET and DELETE return 405 because the server does not maintain streaming sessions.
Use OAuth authorization code with PKCE S256. The unauthorized response identifies the protected-resource metadata document, which identifies the authorization server. Complete Framework's consent screen for the organization you intend to connect. Tokens must target the Framework MCP resource. Never share an internal API key or paste an account token into an assistant conversation.
Sign in with a current Framework account. Existing Ad Atlas reports granted to your verified email can be read without a paid plan. Connected-account analytics separately require an existing Framework entitlement and the requested organization and feature permissions. Directory availability depends on provider review and rollout.
list_organizations to find an accessible organization and its connected advertising platforms.list_metrics before query_ad_metrics. Specify the dates, metrics, grouping and filters. Metrics are fetched from connected ad platforms; preserve their currency and attribution context.list_creative_testing_batches and get_creative_testing_batch to review test outcomes. Separate observed results from recommendations and incomplete evidence.For a new report, preview request_atlas_report, review the privacy policy and confirm the request. A verified company email is required. One free request per company domain is available, with four new connector requests per day and at most four pending requests across the service. Repeated requests reuse the existing job, including failed requests. Check progress with get_atlas_request_status; polling starts no work.
Start with get_framework_access to understand account capabilities. Call list_atlas_reports, then get_atlas_report with a returned report ID. The report contains the same aggregate findings as the Atlas viewer: creative format mix, diversity, coverage and gaps. Preserve its snapshot date and caveats. Creative diversity is not evidence of winning ads, profitability or causation. Compatible MCP Apps hosts also render the stored creative map and findings in chat. Map interactions run locally without model calls.
These reads reuse existing findings and narratives. They do not generate reports, refresh ad collections or run new paid analysis. Report access is personal to your verified email; another person at the same company does not inherit it. Revoked and expired grants cannot be read. See the access reference for setup.
The service allows 60 requests per minute per connected principal. Atlas listings return the 20 most recent report grants. The public connector does not launch ads, change budgets, read Drive folders, upload media, refresh reports or initiate subscription checkout.
Requested metrics, creative information and test results are returned to the connected assistant provider. Atlas tools return aggregate report findings and anonymous comparison-map positions, and exclude private media, other clients' identities and advertising-account performance. Disconnect the assistant connection in its settings and contact Framework support for account data requests.