On this page

control

Planes

Components

Version

per-repository; see components

Licence

Mixed — Apache-2.0, AGPL-3.0, CC BY

AAMP component · reference implementation

agentic-direct

agentic-direct is an AAMP reference implementation repository from IAB Tech Lab. A2A and MCP wrapper over IAB OpenDirect 2.1, with a demo executor and browser client.

Source: IABTechLab/agentic-direct

Version: untagged (915bda9)
Commit: 915bda98
Kind: reference implementation
Substance: partial
Listed in the hub README: Yes

agentic-direct on 12 August 2026: version, kind, substance grade and hub listing. Substance is an editorial grade rather than a measurement, on the ranking test.

What this repository defines

40 object definitions. One real artifact inside a demo: opendirect.json, a manifest of 40 OpenDirect, AdCOM and OpenRTB object definitions. Its README calls that file an OpenAPI spec twice, the file has no openapi key, and the MCP server it feeds answers every tool call with generateMockResponse.

The objects, field by field

These come from the schema and interface files this repository checks in, under the names the source files use.

OpenDirect.Account 5 fields

Defines a buyer-advertiser relationship for managing orders

OpenDirect.Account fields — 5 fields, 3 required
Field	Type	Required	Description
`id`	string		System-generated opaque ID
`advertiserid`	string	required	Organization ID acting as advertiser
`buyerid`	string	required	Organization ID acting as buyer/agency
`name`	string	required	Account display name
`ext`	object		Provider-defined extension data

OpenDirect.Order 15 fields

Specifies campaign plan with dates, budget, and currency for all line items

OpenDirect.Order fields — 15 fields, 4 required

Field	Type	Required	Description
`id`	string		System-generated opaque ID
`name`	string	required	Order display name
`accountid`	string	required	Account ID owning the order
`publisherid`	string	required	Publisher ID providing this order
`brand`	string		Brand name being advertised
`cat`	array		IAB Tech Lab Content Taxonomy categories
`currency`	string	required	ISO-4217 currency code
`budget`	number		Estimated budget (directional)
`orderstatus`	string
`packageonly`	boolean		Whether inventory is only available as package
`preferredbillingmethod`	string
`startdate`	string		Order start date (ISO 8601)
`enddate`	string		Order end date (ISO 8601)
`orderexpirydate`	string		Date when reserved inventory expires
`contacts`	array

OpenDirect.Line 19 fields

Line items providing details about products being booked

OpenDirect.Line fields — 19 fields, 7 required

Field	Type	Required	Description
`id`	string
`name`	string	required
`orderid`	string	required
`productid`	string	required
`bookingstatus`	string
`statechangereason`	string
`startdate`	string	required
`enddate`	string	required
`ratetype`	string	required
`rate`	number		Price per unit (determined at save)
`quantity`	integer	required	Requested quantity (impressions for CPM)
`cost`	number		Projected cost based on quantity and rate
`comment`	string
`frequencycount`	integer		Max times user sees ads in interval
`frequencyinterval`	string
`reservedexpirydate`	string
`targeting`	object		User segment targeting
`pmp`	object
`ext`	object

OpenDirect.Product 31 fields

Product catalog item from ad placement to Run of Network

OpenDirect.Product fields — 31 fields, 7 required

Field	Type	Required	Description
`id`	string	required
`publisherid`	string	required
`name`	string	required
`description`	string
`activedate`	string
`allownocreative`	boolean		Allow booking without creative assigned
`currency`	string	required
`baseprice`	number	required	Base retail price (not rate card)
`deliverytype`	string
`estdailyavails`	string		Estimated daily impression range
`domain`	string		Domain name
`icon`	string		URL to 150x150 thumbnail icon (max 10KB)
`languages`	array		ISO-639-1 language codes
`leadtime`	integer		Days from today that line can begin
`minspend`	number		Minimum order value
`minflight`	integer		Minimum booking days
`maxflight`	integer		Maximum booking days
`producttags`	array		Search tags
`ratetype`	string	required
`adunit`	object	required
`alladunits`	integer		Whether all child ad units served together
`retirementdate`	string
`tz`	string		Product timezone
`url`	string		URL to creative requirements spec
`regs`	object
`device`	object
`geo`	object
`data`	object
`source`	object
`pmp`	object
`ext`	object

OpenDirect.Creative 9 fields

Ad creative to be displayed for order lines

OpenDirect.Creative fields — 9 fields, 2 required
Field	Type	Required	Description
`id`	string
`accountid`	string	required
`name`	string
`language`	string
`creativeasset`	object	required
`clickurl`	string
`iqgmediarating`	integer		IQG 2.1 media rating
`creativeapprovals`	array
`ext`	object

OpenDirect.Assignment 6 fields

Associates a creative with an order line

OpenDirect.Assignment fields — 6 fields, 2 required
Field	Type	Required	Description
`id`	string
`creativeid`	string	required
`placementid`	string	required
`status`	string
`weight`	integer		Rotation weight (must sum to 100)
`ext`	object

OpenDirect.Organization 11 fields

Represents an advertiser, agency, or publisher

OpenDirect.Organization fields — 11 fields, 2 required
Field	Type	Required
`id`	string
`address`	object
`contacts`	array	required
`disapprovalreason`	string
`fax`	string
`cat`	array
`name`	string	required
`phone`	string
`status`	string
`url`	string
`ext`	object

OpenDirect.Address 6 fields

OpenDirect.Address fields — 6 fields, 3 required
Field	Type	Required	Description
`city`	string	required
`country`	string	required	ISO-3166-1-alpha-2
`addressline1`	string	required
`addressline2`	string
`postalcode`	string
`state`	string

OpenDirect.Contact 9 fields

OpenDirect.Contact fields — 9 fields, 3 required
Field	Type	Required
`address`	object
`email`	string
`honorific`	string
`fax`	string
`firstname`	string	required
`lastname`	string	required
`phone`	string
`title`	string
`type`	string	required

OpenDirect.ChangeRequest 9 fields

Request to modify an existing order

OpenDirect.ChangeRequest fields — 9 fields, 3 required
Field	Type	Required	Description
`id`	string
`accountid`	string	required
`comments`	string
`contacts`	array
`orderid`	string	required
`requesterid`	string	required	Organization ID of requester
`status`	string
`webhook`	string		URI called on approval/rejection
`ext`	object

OpenDirect.Message 11 fields

Communication between buyer and seller

OpenDirect.Message fields — 11 fields, 3 required
Field	Type	Required
`id`	string
`sender`	object
`recipient`	object
`messagedate`	string	required
`status`	string	required
`orderid`	string	required
`lineids`	array
`changerequestid`	string
`message`	string
`replytomessageid`	string
`replywebhook`	string

OpenDirect.Placement 4 fields

Ad unit specifications for a line item

OpenDirect.Placement fields — 4 fields, 2 required
Field	Type	Required	Description
`id`	string
`lineid`	string	required
`adunitid`	string	required
`creativespec`	object		Override ad unit specs if provided

OpenDirect.AdUnit 3 fields

Contains AdCOM Ad Specification

OpenDirect.AdUnit fields — 3 fields, 2 required
Field	Type	Required
`id`	string	required
`name`	string
`creativespec`	object	required

AdCOM.CreativeSpec 7 fields

Desired characteristics of creatives

AdCOM.CreativeSpec fields — 7 fields, 0 required
Field	Type	Description
`battr`	array	Blocked creative attributes
`video`	object
`display`	object
`audio`	object
`dspmgr`	string	Ad mediation partner name
`dspmgrver`	string
`clktype`	integer	Click type (List 7)

AdCOM.CreativeResp 5 fields

Creative instance with rendering information

AdCOM.CreativeResp fields — 5 fields, 0 required
Field	Type	Description
`display`	object
`video`	object
`audio`	object
`iurl`	string	Representative image URL for ad quality checking
`attr`	array	Creative attributes (List 5)

AdCOM.VideoSpec 18 fields

AdCOM.VideoSpec fields — 18 fields, 0 required

Field	Type	Required	Description
`subtype`	array
`mindur`	integer
`maxdur`	integer
`protocols`	array
`w`	integer
`h`	integer
`startdelay`	integer
`placement`	integer
`skipmin`	integer
`skipafter`	integer
`minbitrate`	integer
`maxbitrate`	integer
`boxingallowed`	integer
`playbackmethod`	array
`delivery`	array
`pos`	integer
`companiontype`	array
`apis`	array

AdCOM.VideoResp 6 fields

AdCOM.VideoResp fields — 6 fields, 0 required
Field	Type	Description
`subtype`	integer
`qagmediarating`	integer
`adm`	string	Creative markup
`curl`	string	Creative markup URL
`api`	integer
`mimes`	array

AdCOM.DisplaySpec 6 fields

AdCOM.DisplaySpec fields — 6 fields, 0 required
Field	Type	Description
`subtype`	array
`bannerformat`	object
`nativeformat`	object
`ampformat`	object
`instl`	integer	1=interstitial, 0=not
`apis`	array

AdCOM.DisplayResp 9 fields

AdCOM.DisplayResp fields — 9 fields, 0 required
Field	Type	Required	Description
`subtype`	integer
`adm`	string
`curl`	string
`w`	integer
`h`	integer
`wratio`	integer
`hratio`	integer
`api`	integer
`mimes`	array

AdCOM.BannerSpec 11 fields

AdCOM.BannerSpec fields — 11 fields, 0 required
Field	Type	Description
`w`	integer	Width in DIPS
`h`	integer	Height in DIPS
`wratio`	integer
`hratio`	integer
`sized`	integer	Ratio-based size (List 8)
`btype`	array	Blocked banner types
`battr`	array
`pos`	integer
`opframe`	integer	Top frame vs iframe
`expdir`	array	Expandable directions
`iframebuster`	array

AdCOM.AudioSpec 11 fields

AdCOM.AudioSpec fields — 11 fields, 0 required
Field	Type	Description
`minduration`	integer
`maxduration`	integer
`protocols`	array
`startdelay`	integer
`minbitrate`	integer
`maxbitrate`	integer
`delivery`	array
`companiontype`	array
`maxseq`	integer
`nvol`	integer	Volume normalization mode
`apis`	array

AdCOM.AudioResp 5 fields

AdCOM.AudioResp fields — 5 fields, 0 required
Field	Type	Required	Description
`subtype`	integer
`adm`	string
`curl`	string
`companionad`	array
`api`	integer

AdCOM.NativeSpec 2 fields

AdCOM.NativeSpec fields — 2 fields, 1 required
Field	Type	Required	Description
`request`	string	required	Native Ad Specification request payload
`ver`	string		Dynamic Native Ads API version

AdCOM.AMPSpec 2 fields

AdCOM.AMPSpec fields — 2 fields, 0 required
Field	Type	Required	Description
`rend`	integer		AMP ad requirements: 1=unknown, 2=not allowed, 3=allowed no early render, 4=allowed with early render, 5=required
`ver`	string

Those are the first 24, in source order. The remaining 16 definitions in the repository are AdCOM.Site, AdCOM.App, AdCOM.Publisher, AdCOM.Content, AdCOM.Producer, AdCOM.Device, AdCOM.Geo, AdCOM.User, AdCOM.Data, AdCOM.Segment, AdCOM.AdSpec, AdCOM.AdResp, OpenRTB.Deal, OpenRTB.PMP, OpenRTB.Regs, OpenRTB.Source.