Safrapay MCP Server

MCP server for Safrapay - Banco Safra's acquirer. B2B-banking crossover focused on mid-to-large BR merchants and private-banking clientele. Its 22 documented tools cover payment, recurrence, card.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Safrapay

before you install - you'll need

Set SAFRAPAY_CLIENT_ID, SAFRAPAY_CLIENT_SECRET, SAFRAPAY_MERCHANT_ID, MCP_HTTP before connecting. SAFRAPAY_ENV is optional or environment-specific per the README.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-payments -- npx -y @codespar/mcp-safrapay

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-payments": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-safrapay"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-safrapay - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Safrapay can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can capture a previously authorized (pre-auth) payment, cancel (void) an authorized-but-uncaptured payment, create a Pix charge, and create a boleto charge.

Capability map

Tools grouped from the project's README - what Safrapay lets an agent do.

Payment

6 tools - e.g. Authorize a credit-card payment on Safrapay.; Capture a previously authorized (pre-auth) payment.; Cancel (void) an authorized-but-uncaptured payment.

authorize_payment · capture_payment · cancel_payment · refund_payment · get_payment · create_payment_link

read & search

6 tools - e.g. Retrieve the digital statement (extrato).; List charges with optional filters.; Look up charges by the merchant-side order identifier (the order_id supplied at creation).

get_statement · list_transactions · search_by_merchant_order · query_chargeback · query_installments · get_settlement_report

create & write

3 tools - e.g. Create a Pix charge.; Create a boleto charge.; Configure split distribution for an existing charge.

create_pix · create_boleto · create_split_rule

Recurrence

3 tools - e.g. Create a recurring-billing subscription.; Retrieve a recurrence by id: schedule, next-charge date, charge history, status.; Cancel an active recurrence.

create_recurrence · get_recurrence · cancel_recurrence

auth & access

2 tools - e.g. Tokenize a card for PCI-safe reuse.; Kick off 3-D Secure authentication before authorize_payment.

tokenize_card · authenticate_3ds

delete

1 tool - e.g. Revoke a stored card token.

delete_card_token

1 tool - e.g. Bulk-register webhook subscriptions on the Safrapay webhook product.

register_webhook

04 · Who maintains Safrapay

mcp-safrapay is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: other - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-safrapay (active, first published 2026-06-20 · 2 versions)
packages: npm:@codespar/mcp-safrapay

06 · Safrapay FAQ

Is Safrapay still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Safrapay do?

With this server connected, an agent can capture a previously authorized (pre-auth) payment, cancel (void) an authorized-but-uncaptured payment, create a Pix charge, and create a boleto charge.

How do I install Safrapay?

Run `npx -y @codespar/mcp-safrapay`. The README documents 5 environment variables (SAFRAPAY_CLIENT_ID, SAFRAPAY_CLIENT_SECRET, SAFRAPAY_MERCHANT_ID…) to set first. Set SAFRAPAY_CLIENT_ID, SAFRAPAY_CLIENT_SECRET, SAFRAPAY_MERCHANT_ID, MCP_HTTP before connecting. SAFRAPAY_ENV is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Safrapay run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Safrapay

Alternatives to Safrapay

Maintained other servers if Safrapay isn't the fit.

More MCP servers to compare · Transbank · Ucp · Wise · Win Bridge Agent · Schelling Protocol

More JavaScript MCP servers · Stone · Stripe · Stripe Acp · see all