@codespar/mcp-matera 0.2.0-alpha.1 → 0.2.0-alpha.3

package/README.md

@@ -63,20 +63,32 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 }
 ```
 
-## Tools
-
-| Tool | Description |
-|------|-------------|
-| `create_pix_charge_static` | Static Pix QR code (reusable, tied to a merchant Pix key) |
-| `create_pix_charge_dynamic` | Dynamic Pix QR code (single-use, expiring) |
-| `get_pix_charge` | Retrieve a Pix charge by txid |
-| `create_pix_payment` | Initiate an outbound Pix transfer |
-| `get_pix_payment` | Retrieve an outbound Pix payment by endToEndId |
-| `refund_pix_payment` | Refund (devolução) a Pix payment |
-| `list_pix_payments` | List Pix payments with filters (start, end, status) |
-| `resolve_pix_key` | DICT lookup — resolve a Pix key to account info |
-| `list_dict_keys` | List DICT keys registered to merchant accounts |
-| `create_pix_automatico` | Register a recurring Pix Automático agreement (BCB 2025) |
+## Tools (22)
+
+| Tool | Purpose |
+|---|---|
+| `create_pix_charge_static` | Create a static Pix charge (reusable QR code tied to a merchant Pix key). |
+| `create_pix_charge_dynamic` | Create a dynamic Pix charge (single-use QR with expiration). |
+| `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. |
+| `update_pix_charge` | Update an immediate Pix charge (BCB PATCH /cob/{txid}). |
+| `create_pix_charge_due` | Create a due-dated Pix charge (BCB /cobv — Pix com Vencimento). |
+| `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). |
+| `get_pix_payment` | Retrieve an outbound Pix payment by endToEndId. |
+| `refund_pix_payment` | Refund (devolução) a Pix payment. |
+| `list_pix_payments` | List outbound Pix payments with optional filters. |
+| `list_pix_received` | List inbound Pix (Pix recebidos) credited to merchant accounts in a date range. |
+| `resolve_pix_key` | Resolve a Pix DICT key to the account holder's identity and ISPB/branch/account. |
+| `list_dict_keys` | List DICT keys registered to the merchant's accounts on Matera. |
+| `register_dict_key` | Register (claim) a DICT key for a merchant account on Matera. |
+| `delete_dict_key` | Delete a DICT key the merchant owns. |
+| `create_pix_automatico` | Register a Pix Automático recurrence (BCB 2025 recurring Pix product, /rec). |
+| `get_pix_automatico` | Retrieve a Pix Automático recurrence by idRec. |
+| `cancel_pix_automatico` | Cancel an active Pix Automático recurrence. |
+| `get_account_balance` | Get the current balance of a Matera-managed account. |
+| `get_account_statement` | Get the statement (extrato) of a Matera-managed account in a date range. |
+| `internal_transfer` | Book a transfer between two accounts both held on Matera (TED-interno / transferência interna). |
 
 ## Authentication
 
@@ -123,13 +135,13 @@ Track the verification work in the repo issues; PR welcome from anyone with a Ma
 - Boleto issuance
 - Pix MED (Mecanismo Especial de Devolução) flow
 
-Want to contribute? [Open a PR](https://github.com/codespar/mcp-dev-brasil) or [request a tool](https://github.com/codespar/mcp-dev-brasil/issues).
+Want to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).
 
 ## Links
 
 - [Matera](https://matera.com)
 - [Matera API Documentation](https://doc-api.matera.com)
-- [MCP Dev Brasil](https://github.com/codespar/mcp-dev-brasil)
+- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)
 - [Landing Page](https://codespar.dev/mcp)
 
 ## Enterprise

package/dist/index.js

@@ -144,7 +144,10 @@ async function materaRequest(method, path, body) {
     const text = await res.text();
     return text ? JSON.parse(text) : {};
 }
-const server = new Server({ name: "mcp-matera", version: "0.2.0" }, { capabilities: { tools: {} } });
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT = "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+const server = new Server({ name: "mcp-matera", version: "0.2.0" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codespar/mcp-matera",
-  "version": "0.2.0-alpha.1",
+  "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",

package/server.json

@@ -1,18 +1,18 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.codespar/mcp-matera",
-  "description": "MCP server for Matera — Brazilian core-banking infrastructure (BaaS) for fintechs building on top of Pix, DICT, and Pix Automático",
+  "description": "MCP server for Matera — Brazilian core-banking BaaS over Pix, DICT, and Pix Automático",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/banking/matera"
   },
-  "version": "0.2.0-alpha.1",
+  "version": "0.2.0-alpha.3",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-matera",
-      "version": "0.2.0-alpha.1",
+      "version": "0.2.0-alpha.3",
       "transport": {
         "type": "stdio"
       },
@@ -40,5 +40,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.matera.com",
+    "logoUrl": "https://logo.clearbit.com/matera.com",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=matera.com&sz=128",
+    "docsUrl": "https://docs.matera.com",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -152,9 +152,14 @@ async function materaRequest(method: string, path: string, body?: unknown): Prom
   return text ? JSON.parse(text) : {};
 }
 
+// Managed-tier pointer surfaced to the agent via MCP `instructions`.
+// Informational only — nothing CodeSpar-hosted is called (MIT-safe).
+const MANAGED_TIER_HINT =
+  "This open-source CodeSpar server calls the provider's API directly. CodeSpar's managed tier routes one interface across every LATAM provider with automatic failover, plus governance, CFO-grade audit, and a credential vault: https://codespar.dev/agents (npx -y @codespar/mcp serve).";
+
 const server = new Server(
   { name: "mcp-matera", version: "0.2.0" },
-  { capabilities: { tools: {} } },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT },
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({