storno-cli 1.0.10 → 1.0.12

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 (52) hide show
  1. package/README.md +52 -4
  2. package/TOOLS.md +459 -19
  3. package/dist/server.d.ts.map +1 -1
  4. package/dist/server.js +8 -0
  5. package/dist/server.js.map +1 -1
  6. package/dist/tools/bank-accounts.d.ts.map +1 -1
  7. package/dist/tools/bank-accounts.js +35 -6
  8. package/dist/tools/bank-accounts.js.map +1 -1
  9. package/dist/tools/cash-register.d.ts +14 -0
  10. package/dist/tools/cash-register.d.ts.map +1 -0
  11. package/dist/tools/cash-register.js +183 -0
  12. package/dist/tools/cash-register.js.map +1 -0
  13. package/dist/tools/declarations.d.ts +14 -0
  14. package/dist/tools/declarations.d.ts.map +1 -0
  15. package/dist/tools/declarations.js +360 -0
  16. package/dist/tools/declarations.js.map +1 -0
  17. package/dist/tools/delivery-notes.d.ts +93 -0
  18. package/dist/tools/delivery-notes.d.ts.map +1 -1
  19. package/dist/tools/delivery-notes.js +56 -0
  20. package/dist/tools/delivery-notes.js.map +1 -1
  21. package/dist/tools/document-series.d.ts +4 -4
  22. package/dist/tools/email-templates.d.ts +19 -2
  23. package/dist/tools/email-templates.d.ts.map +1 -1
  24. package/dist/tools/email-templates.js +18 -9
  25. package/dist/tools/email-templates.js.map +1 -1
  26. package/dist/tools/invoices.d.ts.map +1 -1
  27. package/dist/tools/invoices.js +83 -0
  28. package/dist/tools/invoices.js.map +1 -1
  29. package/dist/tools/product-categories.d.ts +14 -0
  30. package/dist/tools/product-categories.d.ts.map +1 -0
  31. package/dist/tools/product-categories.js +116 -0
  32. package/dist/tools/product-categories.js.map +1 -0
  33. package/dist/tools/products.d.ts.map +1 -1
  34. package/dist/tools/products.js +52 -0
  35. package/dist/tools/products.js.map +1 -1
  36. package/dist/tools/receipts.d.ts +3 -0
  37. package/dist/tools/receipts.d.ts.map +1 -1
  38. package/dist/tools/receipts.js +37 -0
  39. package/dist/tools/receipts.js.map +1 -1
  40. package/dist/tools/recurring-invoices.d.ts +2 -2
  41. package/dist/tools/system.d.ts.map +1 -1
  42. package/dist/tools/system.js +11 -4
  43. package/dist/tools/system.js.map +1 -1
  44. package/dist/tools/telemetry.d.ts +40 -0
  45. package/dist/tools/telemetry.d.ts.map +1 -0
  46. package/dist/tools/telemetry.js +86 -0
  47. package/dist/tools/telemetry.js.map +1 -0
  48. package/dist/tools/vat-rates.d.ts +2 -8
  49. package/dist/tools/vat-rates.d.ts.map +1 -1
  50. package/dist/tools/vat-rates.js +10 -1
  51. package/dist/tools/vat-rates.js.map +1 -1
  52. package/package.json +1 -1
package/README.md CHANGED
@@ -16,7 +16,55 @@ A **Model Context Protocol (MCP) server** that exposes the entire [Storno.ro](ht
16
16
 
17
17
  ## Quick Start
18
18
 
19
- ### 1. Install
19
+ ### Hosted Server (recommended)
20
+
21
+ Storno hosts a public MCP server at **https://mcp.storno.ro/mcp** with OAuth authentication — no API keys or tokens to manage.
22
+
23
+ Visit **[mcp.storno.ro](https://mcp.storno.ro)** for setup instructions and a one-click "Add to Claude" button.
24
+
25
+ **Claude (claude.ai):**
26
+
27
+ 1. Copy the URL: `https://mcp.storno.ro/mcp`
28
+ 2. Go to [claude.ai/settings/connectors](https://claude.ai/settings/connectors)
29
+ 3. Click "Add" and paste the URL
30
+ 4. Authorize via OAuth
31
+
32
+ **Claude Code:**
33
+
34
+ ```bash
35
+ claude mcp add storno --transport http https://mcp.storno.ro/mcp
36
+ ```
37
+
38
+ **Cursor / Windsurf:**
39
+
40
+ ```json
41
+ {
42
+ "mcpServers": {
43
+ "storno": {
44
+ "url": "https://mcp.storno.ro/mcp"
45
+ }
46
+ }
47
+ }
48
+ ```
49
+
50
+ **Claude Desktop:**
51
+
52
+ ```json
53
+ {
54
+ "mcpServers": {
55
+ "storno": {
56
+ "command": "npx",
57
+ "args": ["-y", "mcp-remote", "https://mcp.storno.ro/mcp"]
58
+ }
59
+ }
60
+ }
61
+ ```
62
+
63
+ ### Self-hosted / Token-based Setup
64
+
65
+ If you prefer to use a JWT token directly (e.g. for self-hosted Storno instances):
66
+
67
+ #### 1. Install
20
68
 
21
69
  ```bash
22
70
  npm install -g storno-cli
@@ -24,7 +72,7 @@ npm install -g storno-cli
24
72
 
25
73
  Or use directly with `npx` — no install needed.
26
74
 
27
- ### 2. Configure for Claude Code
75
+ #### 2. Configure for Claude Code
28
76
 
29
77
  Add to your project's `.claude/settings.json` or global `~/.claude/settings.json`:
30
78
 
@@ -43,7 +91,7 @@ Add to your project's `.claude/settings.json` or global `~/.claude/settings.json
43
91
  }
44
92
  ```
45
93
 
46
- ### 3. Configure for Cursor
94
+ #### 3. Configure for Cursor
47
95
 
48
96
  Add to `.cursor/mcp.json`:
49
97
 
@@ -62,7 +110,7 @@ Add to `.cursor/mcp.json`:
62
110
  }
63
111
  ```
64
112
 
65
- ### 4. Configure for Claude Desktop
113
+ #### 4. Configure for Claude Desktop
66
114
 
67
115
  Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
68
116