mcp-stark-bank

@codespar/mcp-stark-bank

Stark Bank 的 MCP 服务——提供转账、boleto、发票和 Pix 服务的数字银行

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "stark-bank": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stark-bank"],
      "env": {
        "STARK_BANK_ACCESS_TOKEN": "your-token",
        "STARK_BANK_SANDBOX": "true"
      }
    }
  }
}

Claude Code

claude mcp add stark-bank -- npx @codespar/mcp-stark-bank

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "stark-bank": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-stark-bank"],
      "env": {
        "STARK_BANK_ACCESS_TOKEN": "your-token",
        "STARK_BANK_SANDBOX": "true"
      }
    }
  }
}

工具（27）

工具	用途
create_transfer	创建银行转账（Pix 或 TED）
get_transfer	根据 ID 获取转账详情
list_transfers	列出转账，可选筛选条件
create_boleto	创建 boleto 付款
get_balance	获取当前账户余额
create_invoice	创建发票（生成 Pix 二维码）
get_invoice	根据 ID 获取发票详情
list_invoices	列出发票，可选筛选条件
create_pix_request	创建 Pix 付款请求
get_webhook_events	获取 webhook 事件（付款确认、转账等）
create_payment_request	创建付款请求以用于审批工作流
get_payment_request	根据 ID 获取付款请求详情
list_payment_requests	列出付款请求，可选筛选条件
create_brcode_payment	支付 BR Code（Pix 二维码 / 复制粘贴码）
get_deposit	根据 ID 获取存款详情（收到的 Pix 或 TED）
create_boleto_issue	签发应收 boleto（生成用于收款的条形码 / 数字输入码）
get_boleto	根据 ID 获取已签发的 boleto
list_boletos	列出已签发的 boleto，可选筛选条件
delete_boleto	取消已签发的 boleto（仅在未付款且处于 'created' 或 'registered' 状态时允许）
create_pix_key	注册 Pix 密钥（CPF/CNPJ、邮箱、电话或 EVP/随机密钥）
get_pix_key	根据 ID 获取 Pix 密钥详情
list_pix_keys	列出已注册的 Pix 密钥，可选筛选条件
delete_pix_key	取消 / 注销 Pix 密钥
list_deposits	列出存款（收到的 Pix 或 TED），可选筛选条件
create_utility_payment	支付公共事业账单（例如
create_tax_payment	通过条形码 / 数字输入码缴纳税款（DARF、GPS、GRU 等）
list_workspaces	列出组织有权访问的工作区（多租户子账户）

身份验证

Stark Bank 使用 Bearer 令牌进行 API 身份验证。

沙盒 / 测试

Stark Bank 在 sandbox.api.starkbank.com 提供沙盒。设置 STARK_BANK_SANDBOX=true 即可使用。

获取凭据

1. 访问 Stark Bank
2. 创建账户
3. 从控制面板生成 API 访问令牌
4. 设置环境变量

环境变量

变量	必填	说明
STARK_BANK_ACCESS_TOKEN	是	API 访问令牌
STARK_BANK_SANDBOX	否	设置为 "true" 以使用沙盒模式

路线图

v0.2（计划中）

• create_payment_request — 创建付款请求
• get_payment_request — 获取付款请求详情
• list_payment_requests — 列出付款请求，可选筛选条件
• create_brcode_payment — 创建 BR Code（Pix）付款
• get_deposit — 获取存款详情

v0.3（计划中）

• create_workspace — 创建新工作区
• tax_payment — 创建税款缴纳（DAS、DARF 等）
• utility_payment — 创建公共事业付款（boleto、账单）

想要贡献？提交 PR 或申请工具。

链接

• Stark Bank 网站
• Stark Bank API 文档
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款提供治理、预算限制和审计记录？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

许可证

MIT