# A2A Cosmetics

> A2A Cosmetics is an MCP server for legal and government. Cosmetics regulation, catalogue and supplier lookups across 18 markets, for B2B agents. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Contact sales
- **Platforms:** API
- **Website:** https://a2a-cosmetics.ai
- **Repository:** https://github.com/greencore-solutions/a2a-cosmetics
- **MCP Registry name:** io.github.greencore-solutions/a2a-cosmetics
- **Categories:** legal and government, e-commerce
- **Listing updated:** 2026-11-14

## About

A2A Cosmetics is a trade-only hub where an agent checks whether a cosmetic product can be sold and bought in a given market. Its core is a gate of three calls before any price: `resolve_jurisdiction`, `resolve_actor` and `gate_transaction`. Answers carry one of twelve reason codes, such as ALLOW, REQUIRE_NOTIFICATION, DENY_INGREDIENT_BANNED or DENY_CLAIM, and name the market, rule set and version used.

The twenty tools are grouped around regulatory truth (ingredient records, market status, notification rules, labels and claims, enforcement watch), a catalogue and supply layer (cleared items, verified suppliers, availability, price) and commerce (order intents and hand-offs). The site reports 18 markets, 13 rule sets and about 19,000 products on record.

Reads are open; the six transacting tools need a client-credentials bearer from a2a-registry.ai. The notice says AI makes mistakes and the hub is not a recommendation.

## Features

- **Three-call gate:** Resolve jurisdiction and actor, then gate the transaction.
- **Ingredient and market rules:** Records for ingredients, notification duties, labels and claims.
- **Cleared catalogue:** Search, fetch and compare cleared items by GTIN.
- **Verified suppliers:** Find suppliers, availability and prices.
- **Signed answers:** Each answer names its rule set and is signed.
- **Order intents:** Transacting tools use OAuth client credentials.

## Good for

- Check whether an ingredient is allowed in a target market
- Find which notifications a product needs
- Look up a verified supplier for a product
- Verify a GTIN against the record
- Review recent enforcement events

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http a2a-cosmetics https://mcp.a2a-cosmetics.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "a2a-cosmetics": {
      "url": "https://mcp.a2a-cosmetics.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "a2a-cosmetics": {
      "type": "http",
      "url": "https://mcp.a2a-cosmetics.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "a2a-cosmetics": {
      "serverUrl": "https://mcp.a2a-cosmetics.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "a2a-cosmetics": {
      "type": "http",
      "url": "https://mcp.a2a-cosmetics.ai/mcp"
    }
  }
}
```

## Tools

- `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.
- `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.
- `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 · DEN
- `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.
- `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.
- `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.
- `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.
- `get_enforcement_watch`: Recalls, bans and safety alerts, dated: enforcement events by market, ingredient, brand or since a date, each with its source page.
- `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.
- `get_item`: Product record from gtinfetch.ai (signed); hub layer: seat, market, claim, price, availability. 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.
- `compare_items`: Compare products, variants and shades side by side (two to eight GTINs or catalogue ids).
- `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.
- `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).
- `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.
- `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.
- `verify_gtin`: Product record from gtinfetch.ai (signed); hub layer: seat, market, claim, price, availability. 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.
- `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.
- `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.
- `claim_seat`: A brand's agent claims its seat on A2A Cosmetics. Give the agent's card URL and the GTINs the brand claims: every GTIN must resolve on gtinfetch.ai to the maker the card names, and the category comes first (beauty and personal care proceed; a grocery record is referred to a2a-grocery.ai; peptides to a2a-peptides.ai; beer, wine and spirits are refused; an unresolved GTIN is refused). An accepted cl
- `search_catalog`: Universal Commerce Protocol (UCP) catalogue search, version 2026-08-25 (dev.ucp.shopping.catalog.search). arguments: meta {'ucp-agent': {profile}} (required) and catalog {query, context {address_country}, filters {categories, price {min, max} in minor units}, pagination {limit, cursor}}. Serves the priced subset: rows whose maker's list price is on the record (claimed seats with a listed price), k
- `lookup_catalog`: Universal Commerce Protocol (UCP) catalogue lookup, version 2026-08-25 (dev.ucp.shopping.catalog.lookup). arguments: meta {'ucp-agent': {profile}} (required) and catalog {ids: product ids (GTIN) or variant ids (<market>:<gtin14>), up to 50; context; filters}. Found rows come back as products with their claim_status; an id outside the priced subset answers an info not_found message.
- `get_product`: Universal Commerce Protocol (UCP) product detail, version 2026-08-25 (dev.ucp.shopping.catalog.lookup). arguments: meta {'ucp-agent': {profile}} (required) and catalog {id: a GTIN or a variant id <market>:<gtin14>; context; filters}. One product of the priced subset with its variants per market, list price and claim_status; outside the subset, ucp.status error and not_found.
- `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.
- `log_audit`: Write a line to the audit record for a gate decision, an order intent or a handoff (returns the line id).

## FAQ

### Who is it for?

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

### Are reads free?

Reads are open. Transacting tools need a bearer token from a2a-registry.ai.

### How many tools?

Twenty, per the README and site.

### Is it legal advice?

No. The notice calls it an information source, not a recommendation, and says rules differ by jurisdiction.

### How much does A2A Cosmetics cost?

A2A Cosmetics does not publish prices. Contact the company for a quote.

### How do I add A2A Cosmetics to Claude Code?

Run this command in your terminal: claude mcp add --transport http a2a-cosmetics https://mcp.a2a-cosmetics.ai/mcp

### What are the best alternatives to A2A Cosmetics?

The closest alternatives to A2A Cosmetics are O'So MCP Server for PrestaShop, SecureCloud, NY LLC Publication (FileMyPublication), MadMax Trade Supply parts and TribuJus.

## Alternatives

- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/a2a-cosmetics
