@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.
- package/README.md +33 -6
- package/dist/index.js +5 -2
- 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 |
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
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.
|
|
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": [
|
|
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": [
|
|
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
|
}
|