Matera

@codespar/mcp-matera · v0.2.0-alpha.4

🇧🇷 BrazilBankingAuth · OAuth2beta22 tools3 env varsprereleasedeprecated on npm

Brazilian core-banking infrastructure (BaaS). Processes ~10% of Brazil's Pix per vendor case studies. Not a PSP — the rails underneath fintechs. For companies building on top of Pix rather than accepting it as a merchant. Alpha release on npm — endpoint paths pending doc verification.

Deprecated on npm: No live endpoint: api.matera.com does not resolve. See https://github.com/codespar/mcp-dev-latam/tree/main/packages/banking/matera

Get started · free View docs

MIT · deprecated on npm

Limitations

v0.2.0-alpha.4 is a prerelease; npm has no stable release of this package.

DetailsSource on GitHub

Package: @codespar/mcp-matera
Version: 0.2.0-alpha.4 · prerelease
npm dist-tag: latest
Category: Banking
Auth: OAuth2
Country: 🇧🇷 Brazil
License: MIT
Transport: stdio · streamable-http

npm GitHub Server catalog docs

Quickstart

Before you use it.

This package is deprecated on npm, so this page offers no install command or client config. No live endpoint: api.matera.com does not resolve. See https://github.com/codespar/mcp-dev-latam/tree/main/packages/banking/matera

Hosted MCP Build your own server

Environment variables3 variables

MATERA_BASE_URLAPI base URL. Defaults to https://api.matera.com (production)optional

MATERA_CLIENT_IDOAuth2 client_id issued by Materarequired

MATERA_CLIENT_SECRETOAuth2 client_secret issued by Materarequiredsecret

Names read from the package code (@codespar/mcp-matera@0.2.0-alpha.4). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

Tools

What your agent can call.

22 tools, as the package's tools/list returns them.

create_pix_charge_static

Create a static Pix charge (reusable QR code tied to a merchant Pix key). Returns EMV copy-paste payload and QR code image. Use for points-of-sale or donations where the same QR is shown to many payers.

create_pix_charge_dynamic

Create a dynamic Pix charge (single-use QR with expiration). Returns txid, EMV copy-paste, and QR image. Preferred for e-commerce checkouts and invoices.

get_pix_charge

Retrieve a Pix charge (static or dynamic) by txid.

list_pix_charges

List immediate Pix charges (BCB /cob) with date and status filters. Use for reconciling QR-driven receipts in a time window.

update_pix_charge

Update an immediate Pix charge (BCB PATCH /cob/{txid}). Use to revise amount/expiration before payment, or to mark a charge REMOVIDA_PELO_USUARIO_RECEBEDOR.

create_pix_charge_due

Create a due-dated Pix charge (BCB /cobv — Pix com Vencimento). Boleto-style charge with due date, late fee (multa), interest (juros), and discount fields. Returns txid + QR payload.

get_pix_charge_due

Retrieve a due-dated Pix charge (BCB GET /cobv/{txid}).

create_pix_payment

Initiate an outbound Pix transfer (ordem de pagamento). Moves money from a debtor account held on Matera to any Pix key in BR. Returns endToEndId once the BCB SPI confirms.

get_pix_payment

Retrieve an outbound Pix payment by endToEndId.

refund_pix_payment

Refund (devolução) a Pix payment. Supports full or partial amount. Use reason codes per BCB MED catalog.

list_pix_payments

List outbound Pix payments with optional filters. Useful for reconciliation and agent-driven audit.

list_pix_received

List inbound Pix (Pix recebidos) credited to merchant accounts in a date range. Mirrors BCB GET /pix. Filter by txid to find the receipt that closed a specific cob.

Names and descriptions come from the package's tools/list (@codespar/mcp-matera@0.2.0-alpha.4). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio · streamable-http.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Matera MCP server?

The npm package @codespar/mcp-matera is deprecated, so this page shows no install command for it. The registry says: No live endpoint: api.matera.com does not resolve. See https://github.com/codespar/mcp-dev-latam/tree/main/packages/banking/matera

What can my agent do with Matera?

Matera exposes 22 tools for banking. Your agent calls them directly; the full list is above.

How does Matera authenticate, and how are credentials stored?

Matera uses OAuth2. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Matera handle upstream API changes?

Every server is versioned independently on npm. This one is deprecated (see the notice above), so the page does not suggest pinning a version.

Is Matera open source? How do I report a bug?

Yes. Matera is MIT-licensed and published on npm as @codespar/mcp-matera, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Pairs well with