Mcp Iniciador

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

MCP server for Iniciador — Open Finance Brasil Pix payment initiation (PISP), ICP-Brasil + DCR

VerifiedSTDIODesktop onlyFinanceDeveloper ToolsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant initiate Open Finance Brasil Pix payments through Iniciador, managing consents, payments, and bank lists.

What you can do
Exposes nine tools for Iniciador's Pix payment initiation (PISP) service: list_institutions to see supported Brazilian banks, create_consent, get_consent and revoke_consent to manage payer authorization, create_payment, get_payment, list_payments and cancel_payment for Pix-out flows, and get_authorization_url to build the Open Finance Brasil authorization URL. Iniciador holds the ICP-Brasil certificate and handles DCR with each bank.
When to use it
Use it when an assistant needs to create and track outgoing Pix payments under Open Finance Brasil consent, for example in commerce or payment automation workflows. It is a write-capable payment server, so it suits cases where the assistant must actually initiate or cancel payments, not just read account data.
Requirements
Runs locally as an npm package via npx (Node.js required), stdio transport, desktop only. Needs an Iniciador account and credentials from onboarding: INICIADOR_API_KEY, plus INICIADOR_CLIENT_ID and INICIADOR_CLIENT_SECRET for OAuth2 flows. INICIADOR_API_BASE optionally overrides the API base URL, for example to the sandbox endpoint. Network access to Iniciador is required.
Before you install
This server can move money: create_payment initiates Pix transfers and cancel_payment attempts cancellation, while create_consent and revoke_consent change payer authorization state. It requires secrets INICIADOR_API_KEY, INICIADOR_CLIENT_ID and INICIADOR_CLIENT_SECRET, which should be stored carefully. Payment signing relies on bank-issued consent tokens handled by Iniciador's backend, so payment data is sent to that third party. Test against the sandbox before production use.

Installation

In SourceWeft

  1. Open Mcp Iniciador 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-iniciador

MCP server for Iniciador — Open Finance Brasil PISP (Pix payment initiation aggregator). Iniciador holds the ICP-Brasil certificate and orchestrates DCR with each Brazilian bank for instant Pix-out flows.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

json
{  "mcpServers": {    "iniciador": {      "command": "npx",      "args": ["@codespar/mcp-iniciador"],      "env": {        "INICIADOR_API_KEY": "your-api-key"      }    }  }}

Cursor / VS Code

Same config in .cursor/mcp.json.

Tools (9)

Institutions

ToolIniciador endpointNotes
list_institutionsGET /institutionsBrazilian banks supported for Pix initiation

Consents

ToolIniciador endpointNotes
create_consentPOST /consentsPayment consent for the payer to authorize at their bank
get_consentGET /consents/{id}Current authorization status
revoke_consentDELETE /consents/{id}Revoke before exercise

Payments

ToolIniciador endpointNotes
create_paymentPOST /paymentsInitiate Pix once consent is authorized
get_paymentGET /payments/{id}Status / E2E id / rejection reason
list_paymentsGET /paymentsFilter by date range / status
cancel_paymentPOST /payments/{id}/cancelBest-effort cancel before settlement

Helpers

ToolNotes
get_authorization_urlClient-side builder for the OFB authorization URL (consent id + ISPB + redirect)

Authentication

This server uses Iniciador's API key auth (X-API-KEY header). The Pix-out call itself is signed end-to-end with the consumer's bank-issued consent token, which Iniciador's backend stitches in after the payer authorizes the consent at their bank. OAuth2 client-credentials is required for some flows and lands when consent + bank-issued token plumbing is wired end-to-end.

Issue credentials during Iniciador onboarding:

Sandbox / Testing

Sandbox endpoint: https://sandbox.iniciador.com.br. Override via INICIADOR_API_BASE.

Environment Variables

VariableRequiredDescription
INICIADOR_API_KEYyesAPI key from Iniciador onboarding
INICIADOR_API_BASEnoOverride API base URL (default https://api.iniciador.com.br)

Iniciador vs Pluggy vs Belvo

Three OFB aggregators in this catalog, each with a different specialty:

AggregatorStrengthBest for
IniciadorPix payment initiation (PISP)Outgoing payments under OFB consent
Pluggy (@codespar/mcp-pluggy)Account + transaction readsReconciliation, balance polling
Belvo (@codespar/mcp-belvo)Multi-LATAM Open Finance + payroll + taxCross-border (BR + MX + CO + AR)

For commerce agents that need both reads and writes, compose them — Pluggy/Belvo for account + recon visibility + Iniciador for Pix initiation.

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.

License

MIT

Source: packages/banking/iniciador/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.1.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