About mcp-inter-bank
@codespar/mcp-inter-bank is an MCP server for Banco Inter, a Brazilian digital bank. It is aimed at applications that handle boletos, Pix, transfers and account reconciliation through the bank's API. Access uses the OAuth2 client credentials flow with scoped permissions per API.
Key features
- 01Create, read, list and cancel boletos
- 02Pix immediate and due charges with returns
- 03Balance, statement and PDF statement retrieval
- 04TED and internal transfer creation
- 05Webhook registration for boleto and Pix events
Use cases
- 01Generating boleto and Pix payment charges for customers
- 02Checking account balance and exporting statements
- 03Receiving Pix and boleto status notifications through webhooks
MCP support
The project runs as an MCP server that exposes 22 banking tools to MCP clients, covering charges, transfers, statements and webhooks.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @codespar/mcp-inter-bankINTER_CLIENT_IDSecretAPI key/token for inter-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
22Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | number | Yes | Boleto amount in BRL |
| due_date | string | Yes | Due date (YYYY-MM-DD) |
| payer_zip | string | No | Payer ZIP code (CEP) |
| payer_city | string | No | Payer city |
| payer_name | string | Yes | Payer full name |
| description | string | No | Boleto description |
| payer_state | string | No | Payer state (UF) |
| payer_address | string | No | Payer street address |
| payer_cpf_cnpj | string | Yes | Payer CPF or CNPJ |
Details
From the project README@codespar/mcp-inter-bank
MCP server for Banco Inter, a Brazilian digital bank with a full developer API for boletos, PIX, transfers, and banking
Quick Start
# Set your credentials
export INTER_CLIENT_ID="your-client-id"
export INTER_CLIENT_SECRET="your-client-secret"
# Run via stdio
npx -y @codespar/mcp-inter-bank
# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-inter-bank
Environment Variables
| Variable | Required | Description |
|---|---|---|
INTER_CLIENT_ID | Yes | OAuth2 client ID |
INTER_CLIENT_SECRET | Yes | OAuth2 client secret |
MCP_HTTP | No | Set to "true" to enable HTTP transport |
MCP_PORT | No | HTTP port (default: 3000) |
Tools (22)
| Tool | Purpose |
|---|---|
create_boleto | Create a boleto bancario (bank slip) |
get_boleto | Get boleto details by ID |
list_boletos | List boletos with filters |
cancel_boleto | Cancel (write-off) a boleto |
get_boleto_pdf | Download boleto PDF (returns base64 payload) |
create_pix | Create a PIX payment |
get_pix | Get PIX transaction details by ID |
list_pix | List PIX transactions |
create_pix_cob | Create PIX immediate charge (cob) with txid — returns BR Code/copia-e-cola |
get_pix_cob | Retrieve PIX immediate charge by txid |
list_pix_cob | List PIX immediate charges within a time range (with optional end_to_end_id filters) |
create_pix_cobv | Create PIX due charge (cobv) with dueDate — boleto-like PIX with expiration date |
get_pix_cobv | Retrieve PIX due charge (cobv) by txid |
create_pix_devolucao | Create PIX return (devolução) for a received transaction |
list_pix_keys | List PIX keys (chaves) registered to the Inter account |
get_balance | Get account balance |
get_statement | Get account statement for a date range |
get_statement_enriched | Get enriched statement with detailed transaction info (counterparty, category, Pix details) |
get_statement_pdf | Download account statement as PDF (base64 payload) for a date range |
create_transfer | Create a TED or internal transfer |
get_webhook | Get configured webhooks |
create_webhook | Register a webhook for notifications |
Auth
Uses OAuth2 client credentials flow. The token endpoint is /oauth/v2/token with scoped permissions per API:
- Boletos:
boleto-cobranca.read,boleto-cobranca.write - PIX:
pix.read,pix.write - Banking:
extrato.read,pagamento-ted.write - Webhooks:
webhook-boleto.read,webhook-boleto.write,webhook-pix.read,webhook-pix.write
Register your application at the Banco Inter Developer Portal.
API Reference
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.
Authentication
Set these environment variables before launching the server:
INTER_CLIENT_ID(required, secret) — API key/token for inter-bank
Issue credentials at the provider's developer portal: https://developers.inter.co.
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.