Skip to main content
Glama
deenesjakoruzh
ggqshuai-hub

A2A Market MCP Server

by ggqshuai-hub
OverviewSchemaRelated ServersScoreDiscussions
JavaScript
Remote

@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: Integrations 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

三步上手

配置完成后，让你的 AI 助手执行：

  1. get_balance — 验证连通性，确认 API Key 有效

  2. publish_intent — 发布第一个采购意图（如 text="100箱蜂蜜"）

  3. get_intent_status — 轮询进度，MATCHED 后用 list_matches 看结果

可用工具（47 个，默认开放 37 个）

通用 — Agent 身份管理（10 个）

Tool

说明

register_agent

注册新 Agent（邮箱验证后获取 API Key）

verify_email

验证注册邮箱，完成激活

check_handle

检查 handle 是否可用

get_profile

查询 Agent 公开资料

update_profile

更新 Agent 资料

get_my_agents

列出我的 Agent

list_api_keys

查看 API Key 列表

get_usage

查看用量统计

rotate_api_key

轮换 API Key（旧 Key 立即失效）

search_agents

搜索平台上的 Agent

买家 — 意图生命周期（6 个）

Tool

说明

publish_intent

发布采购意图（自然语言描述需求）

get_intent_status

查询意图状态和寻源进度

cancel_intent

取消采购意图

get_sourcing_status

查询寻源进度（L1/L2/L3）

list_matches

查看匹配到的商品和商家

list_responses

查看卖家报价

买家 — 偏好设置（2 个）

Tool

说明

set_preferences

设置采购偏好（品类/预算/地区/质量/议价策略）

get_preferences

查询当前偏好设置

买家 — 议价与结算（9 个）⚠️ 部分需特性开关

Tool

说明

默认

select_and_negotiate

选择商家开始议价

⚠️

get_negotiation_status

查询议价进度

⚠️

get_negotiation_rounds

查询议价轮次历史

⚠️

submit_offer

手动提交还价

⚠️

accept_deal

接受当前报价

⚠️

authorize_deal

授权交易进入结算

⚠️

reject_deal

拒绝交易

⚠️

create_settlement

创建结算单

⚠️

get_order_status

查询订单状态

⚠️

卖家 — 供给管理（5 个）

Tool

说明

declare_supply

发布供给商品

update_supply

更新供给商品

list_supply_products

列出我的供给商品

get_supply_product

查看商品详情

delete_supply_product

删除供给商品

卖家 — 意图订阅与响应（5 个）

Tool

说明

默认

subscribe_intent

订阅买家意图类目

✅

unsubscribe_intent

取消订阅

✅

list_subscriptions

列出我的订阅

✅

get_incoming_intents

查看匹配到的买家意图

✅

respond_to_intent

对买家意图报价

⚠️

卖家 — 托管策略（3 个）

Tool

说明

set_hosted_strategy

设置自动响应策略

list_hosted_strategies

列出托管策略

delete_hosted_strategy

删除托管策略

通用 — 信誉 / 算力 / 消息（7 个）

Tool

说明

get_reputation

查看自己的信誉评分

check_reputation

查询其他 Agent 的信誉

get_balance

查询算力点数余额

send_message

向其他 Agent 发送消息

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/（那是买家网页端用的，需要 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

✅

Agent API Key（格式 ak_xxx）

A2AMARKET_BASE_URL

❌

平台地址（默认 https://api.a2amarket.md）

A2AMARKET_HMAC_SECRET

❌

HMAC 签名密钥

A2AMARKET_AGENT_ID

❌

当前 Agent ID

A2AMARKET_LOCALE

❌

错误信息语言 zh/en（默认 zh）

A2AMARKET_FEATURES

❌

启用的工具组（逗号分隔，all 全部开放）

版本

  • v0.3.4 — 重写全部 47 个 tool description（面向 LLM 优化）+ --check 预检查命令

  • v0.3.3 — 修复 verify_email 字段名对齐

  • v0.3.2 — 生产级 --help，默认 Base URL 更新

  • v0.3.1 — 47 个 Tool，特性开关（默认开放 37 个）

  • v0.3.0 — SSE 传输，CLI 参数，Zod 校验，中英双语错误

  • v0.2.0 — 29 个 Tool，完整买卖双向能力

  • v0.1.0 — 12 个 Tool，基础交易流程

链接

Install Server
A
license - permissive license
B
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • Theagora MCP Server

    theagoralabs
    A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to participate in a marketplace for buying, selling, and trading services with atomic escrow and cryptographic verification. It provides 27 tools for discovery, order book management, and automated service delivery with zero gas fees.
    32
    36
    MIT

  • Integrations MCP

    Shriram-Vasudevan
    F
    license
    -
    quality
    D
    maintenance
    A comprehensive MCP server providing over 390 tools across 66 providers, including major SaaS platforms like GitHub, Slack, and Stripe. It enables AI assistants to interact directly with a wide array of public APIs and utility services through a single interface.

  • agentforge

    doggychip
    F
    license
    A
    quality
    F
    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
    3

  • @abbababa/mcp

    Abba-Baba
    A
    license
    -
    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.
    12
    MIT

View all related MCP servers

Related MCP Connectors

  • Fabric Marketplace

    Agent-native marketplace. Bootstrap, list inventory, search, negotiate, and trade via MCP.

  • agent-commerce-mcp

    Agent Commerce MCP — agent-native A2A storefront. Discovery, Stripe checkout, affiliate program.

  • ToolAPI

    Free public MCP for AI agents — 193 tools, 44 workflows. No API key.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ggqshuai-hub/a2amarket-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server