Matera

v0.2.0-alpha.1OAuth2alpha

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.

22 tools3 env vars🇧🇷 Brazilalpha — pending validation

Install

terminal

$ npm install @codespar/mcp-matera@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "matera": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-matera@alpha"
      ],
      "env": {
        "MATERA_CLIENT_ID": "<your_matera_client_id>",
        "MATERA_CLIENT_SECRET": "<your_matera_client_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 22 tools below — try create_pix_charge_static first.

Environment variables · 3

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

MATERA_CLIENT_ID

required

OAuth2 client_id issued by Matera

MATERA_CLIENT_SECRET

requiredsecret

OAuth2 client_secret issued by Matera

MATERA_BASE_URL

optional

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

Available tools · 22

Each tool is independent — your agent loads only what it needs to reduce context and response time.

WRITEcreate_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.

WRITEcreate_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.

WRITEget_pix_charge

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

WRITElist_pix_charges

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

WRITEupdate_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.

WRITEcreate_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.

WRITEget_pix_charge_due

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

WRITEcreate_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.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.