{"_id":"@codespar/mcp-matera","_rev":"5-f8a2951b0e35186ff5c6bf1242839c08","name":"@codespar/mcp-matera","dist-tags":{"latest":"0.2.0-alpha.3","alpha":"0.2.0-alpha.2"},"versions":{"0.1.0-alpha.1":{"name":"@codespar/mcp-matera","version":"0.1.0-alpha.1","keywords":["mcp","matera","banking","baas","core-banking","pix","pix-automatico","dict","brazil","fintech"],"license":"MIT","_id":"@codespar/mcp-matera@0.1.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-matera":"dist/index.js"},"dist":{"shasum":"1a6caeb4da041209d40ebb7bf5a4a3148bc82328","tarball":"https://registry.npmjs.org/@codespar/mcp-matera/-/mcp-matera-0.1.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-S2U7o/SmvxLDIlMMPgGPf/ZCil4QnN2/jMIwS5Hgb3oKkoVyvG7+7ElS1z772W+WrQr7ImzCOyIJbU/4ERIIbg==","signatures":[{"sig":"MEUCIQC3Va7P4hvax89SwKU76VimcestIZAQa+kccGuov8ieDAIgYTxf3f5BD7JVqR5Y0tBZG1AlRQVX14zNPKDBYHQflko=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44359},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"286c1445fcebf46fb88fd416a77412e331aa63a6","mcpName":"io.github.codespar/mcp-matera","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Matera — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-matera_0.1.0-alpha.1_1776991716805_0.03362882451214433","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.1":{"name":"@codespar/mcp-matera","version":"0.2.0-alpha.1","keywords":["mcp","matera","banking","baas","core-banking","pix","pix-automatico","dict","brazil","fintech"],"license":"MIT","_id":"@codespar/mcp-matera@0.2.0-alpha.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-matera":"dist/index.js"},"dist":{"shasum":"6e68f3699639159d1812477b2beff7fa94a9f699","tarball":"https://registry.npmjs.org/@codespar/mcp-matera/-/mcp-matera-0.2.0-alpha.1.tgz","fileCount":6,"integrity":"sha512-omT7WD8iLy1roYbZVtQ0liZeewpYcmIYpA6Sp+Bcv13y/7ZKXn09xqnxTJsk0VpCdcrrhwwk3j6IalkX2Uxfjw==","signatures":[{"sig":"MEUCIQDOdlQ+3OLZGE2khS765fry4cqoRgLjzuVOuJ5BkE/JVQIgF1YSrARVmd5xPt2Tl/LKjlD4B8Um3m8b4sTSMYvmYl4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":92094},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"4d61b23e069b421d30d91b4b27c118ae36267449","mcpName":"io.github.codespar/mcp-matera","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Matera — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp-matera_0.2.0-alpha.1_1777115039482_0.7973369828363179","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.2":{"name":"@codespar/mcp-matera","version":"0.2.0-alpha.2","keywords":["mcp","matera","banking","baas","core-banking","pix","pix-automatico","dict","brazil","fintech"],"license":"MIT","_id":"@codespar/mcp-matera@0.2.0-alpha.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-matera":"dist/index.js"},"dist":{"shasum":"538cf3909ccd30bb27d420c7176519cff90b0ebd","tarball":"https://registry.npmjs.org/@codespar/mcp-matera/-/mcp-matera-0.2.0-alpha.2.tgz","fileCount":6,"integrity":"sha512-NwFhbrQZ6VhxbkiMf2rql2qIAmxqvm+aErY7iwq6z18XLppoTWUs8FRxnxg8uqPkWr7j9qfvyPW5Ph4aaDo8Tw==","signatures":[{"sig":"MEQCICapxB2ITR2Ov6iR7hofXLsWZmD9qr2WnvAt1XRwid0mAiA69X+51Lr0HwdvJZAKNFp+Sl4RxHTqd6O1BvKC1ceR9w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":93300},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b8f7e5b70db9046319ed757225e0eae8f2dc4451","mcpName":"io.github.codespar/mcp-matera","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for Matera — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0","@types/express":"^5.0.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp-matera_0.2.0-alpha.2_1777122929488_0.3198260513688551","host":"s3://npm-registry-packages-npm-production"}},"0.2.0-alpha.3":{"name":"@codespar/mcp-matera","version":"0.2.0-alpha.3","description":"MCP server for Matera — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático","type":"module","main":"./dist/index.js","bin":{"mcp-matera":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/express":"^5.0.6","@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","matera","banking","baas","core-banking","pix","pix-automatico","dict","brazil","fintech"],"mcpName":"io.github.codespar/mcp-matera","_id":"@codespar/mcp-matera@0.2.0-alpha.3","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-s25V6UcvR/iX2nbbUFdxqOsrp23AJxlbibRF5A79nYxLB4F8a3R1bW2YJC5buMwa68z+ZDYm7+xpeuJwrBew7g==","shasum":"c51634279ca639439aed106950ea6a1601eeeb58","tarball":"https://registry.npmjs.org/@codespar/mcp-matera/-/mcp-matera-0.2.0-alpha.3.tgz","fileCount":6,"unpackedSize":94509,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDTqRJgQruMVE4XiOTzy8Gc7wYYF01pK5ycAZOuS5JvHAiEAjZObrE/OJLjgS8HATGDgkgCb6m7YANytHH0KQ1xxa2s="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-matera_0.2.0-alpha.3_1782153385423_0.45980172742249703"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T00:48:36.732Z","modified":"2026-06-22T18:36:25.723Z","0.1.0-alpha.1":"2026-04-24T00:48:36.960Z","0.2.0-alpha.1":"2026-04-25T11:03:59.635Z","0.2.0-alpha.2":"2026-04-25T13:15:29.622Z","0.2.0-alpha.3":"2026-06-22T18:36:25.571Z"},"license":"MIT","keywords":["mcp","matera","banking","baas","core-banking","pix","pix-automatico","dict","brazil","fintech"],"description":"MCP server for Matera — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-matera\n\n> MCP server for **Matera** — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-matera)](https://www.npmjs.com/package/@codespar/mcp-matera)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Why Matera\n\nMatera 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).\n\nThis 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`.\n\nUse Matera when an agent needs to:\n- Spin up Pix charges against accounts the fintech itself issued\n- Do DICT lookups to resolve a Pix key before moving money\n- Register recurring **Pix Automático** agreements (BCB 2025 product — few providers are live with this)\n- Move money bank-to-bank through the fintech's own Matera rails\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"matera\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-matera\"],\n      \"env\": {\n        \"MATERA_CLIENT_ID\": \"your-client-id\",\n        \"MATERA_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add matera -- npx @codespar/mcp-matera\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"matera\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-matera\"],\n      \"env\": {\n        \"MATERA_CLIENT_ID\": \"your-client-id\",\n        \"MATERA_CLIENT_SECRET\": \"your-client-secret\"\n      }\n    }\n  }\n}\n```\n\n## Tools (22)\n\n| Tool | Purpose |\n|---|---|\n| `create_pix_charge_static` | Create a static Pix charge (reusable QR code tied to a merchant Pix key). |\n| `create_pix_charge_dynamic` | Create a dynamic Pix charge (single-use QR with expiration). |\n| `get_pix_charge` | Retrieve a Pix charge (static or dynamic) by txid. |\n| `list_pix_charges` | List immediate Pix charges (BCB /cob) with date and status filters. |\n| `update_pix_charge` | Update an immediate Pix charge (BCB PATCH /cob/{txid}). |\n| `create_pix_charge_due` | Create a due-dated Pix charge (BCB /cobv — Pix com Vencimento). |\n| `get_pix_charge_due` | Retrieve a due-dated Pix charge (BCB GET /cobv/{txid}). |\n| `create_pix_payment` | Initiate an outbound Pix transfer (ordem de pagamento). |\n| `get_pix_payment` | Retrieve an outbound Pix payment by endToEndId. |\n| `refund_pix_payment` | Refund (devolução) a Pix payment. |\n| `list_pix_payments` | List outbound Pix payments with optional filters. |\n| `list_pix_received` | List inbound Pix (Pix recebidos) credited to merchant accounts in a date range. |\n| `resolve_pix_key` | Resolve a Pix DICT key to the account holder's identity and ISPB/branch/account. |\n| `list_dict_keys` | List DICT keys registered to the merchant's accounts on Matera. |\n| `register_dict_key` | Register (claim) a DICT key for a merchant account on Matera. |\n| `delete_dict_key` | Delete a DICT key the merchant owns. |\n| `create_pix_automatico` | Register a Pix Automático recurrence (BCB 2025 recurring Pix product, /rec). |\n| `get_pix_automatico` | Retrieve a Pix Automático recurrence by idRec. |\n| `cancel_pix_automatico` | Cancel an active Pix Automático recurrence. |\n| `get_account_balance` | Get the current balance of a Matera-managed account. |\n| `get_account_statement` | Get the statement (extrato) of a Matera-managed account in a date range. |\n| `internal_transfer` | Book a transfer between two accounts both held on Matera (TED-interno / transferência interna). |\n\n## Authentication\n\nMatera'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](https://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.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `MATERA_CLIENT_ID` | Yes | OAuth2 client_id issued by Matera |\n| `MATERA_CLIENT_SECRET` | Yes | OAuth2 client_secret (secret) |\n| `MATERA_BASE_URL` | No | API base URL. Defaults to `https://api.matera.com`. Sandbox URL varies per product line — ask your Matera contact. |\n\n## Status\n\n**v0.1.0-alpha.1 — tool surface is stable, wire paths are NOT yet verified.**\n\nOn 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.\n\nUntil we can run the server against a live Matera sandbox, the following remain **assumed, not verified**:\n\n| Area | Value in code | Why it's suspect |\n|------|---------------|------------------|\n| Token endpoint | `POST /auth/token` (Basic auth, `grant_type=client_credentials`) | Likely wrong for server integration — see Authentication |\n| Pix charges | `/pix/charges/static`, `/pix/charges/dynamic`, `/pix/charges/{txid}` | Matera likely follows BCB's `/cob` (immediate) / `/cobv` (dated) naming |\n| Pix payments | `/pix/payments`, `/pix/payments/{e2eid}`, `/pix/payments/{e2eid}/refund` | BCB spec names refunds `/pix/{e2eid}/devolucao/{id}` |\n| DICT lookup | `GET /pix/dict/{key}`, `GET /pix/dict/keys` | BCB DICT is RSFN-gated; Matera exposes its own wrapper. Exact path unknown. |\n| Pix Automático | `POST /pix/automatico` | Almost certainly a placeholder. BCB 2025 spec uses `POST /rec` (recurrence) + `/cobr/{txid}` (recurring charge). |\n\nThe 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.\n\nTrack the verification work in the repo issues; PR welcome from anyone with a Matera sandbox.\n\n## Roadmap\n\n### v0.2 (planned)\n- Signed-request auth path (`secret-key` + `data-signature`) for endpoints that require it\n- Account opening (abertura de conta) — Matera IB product\n- TED / bank transfers (non-Pix rails)\n- Webhook event helpers\n\n### v0.3 (planned)\n- Internet Banking Server tools (statements, balances, card management)\n- Boleto issuance\n- Pix MED (Mecanismo Especial de Devolução) flow\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [Matera](https://matera.com)\n- [Matera API Documentation](https://doc-api.matera.com)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent-initiated bank transfers? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}