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

package/README.md

@@ -1,5 +1,8 @@
 # MCP Nequi
 
+
+> **Alpha release** — published under the `alpha` npm dist-tag. Endpoint paths follow public docs and BACEN/provider conventions but have not been fully live-validated. Pin exact versions during `0.x.x-alpha`. Install with `npm install <pkg>@alpha`.
+
 MCP server for **Nequi** — Colombia's leading digital wallet with 50M+ users, powered by Bancolombia. Supports push payments, QR payments, and subscriptions.
 
 ## Quick Start
@@ -28,16 +31,26 @@ npx tsx packages/colombia/nequi/src/index.ts --http
 | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
 | `MCP_PORT` | No | HTTP port (default: 3000) |
 
-## Tools
+## Tools (16)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `create_push_payment` | Send a push payment notification to a Nequi user |
-| `get_payment_status` | Check payment status |
+| `get_payment_status` | Check the status of a payment |
 | `create_qr_payment` | Generate a QR code for payment |
 | `reverse_payment` | Reverse a completed payment |
-| `get_subscription` | Get subscription details |
+| `get_subscription` | Get subscription details for a phone number |
 | `unsubscribe` | Cancel a subscription |
+| `create_static_qr` | Generate a static (reusable) Nequi QR code for a merchant |
+| `reverse_transaction` | Reverse any Nequi transaction by transaction ID (refund flow) |
+| `validate_phone` | Check whether a phone number is enrolled in Nequi |
+| `notify_unregistered_payment` | Notify a non-Nequi recipient with instructions to claim a payment |
+| `list_transactions` | List transactions for a merchant within a date range |
+| `get_balance` | Get the merchant's own Nequi account balance |
+| `schedule_payment` | Schedule a Nequi push payment for a future date |
+| `authorize_recurring_charge` | Authorize a recurring charge agreement against a Nequi user |
+| `get_merchant_info` | Retrieve registered merchant business profile |
+| `get_settlement` | Query settlement (liquidation) for a given date |
 
 ## Auth
 
@@ -49,4 +62,20 @@ Uses **OAuth2 client credentials** flow. The server obtains an access token usin
 
 ---
 
-**Enterprise?** Contact us at [codespar.com](https://codespar.com) for dedicated support, custom integrations, and SLAs.
+## Enterprise
+
+Need governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.
+
+## Authentication
+
+Set these environment variables before launching the server:
+
+- `NEQUI_API_KEY` *(required, secret)* — API key for Nequi
+- `NEQUI_CLIENT_ID` *(required)* — OAuth2 client ID
+- `NEQUI_CLIENT_SECRET` *(required, secret)* — OAuth2 client secret
+
+Issue credentials at the provider's developer portal: <https://api.nequi.com.co>.
+
+## License
+
+MIT

package/dist/index.js

@@ -77,7 +77,10 @@ async function nequiRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-nequi", version: "0.2.0-alpha.1" }, { 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-nequi", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -578,7 +581,7 @@ async function main() {
                 const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
                 t.onclose = () => { if (t.sessionId)
                     transports.delete(t.sessionId); };
-                const s = new Server({ name: "mcp-nequi", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-nequi", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} } });
                 server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
                 server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
                 await s.connect(t);

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@codespar/mcp-nequi",
-  "version": "0.2.0-alpha.1",
+  "version": "0.2.0-alpha.3",
   "description": "MCP server for Nequi — Colombian digital wallet (by Bancolombia)",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "mcp-nequi": "dist/index.js"
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js"
@@ -20,6 +22,13 @@
     "typescript": "^5.8.0"
   },
   "license": "MIT",
-  "keywords": ["nequi", "wallet", "colombia", "bancolombia", "payments", "mcp"],
+  "keywords": [
+    "nequi",
+    "wallet",
+    "colombia",
+    "bancolombia",
+    "payments",
+    "mcp"
+  ],
   "mcpName": "io.github.codespar/mcp-nequi"
 }