Skip to main content
MA

Matera

v0.2.0-alpha.2OAuth2alpha

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

What your agent can do

Matera gives your agent 22 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

  • create_pix_charge_staticCreate 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_dynamicCreate 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_chargeRetrieve a Pix charge (static or dynamic) by txid.
Example call
// 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("create_pix_charge_static", { /* ... */ });

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

Run `npx -y @codespar/mcp-matera` and add the config block above to your MCP client — Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Matera — MCP server · 22 tools | CodeSpar