Overview
What is MCP Banco Inter?
MCP Banco Inter is an MCP (Model Context Protocol) server that integrates with the Banco Inter API for business accounts (PJ). It enables AI assistants to query balances, view statements, and issue and manage billing tickets (boletos) using natural language.
How to use MCP Banco Inter?
The server can be run via npx, Docker, or local installation. Configuration requires environment variables for client credentials, certificate paths, and account number. It supports two transports: stdio for local clients and streamable-http (SSE) for remote or Docker setups.
Key features of MCP Banco Inter
- Balance inquiry for current account
- Statement consultation and PDF download
- Issue, list, cancel, and summarize billing tickets (boletos)
- PDF download for statements and boletos
- mTLS secured communication with OAuth2 token management
- Supports stdio and HTTP/SSE transport modes
Use cases of MCP Banco Inter
- Ask an AI assistant for the current account balance
- Generate and save a monthly statement PDF via natural language
- Issue a new boleto for a client with custom parameters
- Cancel an existing boleto by providing the solicitation code
- List recent boletos filtered by status and date range
FAQ from MCP Banco Inter
What credentials are required?
You need a CLIENT_ID, CLIENT_SECRET, a digital certificate (.crt), its private key (.key), and the current account number. These are obtained from the Banco Inter Developer Portal.
What transport modes are supported?
The server supports stdio for local MCP clients (e.g., Claude Desktop, Cursor) and streamable-http (SSE) for remote clients or Docker deployments.
Is there a sandbox environment for testing?
Yes. Set the environment variable INTER_IS_SANDBOX=true to use the Banco Inter sandbox environment for development and testing.
How are OAuth2 tokens managed?
Tokens are stored only in memory and are automatically renewed. No token data is persisted to disk.
What are the runtime requirements?
Node.js 18+ or Docker. The server also requires the certificate and key files accessible at the paths specified by CERT_PATH and KEY_PATH.
