Mcp Matera

@codespar/mcp-matera

Deprecated: no live endpoint. Measured on 2026-09-27 against two public DNS resolvers (8.8.8.8 and 1.1.1.1): api.matera.com, the host this server calls, does not resolve in DNS. No tool in this server reaches a service. The package is deprecated on npm and stays in this repository for reference only. If you have a working endpoint, point the server at it with MATERA_BASE_URL. To bring the package back, open an issue in mcp-dev-latam with the provider's documented base URL.

MCP server for Matera — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático

[npm] [License: MIT]

Why Matera

Matera is core-banking infrastructure, not a PSP. Per vendor case studies it processes roughly 10% of Brazil's Pix transactions. Its customer is a fintech building on top of Pix — issuing accounts, moving money through DICT, registering Pix Automático agreements — not a merchant accepting Pix (that's what Zoop / Asaas / Mercado Pago are for).

This opens a segment in the CodeSpar catalog distinct from PSP servers: fintech-building-on-top-of-Pix. Matera sits under banking alongside Stark Bank and Open Finance, not under payments.

Use Matera when an agent needs to:

• Spin up Pix charges against accounts the fintech itself issued
• Do DICT lookups to resolve a Pix key before moving money
• Register recurring Pix Automático agreements (BCB 2025 product — few providers are live with this)
• Move money bank-to-bank through the fintech's own Matera rails

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{  "mcpServers": {    "matera": {      "command": "npx",      "args": ["-y", "@codespar/mcp-matera"],      "env": {        "MATERA_CLIENT_ID": "your-client-id",        "MATERA_CLIENT_SECRET": "your-client-secret"      }    }  }}

Claude Code

claude mcp add matera -- npx @codespar/mcp-matera

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

{  "servers": {    "matera": {      "command": "npx",      "args": ["-y", "@codespar/mcp-matera"],      "env": {        "MATERA_CLIENT_ID": "your-client-id",        "MATERA_CLIENT_SECRET": "your-client-secret"      }    }  }}

Tools (22)

Authentication

Matera's public doc index states that server integration uses secret-key + data-signature headers, while OAuth2 is scoped to mobile / web-UI integrations (doc-api.matera.com). The v0.1-alpha scaffold currently implements the OAuth2 client-credentials path against POST /auth/token. That pairing is almost certainly wrong for server-to-server use and will be replaced with the signed-request scheme once we can validate against a live sandbox — see the "Status" section below.

Environment Variables

Status

v0.1.0-alpha.1 — tool surface is stable, wire paths are NOT yet verified.

On 2026-04-24 we attempted to validate every endpoint path against doc-api.matera.com. The doc site is reachable in a browser but could not be fetched from our automation environment (DNS / network-gated; no login wall observed). Public search snippets and third-party references confirm the product surface (Pix charges, Pix payments, DICT, Pix Automático) and the authentication model (server = secret-key + data-signature; OAuth2 = end-user only) but do not surface the exact URL paths.

Until we can run the server against a live Matera sandbox, the following remain assumed, not verified:

The 10 tool names and input schemas above are the public contract and will remain stable. Only the internal HTTP calls in src/index.ts will change when we verify against the sandbox. Using this server against a live Matera tenant today will produce 404s on most calls.

Track the verification work in the repo issues; PR welcome from anyone with a Matera sandbox.

Roadmap

v0.2 (planned)

• Signed-request auth path (secret-key + data-signature) for endpoints that require it
• Account opening (abertura de conta) — Matera IB product
• TED / bank transfers (non-Pix rails)
• Webhook event helpers

v0.3 (planned)

• Internet Banking Server tools (statements, balances, card management)
• Boleto issuance
• Pix MED (Mecanismo Especial de Devolução) flow

Want to contribute? Open a PR or request a tool.

Links

• Matera
• Matera API Documentation
• MCP Dev LATAM
• Landing Page

Enterprise

Need governance, budget limits, and audit trails for agent-initiated bank transfers? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT