A2A Cosmetics
Agent-to-Agent (A2A) hub for cosmetics: skin care, fragrance, sun care, dermocosmetics.
我该使用它吗
质量与安全性
发现（1）
- LOWTool 'get_item' description lacks action verb在 get_item 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"a2a-cosmetics": {
"url": "https://mcp.a2a-cosmetics.ai/mcp"
}
}
}远程端点
https://mcp.a2a-cosmetics.ai/mcpstreamable-http它能做什么
工具清单
工具（20）
🟢resolve_jurisdiction(ship_to)
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.
输入模式
{
"type": "object",
"properties": {
"ship_to": {
"type": "string"
}
},
"required": [
"ship_to"
]
}输出模式
{
"type": "object"
}🟢resolve_actor(actor_class, credential)
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.
输入模式
{
"type": "object",
"properties": {
"actor_class": {
"type": "string"
},
"credential": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"actor_class"
]
}输出模式
{
"type": "object"
}🟢gate_transaction(ship_to, actor_class, product, product_type, ingredients, ...)
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.
输入模式
{
"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"
]
}输出模式
{
"type": "object"
}🟢get_ingredient_record(ingredient)
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.
输入模式
{
"type": "object",
"properties": {
"ingredient": {
"type": "string"
}
},
"required": [
"ingredient"
]
}输出模式
{
"type": "object"
}🟢get_market_status(product_type, market)
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.
输入模式
{
"type": "object",
"properties": {
"product_type": {
"type": "string"
},
"market": {
"type": "string"
}
},
"required": [
"product_type",
"market"
]
}输出模式
{
"type": "object"
}🟢get_notification_requirements(market, product_type)
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.
输入模式
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"product_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"market"
]
}输出模式
{
"type": "object"
}🟢get_label_and_claims(market, 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.
输入模式
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"claims": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"market"
]
}输出模式
{
"type": "object"
}🟢get_enforcement_watch(market, query, since)
Recalls, bans and safety alerts, dated: enforcement events by market, ingredient, brand or since a date, each with its source page.
输入模式
{
"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
}
}
}输出模式
{
"type": "object"
}🟢search_cleared_items(market, query, lane, product_type, limit, ...)
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.
输入模式
{
"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"
]
}输出模式
{
"type": "object"
}🟢get_item(gtin, market, decision_id)
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.
输入模式
{
"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"
]
}输出模式
{
"type": "object"
}🟢compare_items(gtins, market, decision_id)
Compare products, variants and shades side by side (two to eight GTINs or catalogue ids).
输入模式
{
"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"
]
}输出模式
{
"type": "object"
}🟢find_verified_supplier(market, decision_id, gtin, query, limit)
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.
输入模式
{
"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"
]
}输出模式
{
"type": "object"
}🟢get_availability(gtin, decision_id, market)
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).
输入模式
{
"type": "object",
"properties": {
"gtin": {
"type": "string"
},
"decision_id": {
"type": "string"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"gtin",
"decision_id"
]
}输出模式
{
"type": "object"
}🟢get_price(gtin, decision_id, market)
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.
输入模式
{
"type": "object",
"properties": {
"gtin": {
"type": "string"
},
"decision_id": {
"type": "string"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"gtin",
"decision_id"
]
}输出模式
{
"type": "object"
}🟢get_product_documents(gtin, decision_id, market)
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.
输入模式
{
"type": "object",
"properties": {
"gtin": {
"type": "string"
},
"decision_id": {
"type": "string"
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"gtin",
"decision_id"
]
}输出模式
{
"type": "object"
}🟢verify_gtin(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.
输入模式
{
"type": "object",
"properties": {
"gtin": {
"type": "string"
}
},
"required": [
"gtin"
]
}输出模式
{
"type": "object"
}🟡create_order_intent(gtin, quantity, decision_id, market, ship_to)
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.
输入模式
{
"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"
]
}输出模式
{
"type": "object"
}⚪a2a_handoff(intent_id, decision_id, counterparty_card_url)
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.
输入模式
{
"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
}
}
}输出模式
{
"type": "object"
}🟢get_safety_label(market, product_type)
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.
输入模式
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"product_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"market"
]
}输出模式
{
"type": "object"
}🟡log_audit(kind, reference_id, note)
Write a line to the audit record for a gate decision, an order intent or a handoff (returns the line id).
输入模式
{
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"reference_id": {
"type": "string"
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"kind",
"reference_id"
]
}输出模式
{
"type": "object"
}推荐提示词
search_cleared_itemssearch_cleared_itemsget_ingredient_recordget_ingredient_recordsearch_cleared_itemscreate_order_intent社区
证据