A2A Cosmetics MCP server

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

<!-- door:begin -->streamable-HTTP, stateless, server name a2a-cosmetics, door version 1.0.0, 20 tools (read from the wire 2026-09-20)<!-- door:end -->

• 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://.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: resolvejurisdiction → resolveactor → gatetransaction. Twelve reason codes: ALLOW · REQUIRENOTIFICATION · REQUIRERESPONSIBLEPERSON · DENYNOTACOSMETICHERE · DENYINGREDIENTBANNED · DENYINGREDIENTLIMIT · DENYCLAIM · DENYMARKET · DENYACTORCLASS · DENYUNLICENSEDAGENT · DENYNOGTIN · DENYNOTVERIFIED.

The twenty tools

• Gate — resolvejurisdiction, resolveactor, gate_transaction
• Regulatory truth — getingredientrecord, getmarketstatus, getnotificationrequirements, getlabelandclaims, getenforcement_watch
• Catalogue — searchcleareditems, getitem, compareitems
• Supply — findverifiedsupplier, getavailability, getprice
• Documents — getproductdocuments, verify_gtin
• Commerce — createorderintent, a2a_handoff
• Operations — getsafetylabel, 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

<!-- agents:begin -->

36 agents live, 0 product-line slots reserved on the tenant table; by region: Australia East 1 · Brazil South 1 · Canada Central 1 · Central India 1 · France Central 2 · Germany West Central 1 · Italy North 1 · Japan East 1 · Korea Central 1 · Mexico Central 1 · Poland Central 1 · South Central US 18 · Southeast Asia 1 · Spain Central 1 · Switzerland North 1 · UAE North 1 · UK South 1 · West Europe 1. Counted from the hub's list_agents on 2026-09-20; door version 1.0.0, 20 tools. <!-- agents:end -->

Examples

Stock clients, no adapter: examples/awsstrands.py · examples/azuresemantickernel.py · examples/googlegenai.py · examples/genericmcpclient.py; A2A: examples/a2aawsstrands.py · examples/a2aazureagentframework.py · examples/a2agoogle_sdk.py.

Shortened. The full README is on GitHub.