@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"
}
}
}
}
| 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