Mcp Dock

io.github.codesparPublished by GitHub account codesparv0.2.0-alpha.4Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Deprecated MCP server for Dock, a Brazilian banking-as-a-service API, exposing tools for accounts, Pix payments and card issuing, though no live endpoint…

What you can do
  • Create, list, freeze and unfreeze digital accounts for end users
  • Send, retrieve and refund Pix payments, create static and dynamic Pix QR codes, resolve DICT keys
  • Issue cards, retrieve them, block, unblock and change card status
  • List and retrieve account transactions
  • Register and list webhook endpoints for account, Pix, card and transaction events
When to use it
Only for reference or experimentation: the package is deprecated, its production and sandbox hosts do not resolve in DNS, and no tool reaches a live service. It is not suitable for real fintech work today; it may be useful if you have your own working Dock endpoint or want to study the tool surface.
Requirements
Runs locally via npx from the npm package @codespar/mcp-dock, so Node.js is needed. Requires DOCK_CLIENT_ID and DOCK_CLIENT_SECRET from Dock, plus optional DOCK_ENV (sandbox by default). A reachable Dock base URL is needed, which the README says can be supplied via DOCK_BASE_URL.
Before you install
Deprecated with no live endpoint, so most calls would fail. It handles money movement and card issuing: sending Pix, refunds, freezing accounts and changing card status are real, irreversible financial actions. It needs the OAuth client secret DOCK_CLIENT_SECRET, and DOCK_ENV can point it at production. Endpoint paths are unverified guesses, and public Dock documentation is gated.

Installation

In SourceWeft

  1. Open Mcp Dock in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/banking/dock/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

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

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts