@adcp/sdk API Reference - v14.0.0-beta.6
    Preparing search index...

    Interface AdcpCapabilities

    Normalized capabilities response that works for both v2 and v3 servers

    interface AdcpCapabilities {
        version: "v3" | "v2";
        majorVersions: AdcpMajorVersion[];
        supportedVersions?: string[];
        buildVersion?: string;
        servedVersion?: string;
        protocols: AdcpProtocol[];
        specialisms?: string[];
        features: MediaBuyFeatures;
        mediaBuyLifecycleTools?: string[];
        discoveredTools?: string[];
        account?: AccountCapabilities;
        creative?: CreativeCapabilities;
        idempotency?: IdempotencyCapabilities;
        extensions: string[];
        experimentalFeatures?: string[];
        publisherDomains?: string[];
        channels?: string[];
        countries?: string[];
        lastUpdated?: string;
        _synthetic: boolean;
        _raw?: Record<string, unknown>;
    }
    Index

    Properties

    version majorVersions supportedVersions? buildVersion? servedVersion? protocols specialisms? features mediaBuyLifecycleTools? discoveredTools? account? creative? idempotency? extensions experimentalFeatures? publisherDomains? channels? countries? lastUpdated? _synthetic _raw?

    Properties

    version: "v3" | "v2"

    Detected version ('v2' or 'v3')

    majorVersions: AdcpMajorVersion[]

    Array of supported major versions (e.g., [2] or [2, 3]).

    Use supportedVersions for release-precision negotiation. Removed in AdCP 4.0 per spec PR adcontextprotocol/adcp#3493. Continues to be emitted alongside the new field through 3.x.

    supportedVersions?: string[]

    Array of supported AdCP releases at release precision ('3.0', '3.1', '3.1.0-beta.1'). Stable releases use MAJOR.MINOR; pre-releases use the full pre-release tag. Set when the seller is on AdCP 3.1+ per spec PR adcontextprotocol/adcp#3493. undefined on legacy 3.0-only sellers.

    buildVersion?: string

    Full semver build of the seller's released AdCP version (e.g. '3.1.2', '3.1.0-beta.1+sha.abc'). Advisory — patch differences within the same release-precision are non-breaking by spec convention. undefined on legacy 3.0-only sellers.

    servedVersion?: string

    Release the seller actually selected for the capabilities request. This is the top-level response adcp_version, not the seller's build version or the complete set it advertises.

    protocols: AdcpProtocol[]

    Supported protocols

    specialisms?: string[]

    Public specialism ids declared by this agent

    features: MediaBuyFeatures

    Media buy specific features

    mediaBuyLifecycleTools?: string[]

    Compact media-buy lifecycle tools advertised by AdCP 3.2+ sellers.

    discoveredTools?: string[]

    Tool names observed from authoritative protocol discovery.

    account?: AccountCapabilities

    Account management capabilities

    creative?: CreativeCapabilities

    Creative protocol capabilities

    idempotency?: IdempotencyCapabilities

    Idempotency replay capabilities (v3 sellers declaring adcp.idempotency)

    extensions: string[]

    Supported extension namespaces (e.g., 'scope3', 'garm')

    experimentalFeatures?: string[]

    Experimental AdCP surfaces this agent implements. Dot-namespaced feature ids (e.g. brand.rights_lifecycle, governance.campaign, trusted_match.core) sellers declare when they opt into surfaces whose schemas carry x-status: experimental. Consumers should gate any reliance on experimental fields on presence of the matching id here.

    See https://adcontextprotocol.org/docs/reference/experimental-status

    publisherDomains?: string[]

    Publisher domains covered by this agent

    channels?: string[]

    Supported advertising channels

    countries?: string[]

    Primary countries in the agent's portfolio, not a declaration of geo-targeting support

    lastUpdated?: string

    Last updated timestamp (if provided by server)

    _synthetic

    _synthetic: boolean

    Whether this was synthesized from tool list (v2) or from get_adcp_capabilities (v3)

    Optional_raw

    _raw?: Record<string, unknown>

    Raw response from get_adcp_capabilities (only for v3)

    Settings

    Member Visibility

    On This Page

    Properties