mcp-iniciador — Claude Code MCP server: what it does, how to install
Connects AI agents to Iniciador for Open Finance Brasil Pix payments. It creates payment consents, checks authorization, and triggers transfers.
claude mcp add --env INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> --env INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> --env INICIADOR_API_BASE=<INICIADOR_API_BASE> --transport stdio iniciador -- npx -y @codespar/mcp-iniciadorWhat mcp-iniciador does
This MCP server exposes Iniciador endpoints to AI assistants, focusing on Brazilian Open Finance payment initiation (PISP). It provides 9 tools. With them, an assistant can fetch supported banks, create consent requests, or build the authorization link for the payer.
Once the payer confirms consent inside their banking app, the assistant triggers the Pix transfer with create_payment. You can also inspect transaction statuses, list historical records, or attempt cancellation before settlement. To run checks safely, set the base URL to https://sandbox.iniciador.com.br.
Authentication requires credentials issued during Iniciador onboarding. The server will fail without valid keys, and actual Pix-out execution depends entirely on bank-side payer authorization.
What it helps with
- fetch Brazilian banks supported for Pix initiation
- request payment consent from the payer
- build bank authorization URLs for payment flows
- execute outgoing Pix transfers after approval
- check settlement status or rejection reasons
Example prompts for the agent
- Fetch the list of Brazilian banks that support Pix initiation
- Create a payment consent and build the bank authorization link for the customer
- Check the current status and settlement details for payment
pay_12345
How to install mcp-iniciador
Platform CLI
claude mcp add --env INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> --env INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> --env INICIADOR_API_BASE=<INICIADOR_API_BASE> --transport stdio iniciador -- npx -y @codespar/mcp-iniciadorReplace <…> with your own values
Platform CLI
codex mcp add iniciador --env INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> --env INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> --env INICIADOR_API_BASE=<INICIADOR_API_BASE> -- npx -y @codespar/mcp-iniciadorReplace <…> with your own values
Config file
{
"mcpServers": {
"iniciador": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-iniciador"
],
"env": {
"INICIADOR_CLIENT_ID": "<INICIADOR_CLIENT_ID>",
"INICIADOR_CLIENT_SECRET": "<INICIADOR_CLIENT_SECRET>",
"INICIADOR_API_BASE": "<INICIADOR_API_BASE>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"iniciador": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-iniciador"
],
"env": {
"INICIADOR_CLIENT_ID": "<INICIADOR_CLIENT_ID>",
"INICIADOR_CLIENT_SECRET": "<INICIADOR_CLIENT_SECRET>",
"INICIADOR_API_BASE": "<INICIADOR_API_BASE>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> -e INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> -e INICIADOR_API_BASE=<INICIADOR_API_BASE> iniciador npx -y @codespar/mcp-iniciadorReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-iniciador
How to install mcp-iniciador in Claude Code?
Run `claude mcp add mcp-iniciador -e INICIADOR_CLIENT_ID=<INICIADOR_CLIENT_ID> -e INICIADOR_CLIENT_SECRET=<INICIADOR_CLIENT_SECRET> -- npx -y @codespar/mcp-iniciador` in your terminal. Insert your actual Iniciador credentials in place of the bracketed placeholders.
What is the purpose of mcp-iniciador?
It enables agents to act as a Pix payment initiator via Open Finance Brasil. The server handles consent management, payer redirects, and payment requests through Iniciador.
How do you test payments in the Iniciador sandbox?
Set INICIADOR_API_BASE to https://sandbox.iniciador.com.br. Pass this environment variable when registering the server in Claude Code or your editor config.
