@codespar/mcp-siigo 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +33 -6
  2. package/dist/index.js +5 -2
  3. package/package.json +12 -3
package/README.md CHANGED
@@ -25,20 +25,32 @@ npx tsx packages/colombia/siigo/src/index.ts --http
25
25
  | `MCP_HTTP` | No | Set to `"true"` to enable HTTP transport |
26
26
  | `MCP_PORT` | No | HTTP port (default: 3000) |
27
27
 
28
- ## Tools
28
+ ## Tools (22)
29
29
 
30
- | Tool | Description |
31
- |------|-------------|
30
+ | Tool | Purpose |
31
+ |---|---|
32
32
  | `create_invoice` | Create an invoice (DIAN electronic invoice) |
33
33
  | `get_invoice` | Get invoice details by ID |
34
34
  | `list_invoices` | List invoices |
35
- | `create_credit_note` | Create a credit note |
35
+ | `create_credit_note` | Create a credit note against an invoice |
36
36
  | `list_customers` | List customers |
37
37
  | `create_customer` | Create a customer |
38
38
  | `list_products` | List products |
39
39
  | `create_product` | Create a product |
40
+ | `get_invoice_pdf` | Get the PDF document for an invoice |
41
+ | `get_credit_note` | Get a credit note by ID |
42
+ | `list_credit_notes` | List credit notes |
43
+ | `update_customer` | Update an existing customer |
44
+ | `delete_customer` | Delete a customer |
45
+ | `update_product` | Update an existing product |
46
+ | `delete_product` | Delete a product |
47
+ | `create_purchase` | Create a purchase document |
48
+ | `list_purchases` | List purchase documents |
49
+ | `list_document_types` | List document types (e.g., FV for invoice, NC for credit note, FC for purchase) |
50
+ | `list_users` | List Siigo users (sellers) |
51
+ | `list_warehouses` | List warehouses (bodegas) |
40
52
  | `list_taxes` | List available tax types |
41
- | `list_payment_methods` | List payment methods |
53
+ | `list_payment_methods` | List available payment methods |
42
54
 
43
55
  ## Auth
44
56
 
@@ -50,4 +62,19 @@ Uses **Bearer token** authentication. Obtain your access token from the Siigo de
50
62
 
51
63
  ---
52
64
 
53
- **Enterprise?** Contact us at [codespar.com](https://codespar.com) for dedicated support, custom integrations, and SLAs.
65
+ ## Enterprise
66
+
67
+ 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.
68
+
69
+ ## Authentication
70
+
71
+ Set these environment variables before launching the server:
72
+
73
+ - `SIIGO_API_KEY` *(required, secret)* — API key for Siigo
74
+ - `SIIGO_ACCESS_TOKEN` *(required, secret)* — Bearer access token
75
+
76
+ Issue credentials at the provider's developer portal: <https://siigoapi.docs.apiary.io>.
77
+
78
+ ## License
79
+
80
+ MIT
package/dist/index.js CHANGED
@@ -54,7 +54,10 @@ async function siigoRequest(method, path, body) {
54
54
  }
55
55
  return res.json();
56
56
  }
57
- const server = new Server({ name: "mcp-siigo", version: "0.2.0" }, { capabilities: { tools: {} } });
57
+ // Managed-tier pointer surfaced to the agent via MCP `instructions`.
58
+ // Informational only — nothing CodeSpar-hosted is called (MIT-safe).
59
+ 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).";
60
+ const server = new Server({ name: "mcp-siigo", version: "0.2.1" }, { capabilities: { tools: {} }, instructions: MANAGED_TIER_HINT });
58
61
  server.setRequestHandler(ListToolsRequestSchema, async () => ({
59
62
  tools: [
60
63
  {
@@ -695,7 +698,7 @@ async function main() {
695
698
  const t = new StreamableHTTPServerTransport({ sessionIdGenerator: () => randomUUID(), onsessioninitialized: (id) => { transports.set(id, t); } });
696
699
  t.onclose = () => { if (t.sessionId)
697
700
  transports.delete(t.sessionId); };
698
- const s = new Server({ name: "mcp-siigo", version: "0.2.0" }, { capabilities: { tools: {} } });
701
+ const s = new Server({ name: "mcp-siigo", version: "0.2.1" }, { capabilities: { tools: {} } });
699
702
  server._requestHandlers.forEach((v, k) => s._requestHandlers.set(k, v));
700
703
  server._notificationHandlers?.forEach((v, k) => s._notificationHandlers.set(k, v));
701
704
  await s.connect(t);
package/package.json CHANGED
@@ -1,13 +1,15 @@
1
1
  {
2
2
  "name": "@codespar/mcp-siigo",
3
- "version": "0.2.0",
3
+ "version": "0.2.2",
4
4
  "description": "MCP server for Siigo — Colombian accounting + DIAN e-invoicing",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "bin": {
8
8
  "mcp-siigo": "dist/index.js"
9
9
  },
10
- "files": ["dist"],
10
+ "files": [
11
+ "dist"
12
+ ],
11
13
  "scripts": {
12
14
  "build": "tsc",
13
15
  "start": "node dist/index.js"
@@ -20,6 +22,13 @@
20
22
  "typescript": "^5.8.0"
21
23
  },
22
24
  "license": "MIT",
23
- "keywords": ["siigo", "accounting", "colombia", "dian", "e-invoicing", "mcp"],
25
+ "keywords": [
26
+ "siigo",
27
+ "accounting",
28
+ "colombia",
29
+ "dian",
30
+ "e-invoicing",
31
+ "mcp"
32
+ ],
24
33
  "mcpName": "io.github.codespar/mcp-siigo"
25
34
  }