MCP.Market

Santander MCP server

by codespar·io.github.codespar/mcp-santander·v0.2.0-alpha.3·271 stars

MCP server for Santander Brasil — Pix, Cobrança (boleto), Arrecadação, Extrato (OAuth2 + mTLS)

B82/100grade B
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
Established

271 stars23 downloads/wk

Reviews

Write one

Nobody has reviewed Santander yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Santander tools (23, 12 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • arrecadacao_paywrite action

    Pay a utility, tax, or concessionária bill via Santander Arrecadação / Pagamento de Contas. Works with barcode (código de barras) or linha digitável.

  • cancel_boletowrite action

    Cancel (baixa) an outstanding boleto before payment.

  • create_boletowrite action

    Issue a boleto via Santander Cobrança (collection_bill_management v2). Requires a pre-provisioned workspace_id that binds the covenant and webhook config. Returns bill_id, linha_digitável, barcode, and PDF URL.

  • create_openfinance_consentwrite action

    Create an Open Finance consent (BACEN-regulated) for data access or payment initiation against a third-party's Santander account. Returns a consent_id and authorization_url the end user must approve.

  • create_pix_cobvwrite action

    Create a Pix charge with due date (cobv — cobrança com vencimento). Used for boleto-replacement flows: the payer sees a Pix QR with a due date, fine, and interest. Requires payer identification.

  • create_pix_qrwrite action

    Create a dynamic Pix charge with QR code (cob). Returns the txid, copy-paste EMV payload, and location URL.

  • delete_dict_keywrite action

    Remove (unregister) a DICT key previously registered for the merchant. Does not affect received Pix that used the key historically.

  • download_boleto_pdf

    Fetch the PDF (second copy / segunda via) of a registered boleto. Returns a base64-encoded PDF payload or a time-limited URL, depending on Santander's workspace config.

  • get_account_balance

    Get current available and blocked balance for a Santander merchant account.

  • get_boleto

    Retrieve a boleto by its Santander bill_id (SONDA query via collection_bill_management v2).

  • get_oauth_token

    Mint or return a cached OAuth2 client_credentials bearer token for the Santander Developer Portal. Exposed so agents can inspect token freshness; normal tool calls obtain tokens implicitly.

  • get_pix

    Retrieve a Pix transaction by its BCB endToEndId (E<ispb><yyyymmddhhmm><sequence>).

  • get_pix_cob

    Retrieve a Pix immediate charge (cob) by its txid. Returns status, EMV payload, and location.

  • get_statement

    Retrieve account statement transactions for a given period. Paginated.

  • list_pix_cob

    List Pix immediate charges (cob) created in a given period. Paginated; filter by status optional.

  • list_pix_received

    List received Pix (Pix recebidos) in a given period. Used for reconciliation of inbound payments, including those without an associated cob.

  • refund_pixwrite action

    Refund (devolução) a previously received Pix. Must reference the original endToEndId and a merchant-side refund id.

  • register_dict_key

    Register a new DICT key for one of the merchant's Santander accounts. BACEN enforces ownership proof (the account document must match the key for CPF/CNPJ keys).

  • resolve_dict_key

    Resolve a DICT key (CPF, CNPJ, email, phone, EVP) to the owner's account data before sending a Pix. Subject to BCB rate limits per consenting payer.

  • send_pixwrite action

    Initiate an outbound Pix payment from the merchant's Santander account. Amount in BRL major units (e.g. '10.50').

  • send_tedwrite action

    Initiate a TED transfer from a Santander merchant account to an account at another bank. For same-day settlement within the TED cutoff window.

  • transfer_internalwrite action

    Transfer between two Santander accounts (TEF / mesma instituição). Settles instantly and is fee-free for most covenants.

  • update_pix_cobwrite action

    Update (PATCH) an existing Pix immediate charge. Typical uses: change status to REMOVIDA_PELO_USUARIO_RECEBEDOR, adjust amount or payer info on an ATIVA charge.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 29 days ago15/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Santander compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 63% of 48,255 servers
Tools
23
the typical server has 7
Tools that change things
52%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
271
more than 95% of 28,688 servers
Downloads a week
23
more than 9% of 12,191 servers with a package

What its tools let an agent do: 10 read · 5 create · 4 change · 2 delete · 2 send or post

Install Santander in Claude Code, Cursor or VS Code

Runs npx -y @codespar/mcp-santander on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-santander -- npx -y @codespar/mcp-santander
Add to Cursor

What the publisher says

From the Santander repository's README, as published. We do not edit it. Read it on GitHub

MCP Dev LATAM 🌎 Every commerce API your AI agent needs to run a business in Latin America. Brazil 🇧🇷 · Mexico 🇲🇽 · Argentina 🇦🇷 · Colombia 🇨🇴 · Chile 🇨🇱 · Peru 🇵🇪 · plus 4 agentic payment protocols. MCP servers for LATAM commerce · live in the official MCP Registry · MIT License Machine-readable catalog: codespar.dev/api/servers Catalog · Quick Start · Agentic Protocols · All Servers · Contribute

The Problem

AI agents can write code, analyze data, and chat. But they can't operate a business — collect payments, issue invoices, ship products, or notify customers. Especially not in Latin America, where every service has its own API, auth pattern, and quirks (mTLS for BACEN Pix v2, JWT-RSA for STP-SPEI, AFIP web services, contract-gated developer portals, and on).

Meanwhile, four agentic payment protocols are shipping in parallel — checkout protocols (Stripe ACP, Google UCP), authorization layers (AP2), and micropayment rails (x402) — and none of them compose cleanly with each other or with the regional rails businesses actually run on.

MCP Dev LATAM bridges both gaps. Traditional LATAM services + the new agentic payment protocols, all accessible through a single MCP interface.

The Solution

Each MCP server in this repo wraps a real provider — payments, fiscal, logistics, messaging, banking, ERP, identity, fraud, crypto, and the agentic protocols — so your agent can operate a complete business workflow.

🛒 Customer places order
  → 💳 Agent charges via Pix (Asaas / Mercado Pago / Zoop)
  → 📄 Agent issues NFe (Nuvem Fiscal / Focus NFe / NFe.io)
  → 📦 Agent generates shipping label (Melhor Envio / Skydropx)
  → 📱 Agent sends tracking via WhatsApp (Z-API / WhatsApp Cloud)
  → 📊 Agent records in ERP (Omie / Bling / Tiny)
  → 🏦 Agent reconciles balance (Stark Bank / Itaú / BTG)

Six systems. Zero human intervention. One agent.

Agentic Payment Protocols

Four servers for the emerging agentic payment stack:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Santander: common questions

Is Santander MCP server safe?
Mostly: it is graded B (82/100). Read the Santander safety report
How do I install Santander?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Santander need an API key?
Yes. The registry entry asks for SANTANDER_CLIENT_SECRET, SANTANDER_KEY_PATH.
Is Santander maintained?
The last commit was 67 days ago (2026-08-29). The latest release is v0.2.0-alpha.3.
How does Santander compare with other MCP servers?
safety score 82/100 (higher than 63% of 48,255 servers); tools 23 (the typical server has 7); tools that change things 52% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from codespar →