Mcp Dock

io.github.codespar由 GitHub 账号 codespar 发布v0.2.0-alpha.4更新于 Oct 24, 2026

DEPRECATED: no live endpoint (api.dock.tech does not resolve)

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

已弃用的 Dock(巴西银行即服务)MCP 服务器,提供账户、Pix 支付与发卡工具,但目前没有可用端点。

可以做什么
  • 创建、列出、冻结与解冻终端用户的数字账户
  • 发起、查询与退款 Pix 支付,生成静态与动态 Pix 二维码,解析 DICT 密钥
  • 发行借记、信用、预付或虚拟卡,查询卡片,并封卡、解封或变更卡片状态
  • 列出并查询账户交易记录
  • 注册与列出接收账户、Pix、卡片和交易事件的 webhook 端点
适用场景
仅适合参考或试验:该包已弃用,生产与沙箱域名均无法解析,没有任何工具能连到真实服务。目前不适合真实金融业务;若你自有可用的 Dock 端点,或想研究其工具接口,才值得一看。
运行要求
通过 npx 从 npm 包 @codespar/mcp-dock 在本地运行,需要 Node.js。需要 Dock 发放的 DOCK_CLIENT_ID 与 DOCK_CLIENT_SECRET,可选 DOCK_ENV(默认 sandbox)。还需要可访问的 Dock 基础地址,README 称可通过 DOCK_BASE_URL 提供。
安装前请注意
已弃用且无可用端点,多数调用会失败。它涉及资金与发卡:发起 Pix、退款、冻结账户和变更卡片状态都是真实且难以撤销的金融操作。需要 OAuth 客户端密钥 DOCK_CLIENT_SECRET,且 DOCK_ENV 可指向生产环境。接口路径为未经验证的推测,Dock 公开文档需登录才能查看。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Dock,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@codespar/mcp-dock

Deprecated: no live endpoint. Measured on 2026-09-27 against two public DNS resolvers (8.8.8.8 and 1.1.1.1): api.dock.tech (production) and sandbox.api.dock.tech (sandbox) do not resolve in DNS. No tool in this server reaches a service. The package is deprecated on npm and stays in this repository for reference only. If you have a working endpoint, point the server at it with DOCK_BASE_URL. To bring the package back, open an issue in mcp-dev-latam with the provider's documented base URL.

MCP server for Dock — Brazilian Banking-as-a-Service (accounts, Pix, card issuing) for fintechs and embedded-finance products

[npm] [License: MIT]

Why Dock

Dock is one of the two dominant BaaS providers in Brazil. Together with Matera, they power most BR fintechs.

Matera vs Dock — pick one, same commerce patterns:

MateraDock
Core strengthPix-focused core bankingBroader BaaS: accounts + Pix + card issuing
Historical rootCore-banking platformCard-issuing platform that expanded into accounts + Pix
Typical customerFintech building on top of PixFintech / retailer issuing branded cards + accounts
Pix AutomáticoLive (2025 BCB product)Roadmap

BR fintechs usually pick one based on contract terms and pricing. Agents building fintech products can target both — the commerce patterns are identical; only the vendor relationship changes. This server exposes Dock's surface in the same shape as @codespar/mcp-matera so an agent can swap backends without rewriting tool-call logic.

Use Dock when an agent needs to:

  • Spin up digital accounts for end users (CPF holders)
  • Move money via Pix (charges, transfers, DICT, refunds)
  • Issue cards (debit / credit / prepaid / virtual) against those accounts — Dock's key differentiator

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "dock": {      "command": "npx",      "args": ["-y", "@codespar/mcp-dock"],      "env": {        "DOCK_CLIENT_ID": "your-client-id",        "DOCK_CLIENT_SECRET": "your-client-secret",        "DOCK_ENV": "sandbox"      }    }  }}

Claude Code

bash
claude mcp add dock -- npx @codespar/mcp-dock

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "dock": {      "command": "npx",      "args": ["-y", "@codespar/mcp-dock"],      "env": {        "DOCK_CLIENT_ID": "your-client-id",        "DOCK_CLIENT_SECRET": "your-client-secret",        "DOCK_ENV": "sandbox"      }    }  }}

Tools (20)

ToolPurpose
create_accountCreate a digital account for an end user (CPF holder) on Dock.
get_accountRetrieve a Dock account by id.
send_pixInitiate an outbound Pix transfer from a Dock account to any Pix key in BR.
get_pixRetrieve an outbound Pix payment by endToEndId.
create_pix_qr_staticCreate a static Pix QR (reusable, tied to a merchant Pix key).
create_pix_qr_dynamicCreate a dynamic Pix QR (single-use, expiring).
refund_pixRefund (devolução) a Pix payment.
resolve_dict_keyResolve a Pix DICT key to the account holder's identity and ISPB/branch/account.
issue_cardIssue a card (debit / credit / prepaid / virtual) against a Dock account.
get_cardRetrieve a card by id.
list_accountsList Dock accounts under the merchant.
freeze_accountFreeze (block) a Dock account.
unfreeze_accountUnfreeze a previously frozen Dock account, restoring Pix and card operations.
block_cardBlock a card temporarily (reversible).
unblock_cardUnblock a card that was previously blocked (reversible).
change_card_statusChange a card's lifecycle status: ACTIVE / BLOCKED / CANCELED.
list_transactionsList transactions on a Dock account (Pix in/out, card auths, fees, transfers).
get_transactionRetrieve a single transaction by id.
create_webhookRegister a webhook endpoint to receive Dock event notifications (account., pix., card., transaction.).
list_webhooksList all webhook endpoints registered for the merchant.

Authentication

OAuth 2.0 Client Credentials. The server calls POST /oauth/token with Basic auth (client_id:client_secret) and caches the bearer token in memory until a minute before expiry.

Environment Variables

VariableRequiredDescription
DOCK_CLIENT_IDYesOAuth2 client_id issued by Dock
DOCK_CLIENT_SECRETYesOAuth2 client_secret (secret)
DOCK_ENVNosandbox (default) or production

Base URL is derived from DOCK_ENV: https://sandbox.api.dock.tech (sandbox) or https://api.dock.tech (production).

Status

v0.1.0-alpha.1 — tool surface is stable, wire paths are NOT yet verified.

Dock's developer portal at developers.dock.tech redirects to a ReadMe.com login gate. Public docs are not accessible without a Dock merchant contract, so on 2026-04-21 we could not validate the exact URL paths.

The endpoint paths in src/index.ts follow standard BR BaaS conventions (matching Matera's shape and the BCB Pix spec) and are best-guesses. Known-suspect items are flagged inline with TODO(verify) comments:

AreaValue in codeWhy it's suspect
Token endpointPOST /oauth/tokenStandard candidate, but /oauth2/token or /auth/v1/token also common
Pix refundPOST /pix/payments/{e2eid}/refundBCB spec names refunds /pix/{e2eid}/devolucao/{id}
DICT lookupGET /pix/dict/{key}BCB DICT is RSFN-gated; Dock's wrapper path unverified

The 10 tool names and input schemas above are the public contract and will remain stable. Only the internal HTTP calls in src/index.ts will change when we verify against the sandbox. Using this server against a live Dock tenant today may produce 404s on most calls.

PR welcome from anyone with a Dock sandbox.

Roadmap

v0.2 (planned)

  • Verified paths against Dock sandbox
  • Card controls: block_card, unblock_card, set_card_limits
  • Account statements and transaction listings
  • Webhook event helpers

v0.3 (planned)

  • Boleto issuance
  • TED / bank transfers (non-Pix rails)
  • Credit underwriting endpoints (Dock's credit stack)

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent-initiated bank transfers and card issuance? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

来源:packages/banking/dock/README.md,提交 d0a519a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

2
  1. v0.2.0-alpha.4最新Sep 27, 2026
  2. v0.2.0-alpha.3Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分