io.github.codespar/mcp-inter-bank MCP Server

This MCP server provides Model Context Protocol access to Banco Inter’s developer API, covering boleto, PIX, transfers, and banking. The package is identified as @codespar/mcp-inter-bank and is intended to be run via stdio or via HTTP with environment-based configuration.

🛠️ Key Features

MCP server for Banco Inter (Brazilian digital bank)
Developer API coverage for: boletos, PIX, transfers, and banking
Package includes a documented setup for credentials and runtime mode

🚀 Use Cases

Enable AI tools to interact with Banco Inter payment flows (boletos, PIX)
Support integrations that require initiating transfers and accessing banking functionality
Use in MCP-based LLM tools within agentic-commerce scenarios

⚡ Developer Benefits

Uses MCP for standardized tool/context integration
Supports execution via stdio (npx -y @codespar/mcp-inter-bank)
Supports HTTP mode via MCP_HTTP=true (with additional environment configuration mentioned)

⚠️ Limitations

OAuth/client credentials are required (INTER_CLIENT_ID, INTER_CLIENT_SECRET)
Functionality described is limited to the Banco Inter areas listed (boletos, PIX, transfers, banking)

# 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

Variable

Required

Description

INTER_CLIENT_ID

Yes

OAuth2 client ID

INTER_CLIENT_SECRET

Yes

OAuth2 client secret

MCP_HTTP

Set to "true" to enable HTTP transport

MCP_PORT

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

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

Install

Configuration

Environment variables

INTER_CLIENT_IDrequiredsecret

API key/token for inter-bank

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-inter-bank": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-inter-bank@0.2.2"
      ],
      "env": {
        "INTER_CLIENT_ID": "<YOUR_INTER_CLIENT_ID>"
      }
    }
  }
}

io.github.codespar/mcp-inter-bank