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

package/README.md

@@ -73,20 +73,30 @@ Add to `.cursor/mcp.json` or `.vscode/mcp.json`:
 }
 ```
 
-## Tools
-
-| Tool | Description |
-|------|-------------|
-| `create_account` | Open a digital account for an end user |
-| `get_account` | Retrieve account balance, status, coordinates |
-| `send_pix` | Outbound Pix transfer from a Dock account |
-| `get_pix` | Retrieve Pix payment by endToEndId |
-| `create_pix_qr_static` | Reusable Pix QR (points-of-sale, donations) |
-| `create_pix_qr_dynamic` | Single-use expiring Pix QR (e-commerce checkouts) |
-| `refund_pix` | Refund (devolução) a Pix payment |
-| `resolve_dict_key` | DICT lookup — resolve Pix key to account holder |
-| `issue_card` | Issue debit / credit / prepaid / virtual card — Dock's differentiator |
-| `get_card` | Retrieve card status, masked PAN, limits |
+## Tools (20)
+
+| Tool | Purpose |
+|---|---|
+| `create_account` | Create a digital account for an end user (CPF holder) on Dock. |
+| `get_account` | Retrieve a Dock account by id. |
+| `send_pix` | Initiate an outbound Pix transfer from a Dock account to any Pix key in BR. |
+| `get_pix` | Retrieve an outbound Pix payment by endToEndId. |
+| `create_pix_qr_static` | Create a static Pix QR (reusable, tied to a merchant Pix key). |
+| `create_pix_qr_dynamic` | Create a dynamic Pix QR (single-use, expiring). |
+| `refund_pix` | Refund (devolução) a Pix payment. |
+| `resolve_dict_key` | Resolve a Pix DICT key to the account holder's identity and ISPB/branch/account. |
+| `issue_card` | Issue a card (debit / credit / prepaid / virtual) against a Dock account. |
+| `get_card` | Retrieve a card by id. |
+| `list_accounts` | List Dock accounts under the merchant. |
+| `freeze_account` | Freeze (block) a Dock account. |
+| `unfreeze_account` | Unfreeze a previously frozen Dock account, restoring Pix and card operations. |
+| `block_card` | Block a card temporarily (reversible). |
+| `unblock_card` | Unblock a card that was previously blocked (reversible). |
+| `change_card_status` | Change a card's lifecycle status: ACTIVE / BLOCKED / CANCELED. |
+| `list_transactions` | List transactions on a Dock account (Pix in/out, card auths, fees, transfers). |
+| `get_transaction` | Retrieve a single transaction by id. |
+| `create_webhook` | Register a webhook endpoint to receive Dock event notifications (account.*, pix.*, card.*, transaction.*). |
+| `list_webhooks` | List all webhook endpoints registered for the merchant. |
 
 ## Authentication
 
@@ -133,13 +143,13 @@ PR welcome from anyone with a Dock sandbox.
 - TED / bank transfers (non-Pix rails)
 - Credit underwriting endpoints (Dock's credit stack)
 
-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
 
 - [Dock](https://www.dock.tech)
 - [Dock Developers](https://developers.dock.tech) (gated — requires merchant login)
-- [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

@@ -109,7 +109,10 @@ async function dockRequest(method, path, body) {
     const text = await res.text();
     return text ? JSON.parse(text) : {};
 }
-const server = new Server({ name: "mcp-dock", 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-dock", 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-dock",
-  "version": "0.2.0-alpha.1",
+  "version": "0.2.0-alpha.3",
   "description": "MCP server for Dock — Brazilian Banking-as-a-Service (accounts, Pix, card issuing) for fintechs and embedded-finance products",
   "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-dock",
-  "description": "MCP server for Dock — Brazilian Banking-as-a-Service (accounts, Pix, card issuing) for fintechs and embedded-finance products",
+  "description": "MCP server for Dock — Brazilian Banking-as-a-Service: accounts, Pix, card issuing for fintechs",
   "repository": {
-    "url": "https://github.com/codespar/mcp-dev-brasil",
+    "url": "https://github.com/codespar/mcp-dev-latam",
     "source": "github",
     "subfolder": "packages/banking/dock"
   },
-  "version": "0.2.0-alpha.1",
+  "version": "0.2.0-alpha.3",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@codespar/mcp-dock",
-      "version": "0.2.0-alpha.1",
+      "version": "0.2.0-alpha.3",
       "transport": {
         "type": "stdio"
       },
@@ -40,5 +40,14 @@
         }
       ]
     }
-  ]
+  ],
+  "provider": {
+    "homepage": "https://www.dock.tech",
+    "logoUrl": "https://logo.clearbit.com/dock.tech",
+    "logoFallback": "https://www.google.com/s2/favicons?domain=dock.tech&sz=128",
+    "docsUrl": "https://docs.dock.tech",
+    "sandbox": {
+      "available": true
+    }
+  }
 }

package/src/index.ts

@@ -118,9 +118,14 @@ async function dockRequest(method: string, path: string, body?: unknown): Promis
   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-dock", version: "0.2.0" },
-  { capabilities: { tools: {} } },
+  { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT },
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({