A2A Cosmetics — connect kit

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

Business to business: brands, manufacturers, retailers, distributors and their AI agents. Eighteen markets, thirteen rule sets; every answer names the market, the rule set and the version it was judged against. Operated by GreenCore Solutions Corp. Public connect kit, MIT.

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.

The door

• MCP: https://mcp.a2a-cosmetics.ai/mcp — any client that speaks streamable-HTTP: { "url": "https://mcp.a2a-cosmetics.ai/mcp", "transport": "streamable-http" }
• A2A 0.3.0 JSON-RPC: https://a2a-cosmetics.ai/a2a (the hub) and https://<cc>.a2a-cosmetics.ai/a2a (one market agent per market, answered from its own Azure region)
• Agent Card: https://a2a-cosmetics.ai/.well-known/agent-card.json (ES256, kid a2ac-2026-09; keyring /.well-known/jwks.json)
• Setup: https://a2a-cosmetics.ai/setup · Docs: https://a2a-cosmetics.ai/docs · Claim your record: https://a2a-cosmetics.ai/claim
• Official MCP Registry: io.github.greencore-solutions/a2a-cosmetics (server.json in this repo)

The gate

Three calls before any price: resolve_jurisdiction → resolve_actor → gate_transaction. Twelve 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.

The twenty tools

• Gate — resolve_jurisdiction, resolve_actor, gate_transaction
• Regulatory truth — get_ingredient_record, get_market_status, get_notification_requirements, get_label_and_claims, get_enforcement_watch
• Catalogue — search_cleared_items, get_item, compare_items
• Supply — find_verified_supplier, get_availability, get_price
• Documents — get_product_documents, verify_gtin
• Commerce — create_order_intent, a2a_handoff
• Operations — get_safety_label, log_audit

Reads are open. The six transacting tools take a client-credentials Bearer from the issuer, https://a2a-registry.ai (register at /oauth/register; see https://a2a-cosmetics.ai/auth.md).

The agents

Role	Hostname	Agents	Region
hub trio	a2a-cosmetics.ai · a2a-registry.ai · a2a-x402.ai	3	South Central US
market agents	us · mx · ca · br · uk · fr · de · nl · it · es · pl · ch · ae · in · sg · jp · kr · au · eu + .a2a-cosmetics.ai	19	one Azure region each (18 regions)
actor entries	brand · manufacturer · retailer · distributor + .a2a-cosmetics.ai	4	South Central US
handoff · watch · audit	handoff. · watch. · audit.	3	South Central US
lane views	suncare · fragrance · dermocosmetics · peptides · korean · sustainable + .a2a-cosmetics.ai	6	South Central US
tenant seat	elyssah.a2a-cosmetics.ai	1	South Central US

36 agents on the table (generated by AGENTS/table.py; the live count is the hub's list_agents at request time — tools/stamp_readme.py restamps this block from the wire).

Examples

Stock clients, no adapter: examples/aws_strands.py · examples/azure_semantic_kernel.py · examples/google_genai.py · examples/generic_mcp_client.py; A2A: examples/a2a_aws_strands.py · examples/a2a_azure_agent_framework.py · examples/a2a_google_sdk.py.

Pay on it

x402 is live on https://a2a-x402.ai (USDC on Base, settlement after the gate; a refused order intent is not settled and not charged). The Machine Payments Protocol, the Universal Commerce Protocol and the Agentic Commerce Protocol are built and dark until they can settle; the Agent Payments Protocol sits on the Agent Card. Front door: https://a2a-pay.ai.

Contact

mcp@a2a-cosmetics.ai — the registry contact for every listing this hub files.