adcp-brand

AdCP Brand Protocol

This skill enables you to execute the AdCP Brand Protocol with brand agents. The Brand Protocol provides access to brand identity, creative guidelines, and licensable rights (talent, IP, content).

Buyer-side basics — idempotency replay, oneOf variants, async status:'submitted' polling, error recovery from adcp_error.issues[] — live in skills/call-adcp-agent/SKILL.md. This skill covers per-task semantics only.

Overview

The Brand Protocol provides 4 standardized tasks:

Task	Purpose	Response Time
get_brand_identity	Get brand identity and guidelines	~1-3s
get_rights	Search licensable rights	~1-5s
acquire_rights	Acquire rights for a campaign	~1-10s
update_rights	Modify an existing grant	~1-5s

Typical Workflow

Brand Identity Lookup

1. Get identity: get_brand_identity with brand domain and optional field filter
2. Use data: Apply colors, logos, tone, guidelines to creative generation

Rights Licensing

1. Search rights: get_rights with natural language query and use types
2. Review options: Evaluate matches by pricing, availability, compatibility
3. Acquire: acquire_rights with selected pricing option and campaign details
4. Manage: update_rights to extend, adjust caps, or pause/resume

---

Task Reference

get_brand_identity

Get brand identity data from a brand agent.

Request:

{
  "brand_id": "athlete-jane-doe",
  "fields": ["description", "logos", "colors", "tone"],
  "use_case": "creative_production",
  "authorized": true
}

Key fields:

• brand_id (string, required): Brand identifier within the agent's roster
• fields (array, optional): Sections to include — description, industry, keller_type, logos, colors, fonts, visual_guidelines, tone, tagline, voice_synthesis, assets, rights. Omit for all.
• use_case (string, optional): Intended use — endorsement, voice_synthesis, likeness, creative_production, media_planning
• authorized (boolean, optional): Sandbox only — simulate authorized access to see protected fields. Real agents use OAuth. Default false.

Response contains:

• brand: Brand identity object with requested fields
• Public fields (always available): description, industry, logos (public subset)
• Protected fields (require authorization): colors, fonts, tone, voice_synthesis, visual_guidelines, full assets

---

get_rights

Search for licensable rights (talent, IP, content) from a brand agent.

Request:

{
  "query": "Dutch athlete for restaurant brand in Amsterdam, budget 400 EUR/month",
  "uses": ["likeness", "endorsement"],
  "buyer_brand": {
    "domain": "restaurant.nl"
  },
  "countries": ["NL"],
  "include_excluded": false
}

Key fields:

• query (string, required): Natural language description of desired rights
• uses (array, required): Rights uses — likeness, voice, name, endorsement
• buyer_brand (object, optional): Buyer brand for compatibility filtering — { domain, brand_id }
• countries (array, optional): Countries where rights are needed (ISO 3166-1 alpha-2)
• brand_id (string, optional): Search within a specific brand only
• include_excluded (boolean, optional): Include filtered-out results with reasons. Default false.

Response contains:

• rights: Array of matching rights offerings with:
  • rights_id: Use in acquire_rights
  • brand_id, name, description: Who/what the rights cover
  • uses: Available use types
  • pricing_options: Array with pricing_option_id, price, currency, period
  • availability: Geographic and temporal restrictions
  • exclusions: Any brand/category conflicts

---

acquire_rights

Acquire rights from a brand agent for a campaign.

Request:

{
  "rights_id": "rights_jane_doe_endorsement",
  "pricing_option_id": "monthly_standard",
  "buyer": {
    "domain": "restaurant.nl"
  },
  "campaign": {
    "description": "Social media campaign featuring athlete endorsement for Amsterdam restaurant launch",
    "uses": ["likeness", "endorsement"],
    "countries": ["NL"],
    "estimated_impressions": 500000,
    "start_date": "2025-03-01",
    "end_date": "2025-06-30"
  }
}

Key fields:

• rights_id (string, required): From get_rights response
• pricing_option_id (string, required): Selected pricing option
• buyer (object, required): Buyer brand identity — { domain, brand_id }
• campaign (object, required): Campaign details for rights clearance
  • description (string, required): How the rights will be used
  • uses (array, required): Rights uses for this campaign
  • countries (array, optional): Campaign countries
  • estimated_impressions (integer, optional): Estimated total impressions
  • start_date, end_date (string, optional): Campaign dates (YYYY-MM-DD)

Response contains:

• status: acquired, pending_approval, or rejected
• rights_grant_id: Grant identifier (if acquired)
• generation_credentials: Credentials for AI generation (voice synthesis, likeness, etc.)
• rejection_reason: Why the request was rejected (category conflict, exclusivity, etc.)

---

update_rights

Update an existing rights grant — extend dates, adjust impression caps, or pause/resume.

Request:

{
  "rights_id": "grant_abc123",
  "end_date": "2025-09-30",
  "impression_cap": 1000000,
  "paused": false
}

Key fields:

• rights_id (string, required): Rights grant identifier from acquire_rights
• end_date (string, optional): New end date (must be >= current end date)
• impression_cap (number, optional): New impression cap (must be >= current)
• paused (boolean, optional): Pause or resume the grant

---

Key Concepts

Public vs Protected Fields

Brand agents distinguish between public and protected data:

• Public: Available without authorization — basic description, industry, public logos
• Protected: Requires OAuth or authorized flag — colors, fonts, tone, voice synthesis credentials, full asset library

Rights Use Types

• likeness: Use of a person's visual likeness (photos, AI-generated images)
• voice: Voice synthesis or audio recording rights
• name: Use of a person's name in advertising
• endorsement: Endorsement/testimonial rights

Rights Clearance

acquire_rights checks:

1. Brand/category compatibility (no competitor conflicts)
2. Geographic availability
3. Temporal availability
4. Existing exclusivity agreements

Results: acquired (immediate), pending_approval (human review), or rejected (with reason).

---

Error Handling

Common error codes:

• BRAND_NOT_FOUND: Invalid brand_id
• RIGHTS_NOT_FOUND: Invalid rights_id
• PRICING_OPTION_NOT_FOUND: Invalid pricing_option_id
• CATEGORY_CONFLICT: Buyer brand conflicts with existing agreements
• GEOGRAPHIC_RESTRICTION: Rights not available in requested countries
• AUTHORIZATION_REQUIRED: Protected fields require OAuth