AgentCard

@agent-cards/mcp

为你的 AI Agent 配备一张借记卡。AgentCard 让 AI Agent 能够创建和使用虚拟借记卡——每张卡都有固定预算、真实卡片凭证，并完整集成 MCP。你的 Agent 可以创建卡片、支付费用、查看余额，并自动填写结账表单——无需使用你的个人卡片。

快速设置

连接 Agent 的最快方式是通过 CLI：

npx agent-cards signup    # create an account (one-time)
npx agent-cards setup-mcp # auto-configures Claude Code

就是这么简单。重启 Claude Code，即可使用这些工具。

手动设置

HTTP（推荐）

添加到你的 MCP 客户端配置中（Claude Desktop、Cursor 等）：

{
  "mcpServers": {
    "agent-cards": {
      "url": "https://mcp.agentcard.sh/mcp",
      "headers": {
        "Authorization": "Bearer <your-jwt>"
      }
    }
  }
}

运行 npx agent-cards login 获取 JWT，然后在 ~/.agent-cards/config.json 中找到它。

stdio（本地）

{
  "mcpServers": {
    "agent-cards": {
      "command": "node",
      "args": ["/path/to/packages/mcp/dist/src/index.js"],
      "env": {
        "AGENT_CARDS_JWT": "<your-jwt>",
        "AGENT_CARDS_API_URL": "https://your-backend.example.com"
      }
    }
  }
}

工具

工具	描述
list_cards	列出所有虚拟卡片，包括余额、到期时间和状态
create_card	创建一张具有固定美元预算的虚拟借记卡
get_card_details	获取解密后的 PAN、CVV、到期时间（可能需要人工审批）
check_balance	快速查看余额，无需暴露凭证
close_card	永久关闭一张虚拟卡片
list_transactions	列出某张卡片的交易记录，可按状态筛选
approve_request	批准或拒绝待处理的人工介入请求
submit_user_info	提交身份信息，以进行卡片发行验证
setup_payment_method	设置用于为卡片充值的支付方式
remove_payment_method	移除已保存的支付方式
pay_checkout	使用 AgentCard 自动检测结账页面并付款
detect_checkout	检测当前浏览器标签页上的结账表单
fill_card	在浏览器的支付表单中填写卡片凭证
start_support_chat	发起客服对话
send_support_message	在客服对话中发送消息
read_support_chat	查看客服对话记录

端点

方法	路径	描述
POST	/mcp	MCP Streamable HTTP 传输
GET	/health	健康检查（{"ok":true}）
GET	/.well-known/mcp/server-card.json	自动发现元数据

环境变量

变量	必需	描述
AGENT_CARDS_API_URL	是	后端 API URL
AGENT_CARDS_JWT	仅 stdio	用户 JWT（HTTP 从 Authorization 请求头中获取）
PORT	否	HTTP 服务端口（默认：3002）

开发

pnpm dev       # stdio mode
pnpm dev:http  # HTTP mode
pnpm build     # compile TypeScript