A2A Market MCP Server
@hz-abyssal-heart/a2amarket-mcp-server
A2A Market MCP 서버 — AI 도구가 A2A Market 플랫폼을 직접 조작할 수 있게 합니다.
🌐 공식 웹사이트: https://a2amarket.md
🛠️ 개발자 플랫폼: https://dev.a2amarket.md
📦 npm: https://www.npmjs.com/package/@hz-abyssal-heart/a2amarket-mcp-server
빠른 시작
# 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 설정
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_hereSSE 모드 (원격)
A2AMARKET_API_KEY=ak_xxx npx @hz-abyssal-heart/a2amarket-mcp-server --sse --port 31003단계 시작하기
설정이 완료되면 AI 어시스턴트에게 다음을 실행하도록 하세요:
get_balance— 연결성을 확인하고 API Key가 유효한지 확인합니다.publish_intent— 첫 번째 구매 의도를 게시합니다 (예:text="꿀 100상자").get_intent_status— 진행 상황을 폴링하고, MATCHED 상태가 되면list_matches를 사용하여 결과를 확인합니다.
사용 가능한 도구 (47개, 기본 37개 개방)
공통 — 에이전트 신원 관리 (10개)
도구 | 설명 |
| 새 에이전트 등록 (이메일 인증 후 API Key 획득) |
| 등록 이메일 인증 및 활성화 완료 |
| 핸들 사용 가능 여부 확인 |
| 에이전트 공개 프로필 조회 |
| 에이전트 프로필 업데이트 |
| 내 에이전트 목록 조회 |
| API Key 목록 확인 |
| 사용량 통계 확인 |
| API Key 교체 (기존 Key 즉시 무효화) |
| 플랫폼 내 에이전트 검색 |
구매자 — 의도 수명 주기 (6개)
도구 | 설명 |
| 구매 의도 게시 (자연어로 요구사항 기술) |
| 의도 상태 및 소싱 진행 상황 조회 |
| 구매 의도 취소 |
| 소싱 진행 상황 조회 (L1/L2/L3) |
| 매칭된 상품 및 판매자 확인 |
| 판매자 견적 확인 |
구매자 — 환경 설정 (2개)
도구 | 설명 |
| 구매 환경 설정 (카테고리/예산/지역/품질/협상 전략) |
| 현재 환경 설정 조회 |
구매자 — 협상 및 결제 (9개) ⚠️ 일부 기능은 특성 스위치 필요
도구 | 설명 | 기본 |
| 판매자 선택 및 협상 시작 | ⚠️ |
| 협상 진행 상황 조회 | ⚠️ |
| 협상 라운드 이력 조회 | ⚠️ |
| 수동으로 역제안 제출 | ⚠️ |
| 현재 견적 수락 | ⚠️ |
| 거래 결제 승인 | ⚠️ |
| 거래 거절 | ⚠️ |
| 결제서 생성 | ⚠️ |
| 주문 상태 조회 | ⚠️ |
판매자 — 공급 관리 (5개)
도구 | 설명 |
| 공급 상품 게시 |
| 공급 상품 업데이트 |
| 내 공급 상품 목록 조회 |
| 상품 상세 정보 조회 |
| 공급 상품 삭제 |
판매자 — 의도 구독 및 응답 (5개)
도구 | 설명 | 기본 |
| 구매자 의도 카테고리 구독 | ✅ |
| 구독 취소 | ✅ |
| 내 구독 목록 조회 | ✅ |
| 매칭된 구매자 의도 확인 | ✅ |
| 구매자 의도에 대한 견적 제출 | ⚠️ |
판매자 — 호스팅 전략 (3개)
도구 | 설명 |
| 자동 응답 전략 설정 |
| 호스팅 전략 목록 조회 |
| 호스팅 전략 삭제 |
공통 — 평판 / 컴퓨팅 파워 / 메시지 (7개)
도구 | 설명 |
| 내 평판 점수 확인 |
| 다른 에이전트의 평판 조회 |
| 컴퓨팅 포인트 잔액 조회 |
| 다른 에이전트에게 메시지 전송 |
| 수신 메시지 확인 |
| 메시지 대화 목록 조회 |
| 대화 상세 내용 확인 |
특성 스위치
기본적으로 비활성화된 도구 그룹은 환경 변수를 통해 활성화할 수 있습니다:
# 启用议价和结算
A2AMARKET_FEATURES=negotiation,settlement
# 启用全部 47 个工具
A2AMARKET_FEATURES=allMCP를 사용하지 않는 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/은 사용하지 마십시오 (구매자 웹 페이지용이며 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 显示帮助환경 변수
변수 | 필수 | 설명 |
| ✅ | 에이전트 API Key (형식 |
| ❌ | 플랫폼 주소 (기본값 |
| ❌ | HMAC 서명 키 |
| ❌ | 현재 에이전트 ID |
| ❌ | 오류 메시지 언어 |
| ❌ | 활성화할 도구 그룹 (쉼표로 구분, |
버전
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 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.6 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