@limetry/mcp 0.0.0-stage → 1.2.52

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 (2) hide show
  1. package/README.md +53 -2
  2. package/package.json +42 -4
package/README.md CHANGED
@@ -1,3 +1,54 @@
1
- # Temporary Holding Version
1
+ # `@limetry/mcp`
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ MCP server for Limetry **agent action governance**: evaluate ActionIntents, record outcomes,
4
+ list privacy-safe audit events, and upsert action policies.
5
+
6
+ ## Quickstart
7
+
8
+ 1. Run a Limetry governance server (`yarn dev:server` from the monorepo root).
9
+ 2. Point the MCP host at this package with `LIMETRY_BEARER_TOKEN` and `LIMETRY_BASE_URL`.
10
+ 3. Ask the agent to call `limetry_evaluate` before irreversible tool calls; enforce deny in the loop.
11
+ 4. Call `limetry_record_action` after execute/skip/block.
12
+
13
+ > [!NOTE]
14
+ > Evaluate uses the **full** intent for policy matching. Audit stores a **privacy-safe record**
15
+ > (`audit_mode=minimal` by default). Do **not** put API keys, passwords, or chat transcripts in
16
+ > `metadata` / `details`. `limetry_record_action` runs client-side `redactDetails` before POST;
17
+ > the server also minimizes. See [Data minimization](https://limetry.org/docs/server/data-minimization).
18
+
19
+ ## Tools
20
+
21
+ | Tool | Purpose |
22
+ | --- | --- |
23
+ | `limetry_evaluate` | Allow / deny / wait + reasons + signed receipt |
24
+ | `limetry_record_action` | Scrubbed `action.recorded` event |
25
+ | `limetry_list_audit` | List recent privacy-safe audit rows |
26
+ | `limetry_upsert_policy` | Create/update ActionPolicy (`auditMode` supported) |
27
+
28
+ ## Run from source
29
+
30
+ `@limetry/mcp` may not be published to npm yet. From a checkout:
31
+
32
+ ```bash
33
+ yarn build:sdk && yarn workspace @limetry/mcp build
34
+ node packages/mcp/dist/index.js
35
+ ```
36
+
37
+ Cursor / Claude config example:
38
+
39
+ ```json
40
+ {
41
+ "mcpServers": {
42
+ "limetry": {
43
+ "command": "node",
44
+ "args": ["/absolute/path/to/limetry/packages/mcp/dist/index.js"],
45
+ "env": {
46
+ "LIMETRY_BEARER_TOKEN": "your-bearer-token",
47
+ "LIMETRY_BASE_URL": "http://localhost:3810"
48
+ }
49
+ }
50
+ }
51
+ }
52
+ ```
53
+
54
+ When the package is published, `npx -y @limetry/mcp` can replace the `node …/dist/index.js` command.
package/package.json CHANGED
@@ -1,6 +1,44 @@
1
1
  {
2
2
  "name": "@limetry/mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "1.2.52",
4
+ "description": "MCP server for Limetry agent action governance and telemetry",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "bin": {
8
+ "limetry-mcp": "dist/index.js"
9
+ },
10
+ "main": "./dist/index.js",
11
+ "files": [
12
+ "dist"
13
+ ],
14
+ "publishConfig": {
15
+ "access": "public",
16
+ "registry": "https://registry.npmjs.org"
17
+ },
18
+ "repository": {
19
+ "type": "git",
20
+ "url": "git+https://github.com/limetry/limetry.git",
21
+ "directory": "packages/mcp"
22
+ },
23
+ "scripts": {
24
+ "prepack": "node ../../scripts/rewrite-workspace-protocol.mjs prepare",
25
+ "postpack": "node ../../scripts/rewrite-workspace-protocol.mjs restore-after-pack",
26
+ "postpublish": "node ../../scripts/rewrite-workspace-protocol.mjs restore",
27
+ "build": "tsc",
28
+ "dev": "tsc --watch",
29
+ "start": "node dist/index.js",
30
+ "typecheck": "yarn run -T tsgo -p tsconfig.json --noEmit"
31
+ },
32
+ "dependencies": {
33
+ "@limetry/sdk": "^1.2.52",
34
+ "@modelcontextprotocol/sdk": "^1.30.0",
35
+ "zod": "^4.5.4"
36
+ },
37
+ "devDependencies": {
38
+ "@types/node": "^22.20.2",
39
+ "typescript": "^5.8.2"
40
+ },
41
+ "engines": {
42
+ "node": ">=20"
43
+ }
44
+ }