Mcp Inter Bank

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

Banco Inter — digital bank, boleto, PIX, statements, transfers

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an assistant operate a Banco Inter account: create and manage boletos, PIX charges and transfers, and read balances and statements.

What you can do
Wraps the Banco Inter developer API in 22 tools covering boleto issuance, lookup, listing, cancellation and PDF retrieval, plus PIX immediate charges (cob), due charges (cobv), returns, keys and transaction lookup. It also reads account balance and statements, including an enriched statement with counterparty and PIX details, and can create TED or internal transfers and register webhooks for notifications.
When to use it
Use it when an assistant needs to work with a Brazilian Banco Inter business account: issuing or reconciling boletos, generating PIX charges and BR Codes, checking balances and statements, or initiating transfers. It is aimed at developers and finance teams automating Inter banking workflows rather than general banking questions.
Requirements
Runs locally as an npm package via npx, or over HTTP when MCP_HTTP is set with MCP_PORT. Requires OAuth2 client credentials from the Banco Inter developer portal, supplied as INTER_CLIENT_ID and INTER_CLIENT_SECRET, with scopes for the APIs used. Network access to Banco Inter is needed.
Before you install
Credentials INTER_CLIENT_ID and INTER_CLIENT_SECRET are secrets and grant access to a real bank account. Several tools write or move money: create_boleto, cancel_boleto, create_pix, create_pix_cob, create_pix_cobv, create_pix_devolucao, create_transfer and create_webhook. Transfers and PIX payments can spend funds irreversibly, and statement and PDF tools return sensitive financial data. Grant only the scopes needed.

Installation

In SourceWeft

  1. Open Mcp Inter Bank in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

[npm] [License: MIT]

Quick Start

bash
# Set your credentialsexport INTER_CLIENT_ID="your-client-id"export INTER_CLIENT_SECRET="your-client-secret"
# Run via stdionpx -y @codespar/mcp-inter-bank
# Run via HTTPMCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-inter-bank

Environment Variables

VariableRequiredDescription
INTER_CLIENT_IDYesOAuth2 client ID
INTER_CLIENT_SECRETYesOAuth2 client secret
MCP_HTTPNoSet to "true" to enable HTTP transport
MCP_PORTNoHTTP port (default: 3000)

Tools (22)

ToolPurpose
create_boletoCreate a boleto bancario (bank slip)
get_boletoGet boleto details by ID
list_boletosList boletos with filters
cancel_boletoCancel (write-off) a boleto
get_boleto_pdfDownload boleto PDF (returns base64 payload)
create_pixCreate a PIX payment
get_pixGet PIX transaction details by ID
list_pixList PIX transactions
create_pix_cobCreate PIX immediate charge (cob) with txid — returns BR Code/copia-e-cola
get_pix_cobRetrieve PIX immediate charge by txid
list_pix_cobList PIX immediate charges within a time range (with optional end_to_end_id filters)
create_pix_cobvCreate PIX due charge (cobv) with dueDate — boleto-like PIX with expiration date
get_pix_cobvRetrieve PIX due charge (cobv) by txid
create_pix_devolucaoCreate PIX return (devolução) for a received transaction
list_pix_keysList PIX keys (chaves) registered to the Inter account
get_balanceGet account balance
get_statementGet account statement for a date range
get_statement_enrichedGet enriched statement with detailed transaction info (counterparty, category, Pix details)
get_statement_pdfDownload account statement as PDF (base64 payload) for a date range
create_transferCreate a TED or internal transfer
get_webhookGet configured webhooks
create_webhookRegister 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

Source: packages/payments/inter-bank/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts