3rd largest private BR bank. Completes the top-3 BR private-bank trio (Itaú + Bradesco + Santander). OAuth2 + mTLS. Cobrança workspace-scoped with X-Application-Key. Alpha on npm — auth verified via community SDKs, Pix paths BACEN-standard high confidence.
Santander Brasil gives your agent 23 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.
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.send_pix — Initiate an outbound Pix payment from the merchant's Santander account. Amount in BRL major units (e.g. '10.50').create_pix_qr — Create a dynamic Pix charge with QR code (cob). Returns the txid, copy-paste EMV payload, and location URL.// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("get_oauth_token", { /* ... */ });$ npm install @codespar/mcp-santander@alphaAdd this entry to your claude_desktop_config.json (or any MCP-compatible client config).
{
"mcpServers": {
"santander": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-santander@alpha"
],
"env": {
"SANTANDER_CLIENT_ID": "<your_santander_client_id>",
"SANTANDER_CLIENT_SECRET": "<your_santander_client_secret>",
"SANTANDER_CERT_PATH": "<your_santander_cert_path>",
"SANTANDER_KEY_PATH": "<your_santander_key_path>"
}
}
}
}After restart, your agent can call any of the 23 tools below — try get_oauth_token first.
Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.
SANTANDER_CLIENT_IDSantander OAuth client_id issued via the Developer Portal (developer.santander.com.br) after contract onboarding.
SANTANDER_CLIENT_SECRETSantander OAuth client_secret.
SANTANDER_CERT_PATHAbsolute path to the mTLS client certificate (.crt or .pem). BACEN mandates mTLS for Pix v2, and Santander's trust-open gateway enforces it across product families.
SANTANDER_KEY_PATHAbsolute path to the mTLS private key (.key or .pem).
SANTANDER_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.
Each tool is independent — your agent loads only what it needs to reduce context and response time.
get_oauth_tokensend_pixcreate_pix_qrget_pixresolve_dict_keyrefund_pixcreate_boletoget_boletoMCP is a protocol — any framework that speaks it can mount this server.