About mcp-stark-bank
mcp-stark-bank is an MCP server for Stark Bank, a digital bank, providing transfers, boletos, invoices, Pix and balance queries. It is aimed at developers and finance teams working with Brazilian banking operations, and it supports a sandbox mode for testing.
Key features
- 01Create and query Pix and TED transfers
- 02Issue and manage boleto receivables
- 03Generate invoices with Pix QR codes
- 04Manage Pix keys and incoming deposits
- 05Pay BR Codes, taxes and utility bills
- 06List workspaces for multi-tenant subaccounts
Use cases
- 01Test AI-assisted payment flows in the sandbox environment
- 02Issue boletos and track their payment status
- 03Check account balance and incoming deposits
MCP support
This project is an MCP server that exposes 27 tools to MCP clients for transfers, receivables, Pix and account operations through the Stark Bank API.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-stark-bankSTARK_BANK_ACCESS_TOKENSecretAPI key for stark-bankLocal servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
27Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | Recipient name |
| tags | array | No | Tags for organization |
| taxId | string | Yes | Recipient CPF or CNPJ |
| amount | number | Yes | Amount in cents (e.g. 1000 = R$10.00) |
| bankCode | string | Yes | Bank code (e.g. '20018183' for Stark Bank) |
| branchCode | string | Yes | Branch code |
| accountType | enum | No | Account typechecking | savings | salary | payment |
| accountNumber | string | Yes | Account number with digit |
Details
From the project README@codespar/mcp-stark-bank
MCP server for Stark Bank — digital banking with transfers, boletos, invoices, and Pix
Quick Start
Claude Desktop
Add to ~/.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
Add to .cursor/mcp.json or .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"
}
}
}
}
Tools (27)
| Tool | Purpose |
|---|---|
create_transfer | Create a bank transfer (Pix or TED) |
get_transfer | Get transfer details by ID |
list_transfers | List transfers with optional filters |
create_boleto | Create a boleto payment |
get_balance | Get current account balance |
create_invoice | Create an invoice (generates Pix QR code) |
get_invoice | Get invoice details by ID |
list_invoices | List invoices with optional filters |
create_pix_request | Create a Pix payment request |
get_webhook_events | Get webhook events (payment confirmations, transfers, etc.) |
create_payment_request | Create a payment request for approval workflow |
get_payment_request | Get payment request details by ID |
list_payment_requests | List payment requests with optional filters |
create_brcode_payment | Pay a BR Code (Pix QR code / copia-e-cola) |
get_deposit | Get deposit details by ID (incoming Pix or TED) |
create_boleto_issue | Issue a boleto receivable (generates barcode/digitable line to collect payment) |
get_boleto | Get an issued boleto by ID |
list_boletos | List issued boletos with optional filters |
delete_boleto | Cancel an issued boleto (only allowed while unpaid / in 'created' or 'registered' state) |
create_pix_key | Register a Pix key (CPF/CNPJ, email, phone, or EVP/random) |
get_pix_key | Get Pix key details by ID |
list_pix_keys | List registered Pix keys with optional filters |
delete_pix_key | Cancel / deregister a Pix key |
list_deposits | List deposits (incoming Pix or TED) with optional filters |
create_utility_payment | Pay a utility bill (e.g. |
create_tax_payment | Pay a tax (DARF, GPS, GRU, etc.) by barcode / digitable line |
list_workspaces | List workspaces the organization has access to (multi-tenant subaccounts) |
Authentication
Stark Bank uses a Bearer token for API authentication.
Sandbox / Testing
Stark Bank provides a sandbox at sandbox.api.starkbank.com. Set STARK_BANK_SANDBOX=true to use it.
Get your credentials
- Go to Stark Bank
- Create an account
- Generate an API access token from the dashboard
- Set the environment variables
Environment Variables
| Variable | Required | Description |
|---|---|---|
STARK_BANK_ACCESS_TOKEN | Yes | API access token |
STARK_BANK_SANDBOX | No | Set to "true" for sandbox mode |
Roadmap
v0.2 (planned)
create_payment_request— Create a payment requestget_payment_request— Get payment request detailslist_payment_requests— List payment requests with filterscreate_brcode_payment— Create a BR Code (Pix) paymentget_deposit— Get deposit details
v0.3 (planned)
create_workspace— Create a new workspacetax_payment— Create a tax payment (DAS, DARF, etc.)utility_payment— Create a utility payment (boleto, bills)
Want to contribute? Open a PR or request a tool.
Links
Enterprise
Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.