@hvgllc/hvgerp-mcp 3.4.0 → 3.6.0

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 CHANGED
@@ -5,8 +5,8 @@
5
5
  [![MCP](https://img.shields.io/badge/MCP-server-1f6feb?logo=modelcontextprotocol&logoColor=white)](https://modelcontextprotocol.io)
6
6
  [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
7
7
 
8
- MCP server for [ERPNext](https://erpnext.com) / Frappe ERP — **131 tools**
9
- across **16 categories**, with **7 interactive UI viewers**.
8
+ MCP server for [ERPNext](https://erpnext.com) / Frappe ERP: **135 tools** across
9
+ **16 categories**, with **7 interactive UI viewers**.
10
10
 
11
11
  Connect any MCP-compatible AI agent (Claude Desktop, Claude Code, VS Code
12
12
  Copilot, custom) to your ERPNext instance via the
@@ -223,11 +223,12 @@ npm install
223
223
  node build-all.mjs
224
224
  ```
225
225
 
226
- ## Tools (131)
226
+ ## Tools (135)
227
227
 
228
- 131 tools across 16 categories. Each `_list` tool returns interactive results
228
+ 135 tools across 16 categories. Most `_list` tools return interactive results
229
229
  via the doclist-viewer with row click, inline detail, and cross-viewer
230
- navigation.
230
+ navigation. The read-only `erpnext_stock_ledger_list` instead returns bounded
231
+ ledger rows for the stock viewer's Recent Movements panel.
231
232
 
232
233
  - **Identity** (2) — `erpnext_whoami` (who the server believes the caller is:
233
234
  User id, roles, linked Employee, and whether the connection is per-caller or a
@@ -239,15 +240,22 @@ navigation.
239
240
  CRUD, Submit, and Cancel.
240
241
  - **Purchasing** (11) — Suppliers, Purchase Orders, Purchase Invoices, Receipts,
241
242
  and Supplier Quotations.
242
- - **Inventory** (9) — Items, Stock Balance, Warehouses, and Stock Entries.
243
+ - **Inventory** (10): Items, Stock Balance, Warehouses, Stock Entries, and
244
+ recent Stock Ledger Entries filtered by the required item and warehouse.
243
245
  - **Accounting** (8) — Chart of Accounts (filterable by `disabled`), Journal
244
246
  Entries, and Payment Entries, plus `erpnext_gl_entry_list` (the posted general
245
247
  ledger, cancelled entries excluded by default) and `erpnext_financial_report`,
246
248
  which runs a standard financial report (Profit and Loss Statement, Balance
247
249
  Sheet, General Ledger, Trial Balance…) from a closed allowlist and never
248
250
  queues a Prepared Report.
249
- - **HR** (12) — Employees, Attendance, Leave Applications, Salary Slips, Payroll
250
- Entries, and Expense Claims.
251
+ - **HR** (15) — Employees, Attendance, Leave Applications, Salary Slips, Payroll
252
+ Entries, and Expense Claims, plus attendance repair:
253
+ `erpnext_employee_checkin_list` (the raw punch log, where a day that never
254
+ closed shows up), `erpnext_attendance_day_get` and
255
+ `erpnext_attendance_day_fix`, which add the missing punches and rebuild that
256
+ day's Attendance even when the existing record is already submitted. The last
257
+ two need the `hvg_workspace` app on the site, because the day is recomputed by
258
+ the site's own rule rather than by a copy of it living here.
251
259
  - **Project** (9) — Projects, Tasks (with native assignment), and Timesheets.
252
260
  - **Delivery** (5) — Delivery Notes and Shipments.
253
261
  - **Manufacturing** (7) — BOMs, Work Orders, and Job Cards.
@@ -278,6 +286,7 @@ Full per-tool reference with parameters: [`docs/tools.md`](docs/tools.md).
278
286
  | `ERPNEXT_API_KEY` | stdio | API Key from User Settings. Over HTTP, leave it unset and let each caller's own token decide who the server acts as (see _Caller identity_) |
279
287
  | `ERPNEXT_API_SECRET` | stdio | API Secret from User Settings |
280
288
  | `MCP_CALLER_IDENTITY` | No | `required` \| `optional` \| `off`. HTTP only. Defaults to `required` when no API key/secret is set, `off` when they are |
289
+ | `MCP_EVENTS_ENABLED` | No | Off by default. Turns on MCP Events for calendar meetings (HTTP, per-user OAuth only). See [docs/mcp-events-meetings.md](docs/mcp-events-meetings.md) |
281
290
  | `ERPNEXT_MAX_UPLOAD_BYTES` | No | Maximum decoded file-upload size in bytes (positive integer; default: 10 MiB) |
282
291
  | `ERPNEXT_METHOD_ALLOWLIST` | No | Comma-separated dotted paths or `prefix.*` patterns that `erpnext_method_call` may invoke. Unset means no extra restriction beyond the API key's own ERPNext permissions |
283
292
  | `MCP_MRTR_SIGNING_KEY` | No | Exactly 64 lowercase hex characters; enables signed ambiguous-link elicitation. **Single-instance deployments only** — see below |