mcp-dock — Claude Code MCP server: what it does, how to install
Connects AI agents to the Brazilian Dock BaaS platform for accounts, Pix, and card issuing. The package is currently deprecated because Dock endpoints no longer resolve.
claude mcp add --env DOCK_CLIENT_ID=<DOCK_CLIENT_ID> --env DOCK_CLIENT_SECRET=<DOCK_CLIENT_SECRET> --env DOCK_ENV=<DOCK_ENV> --transport stdio dock -- npx -y @codespar/mcp-dockWhat mcp-dock does
This server defines 20 tools for interacting with Dock banking APIs. Agents can open digital accounts for Brazilian CPF holders, initiate Pix transfers, generate static or dynamic QR codes, and register event webhooks. It also covers card lifecycle management, including issuance, status changes, and temporary card freezing.
Authorization relies on OAuth 2.0 client credentials using DOCK_CLIENT_ID and DOCK_CLIENT_SECRET. Tokens are cached in memory prior to expiration. Environment settings switch between sandbox and production URLs.
Calls will fail unless you specify DOCK_BASE_URL. Official hostnames api.dock.tech and sandbox.api.dock.tech stop resolving in public DNS, leaving the tool surface without an active backend.
What it helps with
- open digital banking accounts for CPF holders in Brazil
- dispatch Pix payments and build QR codes for incoming transfers
- issue and block physical or virtual payment cards
- freeze accounts to halt operations during security incidents
- register webhook subscriptions for financial events
Example prompts for the agent
- Open a digital Dock account for this CPF holder
- Generate a dynamic Pix QR code for a single order
- Issue a virtual card linked to this account ID
How to install mcp-dock
Platform CLI
claude mcp add --env DOCK_CLIENT_ID=<DOCK_CLIENT_ID> --env DOCK_CLIENT_SECRET=<DOCK_CLIENT_SECRET> --env DOCK_ENV=<DOCK_ENV> --transport stdio dock -- npx -y @codespar/mcp-dockReplace <…> with your own values
Platform CLI
codex mcp add dock --env DOCK_CLIENT_ID=<DOCK_CLIENT_ID> --env DOCK_CLIENT_SECRET=<DOCK_CLIENT_SECRET> --env DOCK_ENV=<DOCK_ENV> -- npx -y @codespar/mcp-dockReplace <…> with your own values
Config file
{
"mcpServers": {
"dock": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-dock"
],
"env": {
"DOCK_CLIENT_ID": "<DOCK_CLIENT_ID>",
"DOCK_CLIENT_SECRET": "<DOCK_CLIENT_SECRET>",
"DOCK_ENV": "<DOCK_ENV>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"dock": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-dock"
],
"env": {
"DOCK_CLIENT_ID": "<DOCK_CLIENT_ID>",
"DOCK_CLIENT_SECRET": "<DOCK_CLIENT_SECRET>",
"DOCK_ENV": "<DOCK_ENV>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DOCK_CLIENT_ID=<DOCK_CLIENT_ID> -e DOCK_CLIENT_SECRET=<DOCK_CLIENT_SECRET> -e DOCK_ENV=<DOCK_ENV> dock npx -y @codespar/mcp-dockReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-dock
What does mcp-dock do?
It gives agents tools to run Brazilian Banking-as-a-Service operations via Dock, covering account creation, Pix transfers, and card issuing.
How to install mcp-dock in Claude Code?
Run claude mcp add mcp-dock -e DOCK_CLIENT_ID=<DOCK_CLIENT_ID> -e DOCK_CLIENT_SECRET=<DOCK_CLIENT_SECRET> -- npx -y @codespar/mcp-dock.
Why is this MCP server deprecated?
Standard hostnames api.dock.tech and sandbox.api.dock.tech no longer resolve in DNS. You need a working host provided via DOCK_BASE_URL to route requests.
