A2A Cosmetics

Official20 tools

by greencore-solutions · Python

Agent-to-Agent (A2A) hub for cosmetics: skin care, fragrance, sun care, dermocosmetics.

Agent-to-Agent (A2A) + Model Context Protocol (MCP) Hub for Cosmetics

This MCP server provides an Agent-to-Agent (A2A) + Model Context Protocol (MCP) hub focused on cosmetics. It is identified by the slug io-github-greencore-solutions-a2a-cosmetics and described as a hub for cosmetics within the A2A and MCP context.

🛠️ Key Features

Agent-to-Agent (A2A) capability
Model Context Protocol (MCP) hub
Cosmetics-focused hub

🚀 Use Cases

Supporting A2A workflows related to cosmetics
Integrating MCP-based context exchange for cosmetics projects

⚡ Developer Benefits

Clear alignment with A2A + MCP for cosmetics use cases
Repository-style identification via slug: io-github-greencore-solutions-a2a-cosmetics

⚠️ Limitations

Available details only describe the A2A + MCP cosmetics hub; no tool count, topics, or specific functions are provided.

Topics

a2aagentic-commercebeautycosmeticsdermocosmeticsfragrancemcpmodel-context-protocolskin-caresun-care

Captured live from the server via tools/list.

resolve_jurisdiction

Where is this going? Resolve a ship-to (e.g. 'US', 'US-CA', 'UK', 'FR', 'EU-DE', 'JP') to one of the 18 markets and its rule set (13 rule sets; the six EU markets share one). UK is the label; machine fields carry the ISO code GB.

Parameters1

ship_to

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ship_to": {
      "type": "string"
    }
  },
  "required": [
    "ship_to"
  ]
}

resolve_actor

Who is asking? Brand, manufacturer, retailer or distributor (business to business); auditor (read-only); agent (inherits the class of the credential it presents — none returns DENY_UNLICENSED_AGENT). The consumer is never the counterparty. Returns communication_class: trade_information or public.

Parameters2

actor_class	string	required
credential	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "actor_class": {
      "type": "string"
    },
    "credential": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "actor_class"
  ]
}

gate_transaction

Allow or deny, with the reason and the rule. Takes a product (GTIN or catalogue id; optional), the ship-to market, the actor class and, when no record exists yet, the product type, ingredients (INCI) and claims. Returns one of 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 rule-set version, the source page and a decision_id for the downstream tools.

Parameters8

ship_to	string	required
actor_class	string	required
product	any	optional
product_type	any	optional
ingredients	any	optional
claims	any	optional
channel	any	optional
credential	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "ship_to": {
      "type": "string"
    },
    "actor_class": {
      "type": "string"
    },
    "product": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ingredients": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "claims": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "channel": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "credential": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "ship_to",
    "actor_class"
  ]
}

get_ingredient_record

One ingredient, and its status in every market: the standard ingredient name (INCI), aliases, and per rule set whether it is prohibited, restricted (with the limit or condition) or listed, each with the official list and its source page.

Parameters1

ingredient

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "ingredient": {
      "type": "string"
    }
  },
  "required": [
    "ingredient"
  ]
}

get_market_status

Is this product type a cosmetic here? Product type by market: cosmetic, drug, special class (functional cosmetic, quasi-drug, grade 2, therapeutic good) or not permitted — with the rule-set version and the regulator's page.

Parameters2

product_type	string	required
market	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "product_type": {
      "type": "string"
    },
    "market": {
      "type": "string"
    }
  },
  "required": [
    "product_type",
    "market"
  ]
}

get_notification_requirements

What must be filed before sale in a market: the notification scheme, the responsible-person requirement and, for a product type in a special class, the extra step (review, registration, listing) — each with its source page.

Parameters2

market	string	required
product_type	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market"
  ]
}

get_label_and_claims

What the label must say, and which claims are allowed: the label requirements of the market and the claims rules of record (patterns that take a product out of the cosmetic class), each with its source page. Optional claims are checked against the rules.

Parameters2

market	string	required
claims	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "claims": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market"
  ]
}

get_enforcement_watch

Recalls, bans and safety alerts, dated: enforcement events by market, ingredient, brand or since a date, each with its source page.

Parameters3

market	any	optional
query	any	optional
since	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  }
}

search_cleared_items

Find products cleared for this market: validated product records in a market (query by product name, brand, product type or lane; optional lane filter: suncare · fragrance · dermocosmetics · peptides · korean · sustainable). Only validated rows are served; each item carries its claim status and market status.

Parameters6

market	string	required
query	any	optional
lane	any	optional
product_type	any	optional
limit	integer	optional
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "lane": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 25,
      "type": "integer"
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market"
  ]
}

get_item

One product by GTIN, fully resolved: taxonomy path, variant or form, brand, market, claim status, market status, availability; after the gate also ingredients, claims, attributes, shades (parent and child) and offers.

Parameters3

gtin	string	required
market	any	optional
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin"
  ]
}

compare_items

Compare products, variants and shades side by side (two to eight GTINs or catalogue ids).

Parameters3

gtins	array	required
market	any	optional
decision_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtins": {
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtins"
  ]
}

find_verified_supplier

Verified makers and brands for this product or product type in a market: supplier records (brand · manufacturer) with their claim status — verified first, then claimed, then listed. Takes the decision_id of an allow decision.

Parameters5

market	string	required
decision_id	string	required
gtin	any	optional
query	any	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "gtin": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "limit": {
      "default": 25,
      "type": "integer"
    }
  },
  "required": [
    "market",
    "decision_id"
  ]
}

get_availability

In stock, and where: the availability block of a product (banners on the shelf of record, product URLs read live at load, store counts where the retailer record carries one) once gate_transaction has answered allow (decision_id).

Parameters3

gtin	string	required
decision_id	string	required
market	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "decision_id"
  ]
}

get_price

The price for this buyer: the price basis (list · contract) from the supplier's offers on the record, once gate_transaction has answered allow (decision_id). Tiers buy services, never rank.

Parameters3

gtin	string	required
decision_id	string	required
market	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "decision_id"
  ]
}

get_product_documents

Safety report, certificate of analysis, data sheet: the documents on a product record (product information file pointer, safety assessment, certificate of analysis, safety data sheet), each a URL with its read date; decision_id required.

Parameters3

gtin	string	required
decision_id	string	required
market	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "decision_id"
  ]
}

verify_gtin

Is this GTIN real, and whose is it? Check-digit validation, the GS1 prefix, and the validated record(s) that carry it on this hub with their brand and claim status.

Parameters1

gtin

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    }
  },
  "required": [
    "gtin"
  ]
}

create_order_intent

Open an order between two agents: an order intent for a cleared product after the gate; the intent carries reason_code + rule_set_version and settles by x402 on a2a-x402.ai.

Parameters5

gtin	string	required
quantity	integer	required
decision_id	string	required
market	any	optional
ship_to	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "gtin": {
      "type": "string"
    },
    "quantity": {
      "type": "integer"
    },
    "decision_id": {
      "type": "string"
    },
    "market": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "ship_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "gtin",
    "quantity",
    "decision_id"
  ]
}

a2a_handoff

Hand the buyer to the right agent over Agent-to-Agent (A2A): with an allow decision the order intent goes to the counterparty's agent (envelope + card URL); with a deny, the market agent of the ship-to (the regulator's home page beside it) — a referral, never a sale to a consumer.

Parameters3

intent_id	any	optional
decision_id	any	optional
counterparty_card_url	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "intent_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "decision_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "counterparty_card_url": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  }
}

get_safety_label

Warnings and age limits: the warning statements the market requires for a product type (sunscreen, hair dye, aerosols, children's products) and the safety-alert scheme of the regulator, each with its source page.

Parameters2

market	string	required
product_type	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string"
    },
    "product_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "market"
  ]
}

log_audit

Write a line to the audit record for a gate decision, an order intent or a handoff (returns the line id).

Parameters3

kind	string	required
reference_id	string	required
note	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string"
    },
    "reference_id": {
      "type": "string"
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "kind",
    "reference_id"
  ]
}

README.md4 KBView on GitHub

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

streamable-HTTP, stateless, server name `a2a-cosmetics`, door version 1.0.0, 20 tools (read from the wire 2026-09-20)

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 (concierge)	a2a-cosmetics.ai	1	South Central US
Registry (token questions)	a2a-registry.ai	1	South Central US
Payments door (receipt questions)	a2a-x402.ai	1	South Central US
Actor-class entry points	pharmacy · prescriber · wholesaler · brand + .a2a-cosmetics.ai	4	South Central US
Handoff (referral only)	handoff.a2a-cosmetics.ai	1	South Central US
Enforcement watch	watch.a2a-cosmetics.ai	1	South Central US
Auditor Port	audit.a2a-cosmetics.ai	1	South Central US

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.

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.

Install

Tools (20)

resolve_jurisdictionresolve_actorgate_transactionget_ingredient_recordget_market_statusget_notification_requirementsget_label_and_claimsget_enforcement_watch

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.a2a-cosmetics.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "a2a-cosmetics": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.a2a-cosmetics.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Agent-to-Agent (A2A) + Model Context Protocol (MCP) Hub for Cosmetics

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

resolve_jurisdiction

resolve_actor

gate_transaction

get_ingredient_record

get_market_status

get_notification_requirements

get_label_and_claims

get_enforcement_watch

search_cleared_items

get_item

compare_items

find_verified_supplier

get_availability

get_price

get_product_documents

verify_gtin

create_order_intent

a2a_handoff

get_safety_label

log_audit

A2A Cosmetics — connect kit

The door

The gate

The twenty tools

The agents

Examples

Pay on it

Contact

Install

Remote endpoint

Related servers