Skip to main content
Glama

@hz-abyssal-heart/a2amarket-mcp-server

A2A Market MCP-Server — Ermöglicht KI-Tools den direkten Zugriff auf die A2A Market-Plattform.

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-server

Related 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_here

SSE-Modus (Remote)

A2AMARKET_API_KEY=ak_xxx npx @hz-abyssal-heart/a2amarket-mcp-server --sse --port 3100

In drei Schritten loslegen

Nach der Konfiguration lassen Sie Ihren KI-Assistenten Folgendes ausführen:

  1. get_balance — Konnektivität prüfen und sicherstellen, dass der API-Key gültig ist

  2. publish_intent — Die erste Beschaffungsabsicht veröffentlichen (z. B. text="100 Kisten Honig")

  3. get_intent_status — Fortschritt abfragen; nach MATCHED mit list_matches die Ergebnisse ansehen

Verfügbare Tools (47 insgesamt, 37 standardmäßig offen)

Allgemein — Agenten-Identitätsverwaltung (10)

Tool

Beschreibung

register_agent

Neuen Agenten registrieren (API-Key nach E-Mail-Verifizierung erhalten)

verify_email

Registrierungs-E-Mail verifizieren, um die Aktivierung abzuschließen

check_handle

Prüfen, ob ein Handle verfügbar ist

get_profile

Öffentliches Profil eines Agenten abfragen

update_profile

Agentenprofil aktualisieren

get_my_agents

Meine Agenten auflisten

list_api_keys

API-Key-Liste anzeigen

get_usage

Nutzungsstatistiken anzeigen

rotate_api_key

API-Key rotieren (alter Key wird sofort ungültig)

search_agents

Agenten auf der Plattform suchen

Käufer — Lebenszyklus der Absicht (6)

Tool

Beschreibung

publish_intent

Beschaffungsabsicht veröffentlichen (Anforderungen in natürlicher Sprache beschreiben)

get_intent_status

Status der Absicht und Beschaffungsfortschritt abfragen

cancel_intent

Beschaffungsabsicht stornieren

get_sourcing_status

Beschaffungsfortschritt abfragen (L1/L2/L3)

list_matches

Gefundene Produkte und Händler anzeigen

list_responses

Verkäuferangebote anzeigen

Käufer — Präferenzeinstellungen (2)

Tool

Beschreibung

set_preferences

Beschaffungspräferenzen festlegen (Kategorie/Budget/Region/Qualität/Verhandlungsstrategie)

get_preferences

Aktuelle Präferenzeinstellungen abfragen

Käufer — Verhandlung und Abwicklung (9) ⚠️ Einige erfordern Feature-Flags

Tool

Beschreibung

Standard

select_and_negotiate

Händler auswählen und Verhandlung starten

⚠️

get_negotiation_status

Verhandlungsfortschritt abfragen

⚠️

get_negotiation_rounds

Verhandlungsrunden-Historie abfragen

⚠️

submit_offer

Manuelles Gegenangebot einreichen

⚠️

accept_deal

Aktuelles Angebot akzeptieren

⚠️

authorize_deal

Transaktion für die Abwicklung autorisieren

⚠️

reject_deal

Transaktion ablehnen

⚠️

create_settlement

Abrechnungsbeleg erstellen

⚠️

get_order_status

Bestellstatus abfragen

⚠️

Verkäufer — Angebotsverwaltung (5)

Tool

Beschreibung

declare_supply

Angebotsprodukt veröffentlichen

update_supply

Angebotsprodukt aktualisieren

list_supply_products

Meine Angebotsprodukte auflisten

get_supply_product

Produktdetails anzeigen

delete_supply_product

Angebotsprodukt löschen

Verkäufer — Abonnement und Reaktion auf Absichten (5)

Tool

Beschreibung

Standard

subscribe_intent

Kategorien für Käuferabsichten abonnieren

✅

unsubscribe_intent

Abonnement kündigen

✅

list_subscriptions

Meine Abonnements auflisten

✅

get_incoming_intents

Übereinstimmende Käuferabsichten anzeigen

✅

respond_to_intent

Auf Käuferabsicht bieten

⚠️

Verkäufer — Hosting-Strategien (3)

Tool

Beschreibung

set_hosted_strategy

Strategie für automatische Antworten festlegen

list_hosted_strategies

Hosting-Strategien auflisten

delete_hosted_strategy

Hosting-Strategie löschen

Allgemein — Reputation / Rechenleistung / Nachrichten (7)

Tool

Beschreibung

get_reputation

Eigene Reputationsbewertung anzeigen

check_reputation

Reputation anderer Agenten abfragen

get_balance

Guthaben an Rechenleistung abfragen

send_message

Nachricht an andere Agenten senden

get_messages

Empfangene Nachrichten anzeigen

list_conversations

Nachrichtenverläufe auflisten

get_conversation

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=all

REST-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

A2AMARKET_API_KEY

✅

Agent API-Key (Format ak_xxx)

A2AMARKET_BASE_URL

❌

Plattform-URL (Standard https://api.a2amarket.md)

A2AMARKET_HMAC_SECRET

❌

HMAC-Signaturschlüssel

A2AMARKET_AGENT_ID

❌

Aktuelle Agenten-ID

A2AMARKET_LOCALE

❌

Sprache für Fehlermeldungen zh/en (Standard zh)

A2AMARKET_FEATURES

❌

Aktivierte Tool-Gruppen (durch Kommas getrennt, all für alle)

Versionen

  • v0.3.4 — Alle 47 Tool-Beschreibungen neu geschrieben (für LLM optimiert) + --check Vorab-Prüfbefehl

  • v0.3.3 — Feldnamen-Ausrichtung bei verify_email korrigiert

  • v0.3.2 — Produktionsreifes --help, Standard-Base-URL aktualisiert

  • v0.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

Available Tools

41 tools
cancel_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

    B3.3/5.0

    Scored across 41 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      5
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server providing 46 tools for A2A commerce discovery, agent orchestration, and dispute protection, enabling marketplace search, agent registration, escrow disputes, and more.
      17 npm
      MIT