@vumasign/mcp 0.3.2 → 0.3.3

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 (4) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +41 -3
  3. package/dist/meta.js +1 -1
  4. package/package.json +2 -2
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Vumasign (Pty) Ltd
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # @vumasign/mcp
2
2
 
3
+ [![npm](https://img.shields.io/npm/v/@vumasign/mcp)](https://www.npmjs.com/package/@vumasign/mcp) [![licence](https://img.shields.io/npm/l/@vumasign/mcp)](./LICENSE) [![node](https://img.shields.io/node/v/@vumasign/mcp)](https://www.npmjs.com/package/@vumasign/mcp)
4
+
3
5
  An MCP server for a Vumasign account. An agent can read your templates, their pages and the core
4
6
  vocabulary with your organisation’s own keys,
5
7
  check the values it means to fill in, and create **draft** envelopes. A person reviews each draft in
@@ -8,9 +10,39 @@ Vumasign and sends it.
8
10
  It never sends an envelope, never mints a signing URL, never names a field freely, never creates a
9
11
  template and never touches a webhook. There is no tool for any of them.
10
12
 
11
- Three tools change a template, and exist only when `VUMASIGN_MCP_ALLOW_TEMPLATE_WRITES=1` is set:
12
- `request_naming`, `accept_naming` and `accept_person`. They accept Vumasign’s own naming of a
13
- template and nothing of the agent’s, and need a live key that also names `templates:name`.
13
+ The tools that change a template exist only when `VUMASIGN_MCP_ALLOW_TEMPLATE_WRITES=1` is set. They
14
+ accept Vumasign’s own naming of a template and nothing of the agent’s.
15
+
16
+ ## Tools
17
+
18
+ <!-- tools:start (generated by scripts/readme-tools.ts, do not edit) -->
19
+
20
+ | Tool | What it does |
21
+ | --- | --- |
22
+ | `list_templates` | List templates |
23
+ | `get_template` | Get a template |
24
+ | `get_vocabulary` | Get the vocabulary |
25
+ | `get_template_page` | Get one page of a template document |
26
+ | `get_template_document` | Get a whole template document |
27
+ | `get_template_field_map` | Get a template document with its fields numbered on it |
28
+ | `validate_values` | Check values against a template |
29
+ | `get_envelope` | Get an envelope |
30
+ | `create_envelope_draft` | Create a draft envelope |
31
+ | `get_naming_run` | Read a naming run |
32
+ | `get_template_people` | Get the people on a template |
33
+
34
+ Only with `VUMASIGN_MCP_ALLOW_TEMPLATE_WRITES=1`, and a live key that also names `templates:name`:
35
+
36
+ | Tool | What it does |
37
+ | --- | --- |
38
+ | `request_naming` | Ask Vumasign to name a template |
39
+ | `accept_naming` | Accept a naming run |
40
+ | `accept_person` | Accept Vumasign’s proposal for one person |
41
+
42
+ <!-- tools:end -->
43
+
44
+ Parameters, examples and setup for each client are in the
45
+ [guide](https://docs.vumasign.com/guides/agents-and-mcp).
14
46
 
15
47
  ## Use
16
48
 
@@ -36,6 +68,8 @@ The guide, with setup for Claude Code, Claude Desktop and Cursor and the full li
36
68
 
37
69
  ## Develop
38
70
 
71
+ The source is maintained in Vumasign’s private repository, so the Repository link on npm is not public. Questions and issues go through [docs.vumasign.com](https://docs.vumasign.com).
72
+
39
73
  The source is in `src/` and the tests in `test/`. Inside the Vumasign repository the package resolves
40
74
  its dependencies from the repository root, and the root `npm test` runs `test/` too.
41
75
 
@@ -46,3 +80,7 @@ npm run build # writes dist/
46
80
  ```
47
81
 
48
82
  Releasing is described in `docs/deployment/mcp-package.md` in the repository.
83
+
84
+ ## Licence
85
+
86
+ MIT. See [LICENSE](./LICENSE).
package/dist/meta.js CHANGED
@@ -1,6 +1,6 @@
1
1
  /** The package's name and version, which `test/package.test.ts` holds equal to `package.json`. */
2
2
  export const PACKAGE_NAME = '@vumasign/mcp';
3
- export const VERSION = '0.3.2';
3
+ export const VERSION = '0.3.3';
4
4
  /** The command `npx` runs, from `bin` in `package.json`. */
5
5
  export const BIN_NAME = 'vumasign-mcp';
6
6
  export const USER_AGENT = `${PACKAGE_NAME}/${VERSION}`;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vumasign/mcp",
3
- "version": "0.3.2",
3
+ "version": "0.3.3",
4
4
  "description": "MCP server for a Vumasign account: read templates and their pages, check values, and create draft envelopes that a person sends. It never sends and never mints a signing URL.",
5
5
  "keywords": [
6
6
  "mcp",
@@ -14,7 +14,7 @@
14
14
  "url": "git+https://github.com/HelloCrowd/Vumasign.git",
15
15
  "directory": "mcp"
16
16
  },
17
- "license": "UNLICENSED",
17
+ "license": "MIT",
18
18
  "type": "module",
19
19
  "engines": {
20
20
  "node": ">=20"