Dock

v0.2.0-alpha.1OAuth2alpha

BR BaaS — Matera's main competitor, powers much of the Brazilian fintech stack. Differentiator vs Matera: card issuing on top of Pix + accounts. Alpha on npm — developers.dock.tech is ReadMe-gated, paths follow standard BR BaaS conventions.

20 tools3 env vars🇧🇷 Brazilalpha — pending validation

Install

terminal

$ npm install @codespar/mcp-dock@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "dock": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-dock@alpha"
      ],
      "env": {
        "DOCK_CLIENT_ID": "<your_dock_client_id>",
        "DOCK_CLIENT_SECRET": "<your_dock_client_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 20 tools below — try create_account first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

DOCK_CLIENT_ID

required

OAuth2 client_id issued by Dock

DOCK_CLIENT_SECRET

requiredsecret

OAuth2 client_secret issued by Dock

DOCK_ENV

optional

Environment: sandbox or production. Defaults to sandbox.

Available tools · 20

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_account

Create a digital account for an end user (CPF holder) on Dock. Returns the account id, agency, and account number. Account holds funds that can be moved via Pix or spent via issued cards.

READget_account

Retrieve a Dock account by id. Returns balance, status, holder info, and account coordinates (agency / account number).

WRITEsend_pix

Initiate an outbound Pix transfer from a Dock account to any Pix key in BR. Returns endToEndId once the BCB SPI confirms.

READget_pix

Retrieve an outbound Pix payment by endToEndId.

WRITEcreate_pix_qr_static

Create a static Pix QR (reusable, tied to a merchant Pix key). Returns EMV copy-paste payload and QR image. Use for points-of-sale or donations where the same QR is shown to many payers.

WRITEcreate_pix_qr_dynamic

Create a dynamic Pix QR (single-use, expiring). Returns txid, EMV payload, and QR image. Preferred for e-commerce checkouts and invoices.

DELETErefund_pix

Refund (devolução) a Pix payment. Supports full or partial amount. Use BCB MED reason codes when applicable.

READresolve_dict_key

Resolve a Pix DICT key to the account holder's identity and ISPB/branch/account. Use before sending large transfers to verify the counterparty. DICT queries are rate-limited and logged by BCB.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.