Skip to main content
I

Iniciador

@codespar/mcp-iniciador · v0.1.2

🇧🇷 BrasilPagamentosAuth · API Keyalpha9 ferramentas2 variáveis de ambiente

PISP de Open Finance BR — iniciação de pagamento Pix. O operador dispara uma transferência pagador→recebedor pela licença PISP da Iniciador; o pagador autoriza uma vez no app do banco e o pagamento sai da própria conta dele. Alternativa às trilhas de credenciadora quando o banco do pagador deve ser a fonte dos fundos. API key (X-API-KEY) + consentimento OAuth2 pra alguns fluxos. Alpha no npm — conjunto de endpoints provisório pendente de validação ao vivo.

Comece · grátisVer docs

MIT · roda localmente com as suas credenciais

Variáveis de ambiente, nomes e descrições das ferramentas vêm do pacote npm e ficam em inglês.

Limitações

  • O servidor não inicia sem as variáveis de ambiente definidas, nem para listar as ferramentas.
  • O manifesto do pacote não declara 1 das 2 variáveis que o código lê.
  • O manifesto do pacote declara INICIADOR_CLIENT_ID, INICIADOR_CLIENT_SECRET, que o código não lê.
  • O pacote npm não traz o manifesto server.json.
  • Chamadas hospedadas com chave de teste não estão disponíveis: o runtime não registrou o comportamento deste provedor em teste (test venue unclassified).
Pacote
@codespar/mcp-iniciador
Versão
0.1.2
dist-tag npm
latest
Categoria
Pagamentos
Auth
API Key
País
🇧🇷 Brasil
Licença
MIT
Transporte
stdio

Início rápido

Instale, configure as credenciais, faça a primeira chamada.

Escolha seu cliente. O servidor roda localmente via stdio, com as suas credenciais.

Adicione o servidor ao seu clienteUma entrada de configuração. Sem build, sem SDK.
Defina as variáveis de ambiente2 variáveis lidas pelo código deste servidor, listadas abaixo.
Reinicie e faça a primeira chamadaO agente pode chamar qualquer uma das 9 ferramentas. Comece por list_institutions.
terminal
# Claude Code claude mcp add iniciador -e INICIADOR_API_BASE=… -e INICIADOR_API_KEY=… -- npx -y @codespar/mcp-iniciador@0.1.2 # then: /mcp to confirm the server is connected
Variáveis de ambiente2 variáveis
INICIADOR_API_BASEAPI base URL — defaults to Iniciador production. Override for sandbox.opcional
INICIADOR_API_KEYLida pelo código; o manifesto do pacote não a declara.

Nomes lidos do código do pacote (@codespar/mcp-iniciador@0.1.2). Descrições e marcações vêm do manifesto dele. Auto-hospedado, você guarda as credenciais.

Primeira chamada demolist_institutions

"List Brazilian banks supported for Pix payment initiation. Iniciador endpoint: GET /institutions"

tools/calllist_institutionsresultado devolvido

Ferramentas

O que o seu agente pode chamar.

9 ferramentas, como o tools/list do pacote as devolve.

list_institutions

List Brazilian banks supported for Pix payment initiation. Iniciador endpoint: GET /institutions.

create_consent

Create a payment consent that the payer will authorize at their bank. Iniciador endpoint: POST /consents.

get_consent

Fetch a payment consent and its current authorization status. Iniciador endpoint: GET /consents/{id}.

revoke_consent

Revoke a payment consent before it is exercised. Iniciador endpoint: DELETE /consents/{id}.

create_payment

Initiate a Pix transfer once a consent has been authorized. Iniciador endpoint: POST /payments.

get_payment

Fetch a payment by id (status, E2E id, error reason if rejected). Iniciador endpoint: GET /payments/{id}.

list_payments

List payments in a date range with optional filters. Iniciador endpoint: GET /payments.

cancel_payment

Attempt to cancel a payment that has not yet settled. Iniciador endpoint: POST /payments/{id}/cancel.

get_authorization_url

Build the URL where the payer authorizes a consent at their bank. This is a helper — it does not call Iniciador. Returns the standard OFB authorization URL using the consent id + redirect URI.

Nomes e descrições vêm do tools/list do pacote (@codespar/mcp-iniciador@0.1.2). Um tipo (leitura, escrita, exclusão) só aparece quando o pacote anota suas ferramentas ou cada ferramenta foi verificada uma a uma; nenhum dos dois existe ainda para este servidor.

Compatibilidade

MCP é um protocolo. Qualquer cliente que o fale pode montar este servidor.

O codespar_discover lista as ferramentas deste servidor, mas um projeto com chave de teste ainda não consegue chamá-las: o runtime não registrou o que este provedor faz em modo de teste e recusa em vez de adivinhar.

Protocolo

Qualquer cliente MCP

stdio

Perguntas

Antes de instalar.

Como instalo o servidor MCP Iniciador?

Rode npx -y @codespar/mcp-iniciador@0.1.2 e adicione o bloco de configuração acima ao seu cliente MCP: Claude Code, Cursor, Claude Desktop, VS Code ou qualquer cliente compatível. Sem build, sem SDK.

O que meu agente pode fazer com Iniciador?

Iniciador expõe 9 ferramentas de pagamentos. Seu agente as chama diretamente; a lista completa está acima.

Como Iniciador autentica, e como as credenciais são guardadas?

Iniciador usa API Key. Auto-hospedado, você guarda as credenciais: o servidor as lê das variáveis de ambiente.

Como Iniciador lida com mudanças na API do provedor?

Cada servidor tem versão própria no npm. O comando desta página fixa a 0.1.2, a versão cujas ferramentas estão listadas aqui; seu agente segue nela até você trocar a versão.

Iniciador é open source? Como reporto um bug?

Sim. Iniciador tem licença MIT e está publicado no npm como @codespar/mcp-iniciador, com o código no GitHub (link no painel Detalhes). Reporte problemas no repositório do pacote; problemas de segurança vão para security@codespar.dev, e respondemos em até 24 horas.

Comece em segundos.

Adicione a configuração acima, defina as variáveis, e seu agente chama as ferramentas.

Comece em segundos demo
Adicione o servidor ao seu cliente com a configuração acima.
Defina as variáveis de ambiente listadas acima.
Peça ao seu agente a primeira chamada.
Iniciador — MCP server · 9 tools | CodeSpar