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

package/README.md

@@ -1,5 +1,8 @@
 # MCP Colppy
 
+
+> **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 **Colppy** — Argentine cloud accounting platform with integrated AFIP electronic invoicing.
 
 ## Quick Start
@@ -25,18 +28,32 @@ npx tsx packages/argentina/colppy/src/index.ts --http
 | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
 | `MCP_PORT` | No | HTTP port (default: 3000) |
 
-## Tools
+## Tools (22)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `list_customers` | List customers |
 | `create_customer` | Create a customer |
 | `list_products` | List products and services |
-| `create_invoice` | Create an invoice (integrates with AFIP) |
+| `create_invoice` | Create an invoice (integrates with AFIP for electronic invoicing) |
 | `list_invoices` | List invoices |
 | `get_balance` | Get account balance summary |
 | `list_accounts` | List chart of accounts (plan de cuentas) |
 | `create_payment` | Record a payment against an invoice |
+| `update_customer` | Update an existing customer's data |
+| `delete_customer` | Delete a customer |
+| `get_customer_balance` | Get the current account balance (cuenta corriente) for a customer |
+| `list_suppliers` | List suppliers (proveedores) |
+| `create_supplier` | Create a supplier (proveedor) |
+| `cancel_invoice` | Cancel/void an invoice (anular comprobante) |
+| `get_invoice_pdf` | Get the PDF representation of an invoice (returns URL or base64) |
+| `create_receipt` | Create a receipt (recibo) — record cash/transfer received against one or more invoices |
+| `list_receipts` | List receipts (recibos) |
+| `get_stock` | Get current stock for a product across warehouses |
+| `list_warehouses` | List warehouses (depósitos) |
+| `list_companies` | List companies (empresas) accessible to the current API user |
+| `sales_report` | Sales report by date range |
+| `expenses_report` | Expenses/purchases report by date range |
 
 ## Auth
 
@@ -48,4 +65,19 @@ Uses **API key + session** authentication. The API key is sent with each request
 
 ---
 
-**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:
+
+- `COLPPY_API_KEY` *(required, secret)* — API key for Colppy
+- `COLPPY_COMPANY_ID` *(required)* — Company identifier
+
+Issue credentials at the provider's developer portal: <https://api.colppy.com/>.
+
+## License
+
+MIT

package/dist/index.js

@@ -47,7 +47,10 @@ async function colppyRequest(service, operation, params) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-colppy", 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-colppy", version: "0.2.0-alpha.2" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -552,7 +555,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-colppy", version: "0.2.0-alpha.1" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-colppy", 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-colppy",
-  "version": "0.2.0-alpha.1",
+  "version": "0.2.0-alpha.3",
   "description": "MCP server for Colppy — Argentine cloud accounting + AFIP invoicing",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "mcp-colppy": "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": ["colppy", "accounting", "argentina", "afip", "invoicing", "mcp"],
+  "keywords": [
+    "colppy",
+    "accounting",
+    "argentina",
+    "afip",
+    "invoicing",
+    "mcp"
+  ],
   "mcpName": "io.github.codespar/mcp-colppy"
 }