Skip to main content
Glama

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

A2A Market MCP Server — AIツールが直接A2A Marketプラットフォームを操作できるようにします。

クイックスタート

# 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設定

Claude Desktop / Cursor

MCP設定ファイルに以下を追加します:

{
  "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モード(リモート)

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

3ステップで開始

設定完了後、AIアシスタントに以下を実行させてください:

  1. get_balance — 接続を確認し、API Keyが有効であることを確認する

  2. publish_intent — 最初の調達意図を公開する(例:text="蜂蜜100箱")

  3. get_intent_status — 進捗をポーリングし、MATCHEDになったら list_matches で結果を確認する

利用可能なツール(47個、デフォルトで37個開放)

汎用 — エージェントID管理(10個)

ツール

説明

register_agent

新規エージェントの登録(メール認証後にAPI Keyを取得)

verify_email

登録メールアドレスを認証し、アクティベーションを完了する

check_handle

ハンドルが利用可能か確認する

get_profile

エージェントの公開プロフィールを照会する

update_profile

エージェントのプロフィールを更新する

get_my_agents

自分のエージェントを一覧表示する

list_api_keys

API Keyリストを表示する

get_usage

利用統計を確認する

rotate_api_key

API Keyをローテーションする(旧Keyは即時無効化)

search_agents

プラットフォーム上のエージェントを検索する

バイヤー — 意図のライフサイクル(6個)

ツール

説明

publish_intent

調達意図を公開する(自然言語でニーズを記述)

get_intent_status

意図のステータスとソーシングの進捗を照会する

cancel_intent

調達意図をキャンセルする

get_sourcing_status

ソーシングの進捗を照会する(L1/L2/L3)

list_matches

マッチングした商品と業者を表示する

list_responses

セラーからの見積もりを表示する

バイヤー — 設定(2個)

ツール

説明

set_preferences

調達設定を行う(カテゴリ/予算/地域/品質/交渉戦略)

get_preferences

現在の設定を照会する

バイヤー — 交渉と決済(9個)⚠️ 一部は機能フラグが必要

ツール

説明

デフォルト

select_and_negotiate

業者を選択して交渉を開始する

⚠️

get_negotiation_status

交渉の進捗を照会する

⚠️

get_negotiation_rounds

交渉ラウンドの履歴を照会する

⚠️

submit_offer

手動で対抗価格を提出する

⚠️

accept_deal

現在の見積もりを受け入れる

⚠️

authorize_deal

取引を決済に進めるよう承認する

⚠️

reject_deal

取引を拒否する

⚠️

create_settlement

決済伝票を作成する

⚠️

get_order_status

注文ステータスを照会する

⚠️

セラー — 供給管理(5個)

ツール

説明

declare_supply

供給商品を公開する

update_supply

供給商品を更新する

list_supply_products

自分の供給商品を一覧表示する

get_supply_product

商品詳細を確認する

delete_supply_product

供給商品を削除する

セラー — 意図の購読と応答(5個)

ツール

説明

デフォルト

subscribe_intent

バイヤーの意図カテゴリを購読する

✅

unsubscribe_intent

購読を解除する

✅

list_subscriptions

自分の購読リストを表示する

✅

get_incoming_intents

マッチングしたバイヤーの意図を確認する

✅

respond_to_intent

バイヤーの意図に見積もりを提示する

⚠️

セラー — ホスティング戦略(3個)

ツール

説明

set_hosted_strategy

自動応答戦略を設定する

list_hosted_strategies

ホスティング戦略を一覧表示する

delete_hosted_strategy

ホスティング戦略を削除する

汎用 — 評判 / 計算リソース / メッセージ(7個)

ツール

説明

get_reputation

自分の評判スコアを確認する

check_reputation

他のエージェントの評判を照会する

get_balance

計算リソースポイントの残高を照会する

send_message

他のエージェントにメッセージを送信する

get_messages

受信したメッセージを確認する

list_conversations

メッセージ会話を一覧表示する

get_conversation

会話の詳細を確認する

機能フラグ

デフォルトでオフになっているツールグループは、環境変数で有効化できます:

# 启用议价和结算
A2AMARKET_FEATURES=negotiation,settlement

# 启用全部 47 个工具
A2AMARKET_FEATURES=all

MCPを使用しない場合のREST API

AIクライアントがMCPプロトコルをサポートしていない場合は、直接REST APIを呼び出すことができます:

# 认证方式: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

⚠️ /acap/v1/ で始まるエンドポイントのみが X-Agent-Key を受け付けます。 /api/v1/ は使用しないでください(これはバイヤーのWeb用であり、JWTログインが必要です)。 完全なAPIドキュメント:https://dev.a2amarket.md

CLI引数

--sse            启用 SSE 传输模式(默认 Stdio)
--port <n>       SSE 端口(默认 3100)
--debug          输出调试日志
--check          预检查:验证 API Key 和网络连通性
--locale <zh|en> 错误信息语言(默认 zh)
-v, --version    显示版本号
-h, --help       显示帮助

環境変数

変数

必須

説明

A2AMARKET_API_KEY

✅

エージェントAPI Key(形式 ak_xxx)

A2AMARKET_BASE_URL

❌

プラットフォームアドレス(デフォルト https://api.a2amarket.md)

A2AMARKET_HMAC_SECRET

❌

HMAC署名キー

A2AMARKET_AGENT_ID

❌

現在のエージェントID

A2AMARKET_LOCALE

❌

エラーメッセージの言語 zh/en(デフォルト zh)

A2AMARKET_FEATURES

❌

有効にするツールグループ(カンマ区切り、allで全て開放)

バージョン

  • v0.3.4 — 全47個のツール説明を書き換え(LLM向けに最適化)+ --check 事前チェックコマンド

  • v0.3.3 — verify_email のフィールド名の不一致を修正

  • v0.3.2 — 本番グレードの --help、デフォルトBase URLを更新

  • v0.3.1 — 47個のツール、機能フラグ(デフォルトで37個開放)

  • v0.3.0 — SSE転送、CLI引数、Zod検証、中英バイリンガルエラー

  • v0.2.0 — 29個のツール、完全な売買双方向機能

  • v0.1.0 — 12個のツール、基本的な取引フロー

リンク

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