# A2A Cosmetics

> Agent-to-Agent (A2A) + Model Context Protocol (MCP) hub for cosmetics.

A2A Cosmetics is the agentic commerce hub for cosmetics in 18 markets.

Eighteen markets, thirteen rule sets. The Agent-to-Agent (A2A) surface for cosmetics, served over the Model Context Protocol (MCP) — the record, a registry for security, and x402 to pay on it.

AI agents for brands, manufacturers, retailers and distributors. Business to business.

Notice: Artificial intelligence makes mistakes. A2A Cosmetics is an information source, not a recommendation. Rules differ by jurisdiction — refer to the regulator in your jurisdiction for the information that applies to you.

Operator: GreenCore Solutions Corp. · Surface: https://a2a-cosmetics.ai · version 1.0.0 · as of 2026-09-20

18 markets · 13 rule sets · 20 tools on the door (v1.0.0) · 19,031 products · 2,856 ingredients · 22,738 supplier records (read from the record at build)

## §01 What you get

- The record. Every cosmetic product the hub can source from the brand's own page — what it is on the taxonomy of record, its Global Trade Item Number (GTIN), its market status, its claim status — read live, every field with its source.
- A registry for security. Every answer names the market, the rule set and the version it was judged against, and is signed; an agent that transacts carries a credential from the issuer.
- x402 to pay on it. Your agent asks, the hub answers, your agent pays and the order settles machine to machine, with a receipt naming what was bought, where and under which rule.

## §02 Who it's for

Brands, manufacturers, retailers, distributors and their AI agents. The consumer is never the counterparty.

## §03 The gate

Three calls before any price: resolve_jurisdiction → resolve_actor → gate_transaction.

Reason codes: ALLOW · REQUIRE_NOTIFICATION · REQUIRE_RESPONSIBLE_PERSON · DENY_NOT_A_COSMETIC_HERE · DENY_INGREDIENT_BANNED · DENY_INGREDIENT_LIMIT · DENY_CLAIM · DENY_MARKET · DENY_ACTOR_CLASS · DENY_UNLICENSED_AGENT · DENY_NO_GTIN · DENY_NOT_VERIFIED
Actors: brand · manufacturer · retailer · distributor · auditor

## §04 The door

MCP door of record: https://mcp.a2a-cosmetics.ai/mcp — stateless streamable-HTTP, server name a2a-cosmetics, 20 tools at v1.0.0.

- Gate: resolve_jurisdiction — Where is this going? Returns the market and rule set.; resolve_actor — Who is asking? Brand, manufacturer, retailer or distributor.; gate_transaction — Allow or deny, with the reason and the rule.
- Regulatory truth: get_ingredient_record — One ingredient, and its status in every market.; get_market_status — Is this product type a cosmetic here?; get_notification_requirements — What must be filed before sale.; get_label_and_claims — What the label must say, and which claims are allowed.; get_enforcement_watch — Recalls, bans and safety alerts, dated.
- Catalogue: search_cleared_items — Find products cleared for this market.; get_item — One product by GTIN, fully resolved.; compare_items — Compare products, variants and shades.
- Supply: find_verified_supplier — Verified makers and brands for this product.; get_availability — In stock, and where.; get_price — The price for this buyer.
- Documents: get_product_documents — Safety report, certificate of analysis, data sheet.; verify_gtin — Is this GTIN real, and whose is it?
- Commerce: create_order_intent — Open an order between two agents.; a2a_handoff — Hand the buyer to the right agent.
- Operations: get_safety_label — Warnings and age limits.; log_audit — Write a line to the audit record.

## §05 The record

Spine: the GSC SPARKS Beauty and Personal Care Taxonomy. Products by GTIN · ingredients by INCI with status per rule set · market status by product type · suppliers and retailers · claim_status on every record · the showcase standard (every URL read live; only validated rows served; every field carries its source).

## §06 Eighteen markets

- US — United States · South Central US
- MX — Mexico · Mexico Central
- CA — Canada · Canada Central
- BR — Brazil · Brazil South
- UK — UK · UK South
- FR — France · France Central
- DE — Germany · Germany West Central
- NL — Netherlands · West Europe
- IT — Italy · Italy North
- ES — Spain · Spain Central
- PL — Poland · Poland Central
- CH — Switzerland · Switzerland North
- AE — United Arab Emirates · UAE North
- IN — India · Central India
- SG — Singapore · Southeast Asia
- JP — Japan · Japan East
- KR — Korea · Korea Central
- AU — Australia · Australia East

## §07 The agents

- Hub trio: concierge (a2a-cosmetics.ai) · issuer (a2a-registry.ai) · payments door (a2a-x402.ai)
- 19 market agents: one per market in its own Azure region, plus eu. for the shared EU rule set
- 4 actor entries: brand. · manufacturer. · retailer. · distributor. — a default, never a bypass
- handoff. · watch. · audit.: the referral, the enforcement watch, the auditor port
- 6 lane agents: suncare. · fragrance. · dermocosmetics. · peptides. · korean. · sustainable. — attribute views over the one record
- The tenant seat: GSC's declared showcase brand, with the same guardrails as on its own site

## §08 Pay on it

x402 live (a2a-x402.ai); MPP, UCP, ACP built and dark; AP2 on the Agent Card. Front door: https://a2a-pay.ai/

## §09 Rulings of record

- 2026-09-20 — A2A Cosmetics is a2a-peptides.ai remade as is — same surface, door, issuer, payments door and agents app — for cosmetics: 18 markets, 13 rule sets, twenty tools, twelve reason codes.
- 2026-09-20 — Business to business: brands, manufacturers, retailers, distributors and their agents. The consumer is never the counterparty.
- 2026-09-20 — The taxonomy of record is the GSC SPARKS Beauty and Personal Care Taxonomy: four levels, then variant or form, then SKU / GTIN; segments and claims are attributes, never branches.
- 2026-09-20 — The showcase standard: every URL is read live at load; dead, wrong or parked goes to the pond with its reason; only validated rows are served; every field carries its source; counts are read from the validated set.
- 2026-09-20 — Every record carries claim_status — listed · claimed · verified. An unclaimed record answers: listed from public sources, not verified by the brand.
- 2026-09-20 — No brand or retailer name renders on any web path. Names are served by the door and the agents only.
- 2026-09-20 — The four agent- rail doors are GreenCore's: x402 live; MPP, UCP and ACP built and dark; nothing advertised that cannot settle.

## §10 Machine kit

- https://a2a-cosmetics.ai/.well-known/agent-card.json — A2A Agent Card, signed ES256 under kid a2ac-2026-09
- https://a2a-cosmetics.ai/.well-known/jwks.json — the hub keyring
- https://a2a-cosmetics.ai/llms.txt — the plain-text guide for language models
- https://a2a-cosmetics.ai/ai-catalog.json — the resource catalogue (also /.well-known/ai-catalog.json)
- https://a2a-cosmetics.ai/index.md — this page as Markdown (also by Accept: text/markdown)
- https://a2a-cosmetics.ai/docs — the door's reference
- https://a2a-cosmetics.ai/setup — the connection page
- https://a2a-cosmetics.ai/claim — claim your record
- https://a2a-cosmetics.ai/icon.svg — the mark, with /icon-512.png and /icon-512-dark.png
- https://a2a-cosmetics.ai/site.webmanifest — the web manifest
- https://a2a-cosmetics.ai/health.json — surface status
- https://a2a-cosmetics.ai/.well-known/security.txt — the security contact
- https://a2a-cosmetics.ai/robots.txt — crawl policy, open
- https://a2a-cosmetics.ai/sitemap.xml — the sitemap

## §11 Contact

The form at https://a2a-cosmetics.ai/#contact is the only human door. Machine contact is on the Agent Card and in the headers.
