# Adverity

> Adverity is a marketing data intelligence platform that integrates, harmonizes, transforms, and analyzes marketing and advertising data from hundreds of sources (Google Ads, Facebook Ads, LinkedIn Ads, and more) into a single governed data foundation. It exposes a programmatic Management API on three surfaces (/api/, /api/v1/, /api/v2/) and a hosted remote Model Context Protocol (MCP) server at https://mcp.eu.adverity.com/mcp (beta) for AI-driven pipeline control. Adverity is ISO/IEC 27001 certified, SOC 2 Type 2 audited, and GDPR/UK GDPR/CCPA/HIPAA compliant.

## APIs

- [Adverity Management API](https://docs.adverity.com/guides/management-api/introduction-management-api.html): Manage datastreams, authorizations, fetches, jobs, errors, transformations, data mappings, mapping tables, destinations, bindings, workspaces, users, notifications and usage metrics. Per-instance host — the base URL is https://{{INSTANCE}}/api/, where INSTANCE is your own Adverity hostname (for example my-organization.datatap.adverity.com). Authenticate with `Authorization: Token {{KEY}}` or `Authorization: Bearer {{KEY}}`. No OpenAPI is published; the endpoint table plus a public Postman collection are the contract.
- [Adverity MCP server](https://docs.adverity.com/guides/mcp/mcp-setup.html): Remote MCP endpoint https://mcp.eu.adverity.com/mcp, guarded by OAuth 2.0 (authorization code + refresh, PKCE S256, dynamic client registration). You sign in with your Instance URL and MAPI key, so the agent inherits exactly that key's scopes. 12 tools; all write operations use a two-phase preview-then-confirm pattern. Beta, available to selected customers.

## Docs

- [Documentation home](https://docs.adverity.com/index.html)
- [Getting started with the Management API](https://docs.adverity.com/guides/management-api/introduction-management-api.html)
- [Authorizing to the Management API (keys, scopes, rotation)](https://docs.adverity.com/guides/management-api/authorizing-to-management-api.html)
- [Collecting data via the Management API](https://docs.adverity.com/guides/management-api/collecting-data-through-management-api.html)
- [Managing pulling mode and smart schedule](https://docs.adverity.com/guides/management-api/managing-datastreams-smart-schedule.html)
- [Managing webhooks](https://docs.adverity.com/guides/administration/webhooks.html)
- [Using Adverity MCP (beta)](https://docs.adverity.com/guides/mcp/using-mcp.html)
- [Setting up Adverity MCP](https://docs.adverity.com/guides/mcp/mcp-setup.html)
- [Release notes (weekly, {year}.{week})](https://docs.adverity.com/reference/release-notes/release-notes.html)
- [Incidents](https://docs.adverity.com/reference/release-notes/incidents.html)
- [Data security & compliance](https://www.adverity.com/analytics-platform/data-security)

## Tools

- [Postman collection — Adverity Management API](https://documenter.getpostman.com/view/4861982/SWT7CKex)
- MCP tools (12): manage_datastream, manage_authorization, manage_fetch, manage_error, manage_extract, manage_workspace, manage_transformation, manage_mapping_table, manage_data_mapping, manage_destinations, manage_user, manage_notifications.

## Agent notes

- No OpenAPI, no AsyncAPI, no A2A agent card, no security.txt, no llms.txt served by Adverity — this file is generated by API Evangelist from the provider's public documentation.
- No idempotency-key contract. Several documented operations are FULL REPLACEMENTS: bulk column mapping unmaps any source column you omit, and updating authorization account permissions disables any account you omit.
- No rate limits are published for the Management API; Adverity advises running one task at a time. The only acknowledged limit is IP-based, on the unauthenticated GET /api/v1/auth/keys/introspect/ route.
- Errors on legacy /api/ client-error responses use a custom `{ detail, errors }` envelope, not RFC 9457. 5xx responses and the v1/v2 surfaces are excluded from it.
- No deprecation policy and no Sunset headers: release 2026.33 removed two Amazon Advertising endpoints "without deprecation".
- The only /.well-known/ documents Adverity serves are the OAuth authorization-server and protected-resource metadata on mcp.eu.adverity.com.

## Repository artifacts

- [MCP server manifest](mcp/adverity-mcp.yml)
- [MCP tool crosswalk](mcp/adverity-tool-crosswalk.yml)
- [Authentication profile](authentication/adverity-authentication.yml)
- [API key scopes](scopes/adverity-scopes.yml)
- [API conventions](conventions/adverity-conventions.yml)
- [Error envelope](errors/adverity-problem-types.yml)
- [Rate limits](rate-limits/adverity-rate-limits.yml)
- [Webhook event catalog](asyncapi/adverity-webhooks.yml)
- [Data model](data-model/adverity-data-model.yml)
- [Changelog](changelog/adverity-changelog.yml)
- [Lifecycle](lifecycle/adverity-lifecycle.yml)
- [Plans and pricing](plans/adverity-plans-pricing.yml)
- [Packages](packages/adverity-packages.yml)
- [Conformance & compliance](conformance/adverity-conformance.yml)
- [Domain security](security/adverity-domain-security.yml)
- [Vulnerability disclosure](security/adverity-vulnerability-disclosure.yml)
- [Well-known index](well-known/adverity-well-known.yml)

## Optional

- [Website](https://www.adverity.com/)
- [Sign in](https://app.adverity.com/)
- [Pricing (quote only — no published tiers)](https://www.adverity.com/pricing)
- [Blog](https://www.adverity.com/blog)
- [Product support](https://www.adverity.com/resources/product-support)
- [Terms of use](https://www.adverity.com/terms-of-use)
- [Privacy notice](https://www.adverity.com/privacy-notice)