@codespar/mcp-alegra 0.1.0 → 0.2.1

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

package/dist/index.d.ts

@@ -6,12 +6,22 @@
  * - create_invoice: Create an invoice
  * - get_invoice: Get invoice by ID
  * - list_invoices: List invoices
+ * - void_invoice: Void/cancel an invoice
+ * - get_invoice_pdf: Get invoice PDF URL
+ * - send_invoice: Email an invoice to a contact
  * - create_contact: Create a contact (customer/supplier)
+ * - update_contact: Update an existing contact
+ * - delete_contact: Delete a contact
  * - list_contacts: List contacts
  * - create_item: Create a product/service item
+ * - update_item: Update an existing item
  * - list_items: List items
  * - list_payments: List payments
+ * - get_payment: Get payment by ID
  * - create_payment: Record a payment
+ * - void_payment: Void a payment
+ * - list_categories: List item categories (chart of accounts)
+ * - list_bank_accounts: List bank accounts
  * - get_company: Get company profile information
  *
  * Environment:

package/dist/index.js

@@ -6,12 +6,22 @@
  * - create_invoice: Create an invoice
  * - get_invoice: Get invoice by ID
  * - list_invoices: List invoices
+ * - void_invoice: Void/cancel an invoice
+ * - get_invoice_pdf: Get invoice PDF URL
+ * - send_invoice: Email an invoice to a contact
  * - create_contact: Create a contact (customer/supplier)
+ * - update_contact: Update an existing contact
+ * - delete_contact: Delete a contact
  * - list_contacts: List contacts
  * - create_item: Create a product/service item
+ * - update_item: Update an existing item
  * - list_items: List items
  * - list_payments: List payments
+ * - get_payment: Get payment by ID
  * - create_payment: Record a payment
+ * - void_payment: Void a payment
+ * - list_categories: List item categories (chart of accounts)
+ * - list_bank_accounts: List bank accounts
  * - get_company: Get company profile information
  *
  * Environment:
@@ -43,7 +53,7 @@ async function alegraRequest(method, path, body) {
     }
     return res.json();
 }
-const server = new Server({ name: "mcp-alegra", version: "0.1.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "mcp-alegra", version: "0.2.1" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: [
         {
@@ -113,6 +123,53 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 },
             },
         },
+        {
+            name: "void_invoice",
+            description: "Void/cancel an invoice",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    invoiceId: { type: "number", description: "Invoice ID" },
+                    reason: { type: "string", description: "Reason for void/annulment" },
+                },
+                required: ["invoiceId"],
+            },
+        },
+        {
+            name: "get_invoice_pdf",
+            description: "Get invoice PDF download URL",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    invoiceId: { type: "number", description: "Invoice ID" },
+                },
+                required: ["invoiceId"],
+            },
+        },
+        {
+            name: "send_invoice",
+            description: "Email an invoice to one or more recipients",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    invoiceId: { type: "number", description: "Invoice ID" },
+                    emails: {
+                        type: "array",
+                        description: "Recipient email addresses",
+                        items: { type: "string" },
+                    },
+                    cc: {
+                        type: "array",
+                        description: "CC recipients",
+                        items: { type: "string" },
+                    },
+                    subject: { type: "string", description: "Email subject" },
+                    body: { type: "string", description: "Email body/message" },
+                    send_copy_to_user: { type: "boolean", description: "Send a copy to the account user" },
+                },
+                required: ["invoiceId", "emails"],
+            },
+        },
         {
             name: "create_contact",
             description: "Create a contact (customer or supplier)",
@@ -132,6 +189,37 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["name"],
             },
         },
+        {
+            name: "update_contact",
+            description: "Update an existing contact",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    contactId: { type: "number", description: "Contact ID" },
+                    name: { type: "string", description: "Contact name" },
+                    identification: { type: "string", description: "Tax ID" },
+                    email: { type: "string", description: "Email address" },
+                    phone_primary: { type: "string", description: "Primary phone" },
+                    address: { type: "string", description: "Address" },
+                    city: { type: "string", description: "City" },
+                    department: { type: "string", description: "Department/state" },
+                    type: { type: "string", description: "Contact type (client, provider)" },
+                    regime: { type: "string", description: "Tax regime" },
+                },
+                required: ["contactId"],
+            },
+        },
+        {
+            name: "delete_contact",
+            description: "Delete a contact",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    contactId: { type: "number", description: "Contact ID" },
+                },
+                required: ["contactId"],
+            },
+        },
         {
             name: "list_contacts",
             description: "List contacts",
@@ -175,6 +263,28 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["name", "price"],
             },
         },
+        {
+            name: "update_item",
+            description: "Update an existing item",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    itemId: { type: "number", description: "Item ID" },
+                    name: { type: "string", description: "Item name" },
+                    description: { type: "string", description: "Description" },
+                    reference: { type: "string", description: "Reference/SKU code" },
+                    price: { type: "number", description: "Price" },
+                    category: { type: "number", description: "Category ID" },
+                    tax: {
+                        type: "array",
+                        description: "Tax IDs",
+                        items: { type: "number" },
+                    },
+                    type: { type: "string", description: "Item type (product, service, kit)" },
+                },
+                required: ["itemId"],
+            },
+        },
         {
             name: "list_items",
             description: "List products and services",
@@ -201,6 +311,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 },
             },
         },
+        {
+            name: "get_payment",
+            description: "Get payment by ID",
+            inputSchema: {
+                type: "object",
+                properties: { paymentId: { type: "number", description: "Payment ID" } },
+                required: ["paymentId"],
+            },
+        },
         {
             name: "create_payment",
             description: "Record a payment",
@@ -229,6 +348,41 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
                 required: ["date", "amount"],
             },
         },
+        {
+            name: "void_payment",
+            description: "Void/annul a payment",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    paymentId: { type: "number", description: "Payment ID" },
+                },
+                required: ["paymentId"],
+            },
+        },
+        {
+            name: "list_categories",
+            description: "List item categories (chart of accounts)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    start: { type: "number", description: "Offset for pagination" },
+                    limit: { type: "number", description: "Results limit" },
+                    query: { type: "string", description: "Search query" },
+                },
+            },
+        },
+        {
+            name: "list_bank_accounts",
+            description: "List bank accounts",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    start: { type: "number", description: "Offset for pagination" },
+                    limit: { type: "number", description: "Results limit" },
+                    type: { type: "string", description: "Filter by account type" },
+                },
+            },
+        },
         {
             name: "get_company",
             description: "Get company profile and settings",
@@ -275,6 +429,26 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     params.set("client", String(args.client_id));
                 return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("GET", `/invoices?${params}`), null, 2) }] };
             }
+            case "void_invoice": {
+                const payload = { status: "void" };
+                if (args?.reason)
+                    payload.reason = args.reason;
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("PUT", `/invoices/${args?.invoiceId}/void`, payload), null, 2) }] };
+            }
+            case "get_invoice_pdf":
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("GET", `/invoices/${args?.invoiceId}/pdf`), null, 2) }] };
+            case "send_invoice": {
+                const payload = { emails: args?.emails };
+                if (args?.cc)
+                    payload.copyTo = args.cc;
+                if (args?.subject)
+                    payload.subject = args.subject;
+                if (args?.body)
+                    payload.body = args.body;
+                if (args?.send_copy_to_user !== undefined)
+                    payload.sendCopyToUser = args.send_copy_to_user;
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("POST", `/invoices/${args?.invoiceId}/email`, payload), null, 2) }] };
+            }
             case "create_contact": {
                 const payload = { name: args?.name };
                 if (args?.identification)
@@ -295,6 +469,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     payload.regime = args.regime;
                 return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("POST", "/contacts", payload), null, 2) }] };
             }
+            case "update_contact": {
+                const payload = {};
+                if (args?.name)
+                    payload.name = args.name;
+                if (args?.identification)
+                    payload.identification = args.identification;
+                if (args?.email)
+                    payload.email = args.email;
+                if (args?.phone_primary)
+                    payload.phonePrimary = args.phone_primary;
+                if (args?.address)
+                    payload.address = { address: args.address };
+                if (args?.city)
+                    payload.address = { ...payload.address, city: args.city };
+                if (args?.department)
+                    payload.address = { ...payload.address, department: args.department };
+                if (args?.type)
+                    payload.type = args.type;
+                if (args?.regime)
+                    payload.regime = args.regime;
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("PUT", `/contacts/${args?.contactId}`, payload), null, 2) }] };
+            }
+            case "delete_contact":
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("DELETE", `/contacts/${args?.contactId}`), null, 2) }] };
             case "list_contacts": {
                 const params = new URLSearchParams();
                 if (args?.start)
@@ -326,6 +524,24 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     payload.type = args.type;
                 return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("POST", "/items", payload), null, 2) }] };
             }
+            case "update_item": {
+                const payload = {};
+                if (args?.name)
+                    payload.name = args.name;
+                if (args?.description)
+                    payload.description = args.description;
+                if (args?.reference)
+                    payload.reference = args.reference;
+                if (args?.price !== undefined)
+                    payload.price = [{ price: args.price }];
+                if (args?.category)
+                    payload.category = { id: args.category };
+                if (args?.tax)
+                    payload.tax = args.tax;
+                if (args?.type)
+                    payload.type = args.type;
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("PUT", `/items/${args?.itemId}`, payload), null, 2) }] };
+            }
             case "list_items": {
                 const params = new URLSearchParams();
                 if (args?.start)
@@ -350,6 +566,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     params.set("date_end", args.date_to);
                 return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("GET", `/payments?${params}`), null, 2) }] };
             }
+            case "get_payment":
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("GET", `/payments/${args?.paymentId}`), null, 2) }] };
             case "create_payment": {
                 const payload = {
                     date: args?.date,
@@ -367,6 +585,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     payload.observations = args.observations;
                 return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("POST", "/payments", payload), null, 2) }] };
             }
+            case "void_payment":
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("PUT", `/payments/${args?.paymentId}/void`, { status: "void" }), null, 2) }] };
+            case "list_categories": {
+                const params = new URLSearchParams();
+                if (args?.start)
+                    params.set("start", String(args.start));
+                if (args?.limit)
+                    params.set("limit", String(args.limit));
+                if (args?.query)
+                    params.set("query", args.query);
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("GET", `/categories?${params}`), null, 2) }] };
+            }
+            case "list_bank_accounts": {
+                const params = new URLSearchParams();
+                if (args?.start)
+                    params.set("start", String(args.start));
+                if (args?.limit)
+                    params.set("limit", String(args.limit));
+                if (args?.type)
+                    params.set("type", args.type);
+                return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("GET", `/bank-accounts?${params}`), null, 2) }] };
+            }
             case "get_company":
                 return { content: [{ type: "text", text: JSON.stringify(await alegraRequest("GET", "/company"), null, 2) }] };
             default:
@@ -395,7 +635,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.1.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.1.0",
-  "description": "MCP server for Alegra — cloud accounting for LATAM (Colombian-founded)",
+  "version": "0.2.1",
+  "description": "MCP server for Alegra \u2014 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"
 }