MCP Banco Inter

You can run an MCP server that connects to the Banco Inter API to query balances, fetch statements, and generate or manage billing boletos through natural language. This server exposes both a local stdin/stdout interface for direct clients and a HTTP transport for remote clients, enabling convenient integration with your preferred MCP client workflows.

How to use

You can interact with the MCP Banco Inter server in two main ways. For local development or desktop clients, run the server in stdio mode and communicate through standard input and output. For remote clients or containerized deployments, run the server in streamable HTTP mode and connect to the provided HTTP endpoint.

How to install

Prerequisites you need before installing:

• Node.js 18 or newer OR Docker installed on your machine.

• Banco Inter API credentials obtained from the Banco Inter Developer Portal, including Client ID, Client Secret, and API certificates (certificate and private key). Also note your current account number.

Explicit MCP connection options

You have two explicit ways to run the MCP Banco Inter server right away.

1. Via npx in stdio mode (recommended for local clients) — this starts the MCP client and communicates through stdin/stdout.

2. Via npx in streamable-http mode (server accessible over HTTP) — run as a HTTP server to serve multiple clients.

Via npx in stdio mode (recommended for local clients)

CLIENT_ID=your_client_id \
CLIENT_SECRET=your_client_secret \
CERT_PATH=/absolute/path/inter.crt \
KEY_PATH=/absolute/path/inter.key \
X_CONTA_CORRENTE=your_account_number \
INTER_IS_SANDBOX=true \
npx -y samuelmoraesf/mcp-banco-inter

Via npx in streamable-http mode (HTTP server)

To run as an HTTP server that remote clients can connect to, set the same credentials and account information, but enable the streamable HTTP transport.

CLIENT_ID=your_client_id \
CLIENT_SECRET=your_client_secret \
CERT_PATH=/absolute/path/inter.crt \
KEY_PATH=/absolute/path/inter.key \
X_CONTA_CORRENTE=your_account_number \
INTER_IS_SANDBOX=true \
MCP_TRANSPORT=streamable-http \
MCP_HOST=0.0.0.0 \
MCP_PORT=3000 \
npx -y samuelmoraesf/mcp-banco-inter

Via Docker — streamable-http mode

Run the container in streamable HTTP mode using Docker. You can provide credentials through environment variables and mount certificates as needed.

docker run -d \
  --name mcp-banco-inter \
  -p 3000:3000 \
  -e CLIENT_ID=your_client_id \
  -e CLIENT_SECRET=your_client_secret \
  -e X_CONTA_CORRENTE=your_account_number \
  -e INTER_IS_SANDBOX=true \
  -v /absolute/path/certs:/app/certs \
  -e CERT_PATH=/app/certs/inter.crt \
  -e KEY_PATH=/app/certs/inter.key \
  samuelmoraesf/mcp-banco-inter

Local development installation

If you prefer building from source and running locally in development mode, follow these steps.

git clone https://github.com/samuelmoraesf/mcp-banco-inter.git
cd mcp-banco-inter
npm install
npm run build
npm start

Available tools

consultar_saldo

Returns the available balance for the current account.

consultar_extrato

Retrieves transactions within a specified date range.

baixar_pdf_extrato

Generates and saves the account statement PDF.

listar_boletos

Lists issued boletos with optional filters by date range and status.

emitir_boleto

Creates a new boleto for collection.

baixar_pdf_boleto

Generates and saves the PDF for a boleto.

cancelar_boleto

Cancels an existing boleto.

sumario_boletos

Provides a quantitative summary of boletos within a period.