虚拟借记卡管理工具

AgentCard是一款为AI代理提供虚拟借记卡创建、支付和管理的工具,支持固定预算、真实卡凭证和MCP集成,适用于自动化支付场景。

  • by tiny-agent-company
  • TypeScript
  • 混合部署
  • 1 星标
  • 更新于
在 GitHub 查看 agent-cards/mcp

使用说明

@代理卡/mcp

给你的人工智能代理一张借记卡。AgentCard允许AI代理创建和使用虚拟借记卡——每张卡都有固定的预算、真实的卡凭证和完整的MCP集成。你的代理人可以创建一张卡,支付东西,检查余额,并自动填写结账表格——而不需要你的个人卡。

快速设置

连接代理的最快方法是通过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>"
      }
    }
  }
}

获取您的JWT npx agent-cards login,然后在中找到它 ~/.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 使用代理卡自动检测并支付结账页面
detect_checkout 检测当前浏览器选项卡上的签出表单
fill_card 在浏览器中的付款表单中填写卡凭据
start_support_chat 开始支持对话
send_support_message 在支持帖子中发送消息
read_support_chat 阅读支持对话历史记录

端点

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

环境变量

变量 必填 描述
AGENT_CARDS_API_URL yes 后端API URL
AGENT_CARDS_JWT 仅限stdio 用户JWT(HTTP从 Authorization 头球
PORT no HTTP服务器端口(默认值: 3002)

发展

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