Skip to main content

The open automotive retail profile of A2A

Auto Agent ProtocolAuto Agent Protocol

One open contract for dealer discovery, real inventory, transparent pricing, and consented leads.

Read the SpecGitHub
A2A v1.0 profileJSON-RPC 2.0Five typed skills
See how AAP profiles A2A

Small surface, strong guarantees

Everything needed for the read-and-lead journey

AAP stays deliberately narrow so dealerships and buyer agents can implement it with confidence.

01

An A2A Profile

AAP is a strict A2A v1.0 profile: typed automotive messages ride on top of A2A's data layer. JSON-RPC 2.0 is the single transport — one SendMessage operation carries every skill.

02

Five Skills

dealer.information, inventory.facets, inventory.search, inventory.vehicle, lead.submit. Everything a BDC needs in one unified contract.

03

FTC-Aware Pricing

The authoritative price includes mandatory dealer charges. An optional fee breakdown makes those included charges visible; government charges remain outside price and conditional rebates never reduce it.

04

Anonymous First

Inventory operations are anonymous by default. Personal data only travels with leads, and only with an explicit ConsentGrant attached.

05

ADF-Mappable Leads

lead.submit is field-by-field convertible to ADF/XML, so any compliant lead drops cleanly into existing dealer CRMs without bespoke integration.

06

MCP Ready

An official MCP reference manifest maps every AAP skill to an MCP tool, so MCP hosts can adapt the same contract without speaking A2A directly.

Cars, EVs, and motorcycles — one contract

v1.3.0 extends inventory beyond cars. An optional vehicle_type discriminator covers car, motorcycle, and room for trailer / RV later (absent means car, so existing integrations keep working). Electric cars and electric motorcycles share the same powertrain fields — including filterable charge_port — while motorcycle segments reuse free-text body.

See the vehicle shape
Cars, motorcycles and electric powertrains share one vocabularyAn optional vehicle_type selects class-specific details while common fields stay common.ONE INVENTORY CONTRACTCars, motorcycles and electric powertrains share one vocabularyAn optional vehicle_type selects class-specific details while common fields stay common.CARCarsSedan, SUV and other body values;driveline, MPG and shared identificationfields.vehicle_type: carbody · driveline · fuelELECTRICElectric unitsThe same powertrain group works forelectric cars and motorcycles.electric_range_mibattery_kwh · charge_portMOTORCYCLEMotorcyclesSegment in body, displacement forcombustion units and niche specs inother_attributes.vehicle_type: motorcycledisplacement_ccAbsent vehicle_type means car, preserving compatibility with existing listings.

Five skills, one contract

AAP standardizes the five skills that cover a dealership BDC's core needs — anonymous inventory queries plus a single unified lead.submit that bundles vehicle interest, trade-in, and appointment scheduling in one consented call. No quotes, no checkout, no payment scope. Just the read-and-lead lifecycle, typed and validated.

Browse the skills
Five skills cover the read-and-lead lifecycleA dealer agent implements one or more skills; none is individually mandatory.AAP VOCABULARYFive skills cover the read-and-lead lifecycleA dealer agent implements one or more skills; none is individually mandatory.01dealer.informationGroup profile, rooftops,hours, contacts,capabilities and defaultfee schedules.02inventory.facetsAvailable buckets andranges before a buyercomposes a precisesearch.03inventory.searchFiltered, paginatedinventory withauthoritative pricingwhen available.04inventory.vehicleOne complete vehiclerecord by VIN, stocknumber or vehicle_id.05lead.submitCustomer, vehicle,trade-in and appointmentbehind explicit consent.Recommended starting pair: inventory.search + lead.submit
One authoritative vehicle price, with optional disclosure contextPrice is the all-in advertised amount. The other fields add context but never replace or reconstruct it.PRICE + FEE DISCLOSUREOne authoritative vehicle price, with optional disclosure contextPrice is the all-in advertised amount. The other fields add context but never replace or reconstruct it.AUTHORITATIVEpriceAdvertised vehicle priceincluding mandatory dealercharges; government chargesexcluded.$26,780OPTIONAL BREAKDOWNfeesComplete itemization whensupplied; already included inprice.Documentation · $500Theft protection · $1,290CONTEXT ONLYlist_priceBase/list amount; neverpresented or computed asthe payable price.$24,990REFERENCEmsrpManufacturer's suggestedretail price.$27,500Use price for comparison · Never compute price from list_price + fees · Conditional rebates never reduce price

FTC-aware pricing, baked in

A vehicle's price is the authoritative advertised price: it includes every mandatory dealer charge and excludes government charges. When price is present, the same vehicle may also carry a complete effective fees breakdown. Buyer agents never join rooftop defaults into a vehicle, and conditional rebates never reduce the advertised price.

Read the pricing semantics

Protocol map

Designed to connect, not duplicate

A2A

The base. AAP is a strict A2A v1.0 profile. Every AAP message rides inside an A2A DataPart.

ACP / UCP

Complementary. AAP focuses on automotive leads and appointments, not commerce checkout flows.

MCP

Complementary. AAP publishes an official MCP reference manifest mapping every skill to an MCP tool.

ADF/XML

Legacy bridge. lead.submit maps field-by-field to ADF/XML for existing dealer CRMs.