@codespar/mcp-alegra 0.2.0 → 0.2.2

package/README.md

@@ -25,19 +25,29 @@ npx tsx packages/colombia/alegra/src/index.ts --http
 | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
 | `MCP_PORT` | No | HTTP port (default: 3000) |
 
-## Tools
+## Tools (20)
 
-| Tool | Description |
-|------|-------------|
+| Tool | Purpose |
+|---|---|
 | `create_invoice` | Create an invoice |
 | `get_invoice` | Get invoice details by ID |
 | `list_invoices` | List invoices |
-| `create_contact` | Create a contact (customer/supplier) |
+| `void_invoice` | Void/cancel an invoice |
+| `get_invoice_pdf` | Get invoice PDF download URL |
+| `send_invoice` | Email an invoice to one or more recipients |
+| `create_contact` | Create a contact (customer or supplier) |
+| `update_contact` | Update an existing contact |
+| `delete_contact` | Delete a contact |
 | `list_contacts` | List contacts |
-| `create_item` | Create a product/service item |
+| `create_item` | Create a product or service item |
+| `update_item` | Update an existing item |
 | `list_items` | List products and services |
 | `list_payments` | List payments |
+| `get_payment` | Get payment by ID |
 | `create_payment` | Record a payment |
+| `void_payment` | Void/annul a payment |
+| `list_categories` | List item categories (chart of accounts) |
+| `list_bank_accounts` | List bank accounts |
 | `get_company` | Get company profile and settings |
 
 ## Auth
@@ -50,4 +60,19 @@ Uses **Basic authentication** with email and API token. Obtain your API token fr
 
 ---
 
-**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:
+
+- `ALEGRA_EMAIL` *(required)* — Account email for Alegra
+- `ALEGRA_API_TOKEN` *(required, secret)* — API token for Alegra
+
+Issue credentials at the provider's developer portal: <https://developer.alegra.com>.
+
+## License
+
+MIT

package/dist/index.js

@@ -53,7 +53,10 @@ async function alegraRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-alegra", 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-alegra", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -635,7 +638,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-alegra", version: "0.2.0" }, { capabilities: { tools: {} } });
+                const s = new Server({ name: "mcp-alegra", version: "0.2.1" }, { 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-alegra",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for Alegra — cloud accounting for LATAM (Colombian-founded)",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "mcp-alegra": "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": ["alegra", "accounting", "colombia", "latam", "invoicing", "mcp"],
+  "keywords": [
+    "alegra",
+    "accounting",
+    "colombia",
+    "latam",
+    "invoicing",
+    "mcp"
+  ],
   "mcpName": "io.github.codespar/mcp-alegra"
 }