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

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.
Property	Value
Version	`untagged (915bda9)`
Commit	`915bda98`
Kind	reference implementation
Substance	partial
Listed in the hub README	Yes

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

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`

Contains AdCOM Ad Specification

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

`AdCOM.CreativeSpec`

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`

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`

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`

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`

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`

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`

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`

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`

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

`AdCOM.NativeSpec`

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`

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 .

agentic-direct

What this repository defines

The objects, field by field

OpenDirect.Account

OpenDirect.Order

OpenDirect.Line

OpenDirect.Product

OpenDirect.Creative

OpenDirect.Assignment

OpenDirect.Organization

OpenDirect.Address

OpenDirect.Contact

OpenDirect.ChangeRequest

OpenDirect.Message

OpenDirect.Placement

OpenDirect.AdUnit

AdCOM.CreativeSpec

AdCOM.CreativeResp

AdCOM.VideoSpec

AdCOM.VideoResp

AdCOM.DisplaySpec

AdCOM.DisplayResp

AdCOM.BannerSpec

AdCOM.AudioSpec

AdCOM.AudioResp

AdCOM.NativeSpec

AdCOM.AMPSpec

Related