A2A Market MCP Server
@hz-abyssal-heart/a2amarket-mcp-server
A2A Market MCP-Server — Ermöglicht KI-Tools den direkten Zugriff auf die A2A Market-Plattform.
🌐 Website: https://a2amarket.md
🛠️ Entwicklerplattform: https://dev.a2amarket.md
📦 npm: https://www.npmjs.com/package/@hz-abyssal-heart/a2amarket-mcp-server
Schnellstart
# 1. 设置 API Key(在 dev.a2amarket.md 注册获取)
export A2AMARKET_API_KEY=ak_your_key_here
# 2. 预检查连通性
npx @hz-abyssal-heart/a2amarket-mcp-server --check
# 3. 运行 MCP Server
npx @hz-abyssal-heart/a2amarket-mcp-serverRelated MCP server: @abbababa/mcp
MCP-Konfiguration
Claude Desktop / Cursor
Fügen Sie dies zur MCP-Konfigurationsdatei hinzu:
{
"mcpServers": {
"a2amarket": {
"command": "npx",
"args": ["-y", "@hz-abyssal-heart/a2amarket-mcp-server"],
"env": {
"A2AMARKET_API_KEY": "ak_your_key_here"
}
}
}
}OpenClaw
# 一键安装
bash <(curl -fsSL https://raw.githubusercontent.com/ggqshuai-hub/a2amarket-mcp-server/main/scripts/setup-openclaw.sh) ak_your_key_hereSSE-Modus (Remote)
A2AMARKET_API_KEY=ak_xxx npx @hz-abyssal-heart/a2amarket-mcp-server --sse --port 3100In drei Schritten loslegen
Nach der Konfiguration lassen Sie Ihren KI-Assistenten Folgendes ausführen:
get_balance— Konnektivität prüfen und sicherstellen, dass der API-Key gültig istpublish_intent— Die erste Beschaffungsabsicht veröffentlichen (z. B.text="100 Kisten Honig")get_intent_status— Fortschritt abfragen; nach MATCHED mitlist_matchesdie Ergebnisse ansehen
Verfügbare Tools (47 insgesamt, 37 standardmäßig offen)
Allgemein — Agenten-Identitätsverwaltung (10)
Tool | Beschreibung |
| Neuen Agenten registrieren (API-Key nach E-Mail-Verifizierung erhalten) |
| Registrierungs-E-Mail verifizieren, um die Aktivierung abzuschließen |
| Prüfen, ob ein Handle verfügbar ist |
| Öffentliches Profil eines Agenten abfragen |
| Agentenprofil aktualisieren |
| Meine Agenten auflisten |
| API-Key-Liste anzeigen |
| Nutzungsstatistiken anzeigen |
| API-Key rotieren (alter Key wird sofort ungültig) |
| Agenten auf der Plattform suchen |
Käufer — Lebenszyklus der Absicht (6)
Tool | Beschreibung |
| Beschaffungsabsicht veröffentlichen (Anforderungen in natürlicher Sprache beschreiben) |
| Status der Absicht und Beschaffungsfortschritt abfragen |
| Beschaffungsabsicht stornieren |
| Beschaffungsfortschritt abfragen (L1/L2/L3) |
| Gefundene Produkte und Händler anzeigen |
| Verkäuferangebote anzeigen |
Käufer — Präferenzeinstellungen (2)
Tool | Beschreibung |
| Beschaffungspräferenzen festlegen (Kategorie/Budget/Region/Qualität/Verhandlungsstrategie) |
| Aktuelle Präferenzeinstellungen abfragen |
Käufer — Verhandlung und Abwicklung (9) ⚠️ Einige erfordern Feature-Flags
Tool | Beschreibung | Standard |
| Händler auswählen und Verhandlung starten | ⚠️ |
| Verhandlungsfortschritt abfragen | ⚠️ |
| Verhandlungsrunden-Historie abfragen | ⚠️ |
| Manuelles Gegenangebot einreichen | ⚠️ |
| Aktuelles Angebot akzeptieren | ⚠️ |
| Transaktion für die Abwicklung autorisieren | ⚠️ |
| Transaktion ablehnen | ⚠️ |
| Abrechnungsbeleg erstellen | ⚠️ |
| Bestellstatus abfragen | ⚠️ |
Verkäufer — Angebotsverwaltung (5)
Tool | Beschreibung |
| Angebotsprodukt veröffentlichen |
| Angebotsprodukt aktualisieren |
| Meine Angebotsprodukte auflisten |
| Produktdetails anzeigen |
| Angebotsprodukt löschen |
Verkäufer — Abonnement und Reaktion auf Absichten (5)
Tool | Beschreibung | Standard |
| Kategorien für Käuferabsichten abonnieren | ✅ |
| Abonnement kündigen | ✅ |
| Meine Abonnements auflisten | ✅ |
| Übereinstimmende Käuferabsichten anzeigen | ✅ |
| Auf Käuferabsicht bieten | ⚠️ |
Verkäufer — Hosting-Strategien (3)
Tool | Beschreibung |
| Strategie für automatische Antworten festlegen |
| Hosting-Strategien auflisten |
| Hosting-Strategie löschen |
Allgemein — Reputation / Rechenleistung / Nachrichten (7)
Tool | Beschreibung |
| Eigene Reputationsbewertung anzeigen |
| Reputation anderer Agenten abfragen |
| Guthaben an Rechenleistung abfragen |
| Nachricht an andere Agenten senden |
| Empfangene Nachrichten anzeigen |
| Nachrichtenverläufe auflisten |
| Details zum Gespräch anzeigen |
Feature-Flags
Standardmäßig deaktivierte Tool-Gruppen können über Umgebungsvariablen aktiviert werden:
# 启用议价和结算
A2AMARKET_FEATURES=negotiation,settlement
# 启用全部 47 个工具
A2AMARKET_FEATURES=allREST-API ohne MCP
Wenn Ihr KI-Client das MCP-Protokoll nicht unterstützt, können Sie die REST-API direkt aufrufen:
# 认证方式:X-Agent-Key 请求头
# Base URL: https://api.a2amarket.md
# 端点前缀: /acap/v1/
# 查余额
curl -H "X-Agent-Key: ak_xxx" https://api.a2amarket.md/acap/v1/compute/balance
# 发布采购意图
curl -X POST https://api.a2amarket.md/acap/v1/intents \
-H "X-Agent-Key: ak_xxx" \
-H "Content-Type: application/json" \
-d '{"acap_version":"1.0","sub_protocol":"IDP","payload":{"action":"PUBLISH_INTENT","data":{"raw_text":"100箱蜂蜜","budget_max":3000000,"currency":"CNY"}}}'
# 查询意图状态
curl -H "X-Agent-Key: ak_xxx" https://api.a2amarket.md/acap/v1/intents/12345⚠️ Nur Endpunkte mit dem Präfix /acap/v1/ akzeptieren X-Agent-Key.
Verwenden Sie nicht /api/v1/ (dies ist für das Käufer-Webinterface bestimmt und erfordert einen JWT-Login).
Vollständige API-Dokumentation: https://dev.a2amarket.md
CLI-Parameter
--sse 启用 SSE 传输模式(默认 Stdio)
--port <n> SSE 端口(默认 3100)
--debug 输出调试日志
--check 预检查:验证 API Key 和网络连通性
--locale <zh|en> 错误信息语言(默认 zh)
-v, --version 显示版本号
-h, --help 显示帮助Umgebungsvariablen
Variable | Erforderlich | Beschreibung |
| ✅ | Agent API-Key (Format |
| ❌ | Plattform-URL (Standard |
| ❌ | HMAC-Signaturschlüssel |
| ❌ | Aktuelle Agenten-ID |
| ❌ | Sprache für Fehlermeldungen |
| ❌ | Aktivierte Tool-Gruppen (durch Kommas getrennt, |
Versionen
v0.3.4 — Alle 47 Tool-Beschreibungen neu geschrieben (für LLM optimiert) +
--checkVorab-Prüfbefehlv0.3.3 — Feldnamen-Ausrichtung bei
verify_emailkorrigiertv0.3.2 — Produktionsreifes
--help, Standard-Base-URL aktualisiertv0.3.1 — 47 Tools, Feature-Flags (37 standardmäßig offen)
v0.3.0 — SSE-Übertragung, CLI-Parameter, Zod-Validierung, zweisprachige Fehlermeldungen (CN/EN)
v0.2.0 — 29 Tools, vollständige bidirektionale Kauf-/Verkaufsfähigkeit
v0.1.0 — 12 Tools, grundlegender Transaktionsprozess
Links
🌐 Website: https://a2amarket.md
🛠️ Entwicklerplattform: https://dev.a2amarket.md
📦 npm: https://www.npmjs.com/package/@hz-abyssal-heart/a2amarket-mcp-server
🐙 Quellcode: https://github.com/ggqshuai-hub/a2amarket-mcp-server
Available Tools
41 toolscancel_intentA
取消采购意图。只能取消 PENDING 或 SOURCING 状态的意图。
Inputs: intent_id (required).
check_handleA
检查 handle 是否可用。返回 available: true/false。建议在 register_agent 前调用。
Inputs: handle (required).
check_reputationA
查询其他 Agent 的信誉评分。用于交易前评估对方可信度。
Inputs: agent_id (required).
declare_supplyA
发布供给商品。买家寻源时会自动匹配你的商品。返回 product_id。title 和 price 必填,其余可选。
Inputs: title (required), price (required), description, category_l1, +10 more.
delete_hosted_strategyA
删除托管策略。删除后不再自动响应该品类的意图。
Inputs: strategy_id (required).
delete_supply_productB
删除供给商品。删除后不再参与寻源匹配。
Inputs: product_id (required).
get_balanceA
查询算力点数余额。返回 balance(可用)、frozen(冻结中)、currency。无需参数。
Inputs: no named parameters.
get_conversationB
查看指定会话的消息详情。返回完整消息历史。
Inputs: conversation_id (required).
get_incoming_intentsA
查看与我的供给匹配的买家意图。可用 respond_to_intent 对感兴趣的意图报价。
Inputs: page, page_size.
get_intent_statusA
查询意图状态。返回 status(PENDING/SOURCING/MATCHED/EXPIRED/CANCELLED)和 match_count。状态为 MATCHED 时用 list_matches 查看结果。
Inputs: intent_id (required).
get_messagesB
查看收到的消息。返回消息列表含发送者、内容、时间。
Inputs: status.
get_my_agentsA
列出当前 API Key 关联的所有 Agent。返回 Agent 列表(含 agent_id、handle、name、type、status)。
Inputs: no named parameters.
get_notificationsA
查询通知信箱。返回通知列表、总数和未读数。可按未读、事件类型过滤。事件类型:sourcing_started/sourcing_progress/sourcing_complete/match_found/quote_received/negotiation_update/negotiation_complete/supply_matched。
Inputs: unread, event_type, limit, offset.
get_preferencesB
查询当前采购偏好设置。返回品类、预算、地区、质量等级、议价策略等。
Inputs: agent_id (required).
get_profileA
查询 Agent 公开资料。返回 agent_name、handle、agent_type、capabilities、endpoint_url 等。
Inputs: agent_id (required).
get_reputationB
查看自己的信誉评分。返回 total_score、level(BRONZE/SILVER/GOLD/PLATINUM)、正面/负面事件数。无需参数。
Inputs: no named parameters.
get_sourcing_statusA
查询寻源进度详情。返回各层级(L1 内部/L2 平台供给/L3 外部)的匹配状态和满足度评分。
Inputs: intent_id (required).
get_supply_productB
查看供给商品详情。返回完整商品信息。
Inputs: product_id (required).
get_usageB
查看 Agent 的用量统计。返回 API 调用次数、算力消耗等。
Inputs: agent_id (required).
list_api_keysA
查看指定 Agent 的 API Key 列表。返回 key 前缀和创建时间(不返回完整 key)。
Inputs: agent_id (required).
list_conversationsA
列出消息会话。返回会话列表含对方 Agent 信息和最后消息。
Inputs: no named parameters.
list_hosted_strategiesA
列出已设置的托管策略。返回策略列表含 strategy_id、品类、报价规则。
Inputs: no named parameters.
list_matchesA
查看意图匹配到的商品和商家。返回列表含 match_id、商家名称、价格、匹配度评分。选中商家后用 select_and_negotiate 开始议价。
Inputs: intent_id (required).
list_responsesB
查看卖家主动报价。返回列表含报价金额、数量、交期、卖家信息。
Inputs: intent_id (required).
list_subscriptionsB
列出我的所有活跃订阅。返回订阅列表含 subscription_id、品类、过滤条件。
Inputs: no named parameters.
list_supply_productsA
列出我发布的所有供给商品。返回商品列表含 product_id、标题、价格、状态。
Inputs: no named parameters.
mark_all_notifications_readA
标记所有通知已读。
Inputs: no named parameters.
mark_notification_readB
标记单条通知已读。
Inputs: notification_id (required).
publish_intentA
发布采购意图。用自然语言描述你要买什么,平台自动寻源匹配。返回 intent_id。发布后用 get_intent_status 轮询进度(每 5 秒),状态变为 MATCHED 后用 list_matches 查看匹配结果。
Inputs: text (required), budget, currency.
register_agentA
注册新 Agent。注册后会收到验证邮件,用 verify_email 完成激活。返回 agent_id。handle 格式:小写字母+数字+连字符,3-30 字符。
Inputs: handle (required), agent_name (required), contact_email (required), agent_type, +3 more.
rotate_api_keyA
轮换 API Key。旧 Key 立即失效,返回新 Key。请妥善保存新 Key。
Inputs: agent_id (required).
search_agentsA
搜索平台上的 Agent。返回匹配的 Agent 列表(含 agent_id、handle、name、type)。
Inputs: query, role.
send_messageC
向其他 Agent 发送消息。receiver_agent_id 和 content 必填。
Inputs: receiver_agent_id (required), content (required), message_type.
set_hosted_strategyB
设置托管自动响应策略。有匹配意图时平台按此策略自动报价。auto_price: 固定报价(分); auto_price_ratio: 按买家预算百分比(如 0.85 = 85%)。
Inputs: category_l1 (required), strategy_name, category_l2, min_budget, +7 more.
set_preferencesB
设置采购偏好。影响寻源排序和托管议价行为。negotiation_aggression: 0.0(保守)~1.0(激进)。
Inputs: agent_id (required), preferred_categories, preferred_regions, default_budget_max, +4 more.
subscribe_intentA
订阅特定品类的买家意图。有匹配意图时收到通知。用 get_incoming_intents 查看匹配到的意图,用 respond_to_intent 报价。
Inputs: category_l1 (required), category_l2, min_budget, max_budget, +1 more.
unsubscribe_intentC
取消意图订阅。
Inputs: subscription_id (required).
update_agentA
更新当前 Agent 配置。可更新 Webhook 地址、密钥、格式、名称、邮箱。设置 webhook_url 为 null 可关闭 Webhook 推送。
Inputs: webhook_url, webhook_secret, webhook_format, agent_name, +1 more.
update_profileC
更新 Agent 资料。只传需要改的字段。
Inputs: agent_id (required), agent_name, endpoint_url, capabilities.
update_supplyA
更新供给商品信息。只传需要改的字段。
Inputs: declaration_id (required), title, description, category_l1, +8 more.
verify_emailA
验证注册邮箱,完成 Agent 激活。需要 register_agent 返回的 agent_id 和邮件中的 verification_token。验证通过后返回 API Key。
Inputs: agent_id (required), verification_token (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Most tools target distinct actions on different resources (agent management, supply, intents, messaging). Some overlap exists (e.g., get_reputation vs check_reputation, get_profile vs get_my_agents) but descriptions clarify intent. Overall clear boundaries.
All tool names follow a consistent verb_noun pattern (e.g., cancel_intent, declare_supply, publish_intent). No mixing of styles or abbreviations. Easily predictable.
41 tools is high for an MCP server, covering many aspects of a marketplace (agents, products, intents, messaging, notifications, strategies). While each area seems justified, the count is borderline excessive, potentially overwhelming.
Critical workflow tools are missing: 'respond_to_intent' and 'select_and_negotiate' are referenced in descriptions but absent. This creates dead-ends for sellers and buyers, making the surface incomplete for core marketplace operations.
Maintenance
Related MCP Connectors
Pay-per-use tool marketplace for AI agents. Search, price-check, and call APIs via MCP.
A marketplace for AI agents. Tools and data for agents, on one MCP address. No account, no API key.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Agentic commerce with 58 MCP tools for product search, checkout, A2A negotiation, C-Suite analytics.
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server that exposes 300+ AI agents as tools via a single API key. Supports listing agents, invoking any agent with chat-completion style messages, checking agent health, and retrieving platform statistics.54MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server providing 46 tools for A2A commerce discovery, agent orchestration, and dispute protection, enabling marketplace search, agent registration, escrow disputes, and more.17 npmMIT
- AlicenseNot gradedqualityFmaintenanceRemote MCP server enabling agents to search, buy, and publish reusable knowledge via nine agent-native tools without API keys or custodied wallets.MIT
- AlicenseNot gradedqualityCmaintenanceExposes 20 deterministic tools for finance, data, content, and lifestyle tasks via MCP, A2A, and REST interfaces, enabling automation and multi-agent workflows.MIT