@engramx/mcp 0.16.0-rc.14 → 0.16.0-rc.15

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 +12 -12
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -10,7 +10,7 @@ EngramX speaks MCP from two places, and installing the wrong one is the most com
10
10
  |---|---|---|
11
11
  | Where it runs | On-chain, at the engram's `/mcp` HTTPS endpoint | On the machine the agent runs on, spawned over stdin/stdout |
12
12
  | Credential | OAuth 2.1 bearer token, installed once (an agent connected by sign-in) | The Ed25519 key for this engram, on disk (a paired agent) |
13
- | Install | Nothing to install — point the MCP client at the URL | `npx @engramx/mcp@0.16.0-rc.14` |
13
+ | Install | Nothing to install — point the MCP client at the URL | `npx @engramx/mcp@0.16.0-rc.15` |
14
14
  | Tools | 10 | 19 |
15
15
  | Has money tools | No — payment vouchers are signed with a client-held key, which a canister cannot hold ⟨corrected 2026-09-30: no voucher is signed; paying is a ledger approval plus a call made as the buyer's own key, which a canister cannot make on the agent's behalf⟩ | Yes |
16
16
  | Docs | [engramx.ai/docs](https://engramx.ai/docs) | this file |
@@ -19,7 +19,7 @@ EngramX speaks MCP from two places, and installing the wrong one is the most com
19
19
  package can print the config for it without starting a server:
20
20
 
21
21
  ```bash
22
- npx @engramx/mcp@0.16.0-rc.14 connect --canister xxxxx-xxxxx-xxxxx-xxxxx-xxx
22
+ npx @engramx/mcp@0.16.0-rc.15 connect --canister xxxxx-xxxxx-xxxxx-xxxxx-xxx
23
23
  ```
24
24
 
25
25
  That prints the engram's remote MCP URL plus per-client setup for 14 supported MCP clients (11
@@ -44,12 +44,12 @@ tools, the profile/session helpers, or a client-held key you control.
44
44
  ## Prerequisites
45
45
 
46
46
  - Node.js >= 22.12 (inherited from `@engramx/client`, which this package depends on)
47
- - An engram your agent is paired with (the key for this engram, from `npx @engramx/client@0.16.0-rc.14 pair`)
47
+ - An engram your agent is paired with (the key for this engram, from `npx @engramx/client@0.16.0-rc.15 pair`)
48
48
 
49
49
  ## Quick Start
50
50
 
51
51
  ```bash
52
- ENGRAM_CANISTER_ID=xxxxx-xxxxx-xxxxx-xxxxx-xxx npx @engramx/mcp@0.16.0-rc.14
52
+ ENGRAM_CANISTER_ID=xxxxx-xxxxx-xxxxx-xxxxx-xxx npx @engramx/mcp@0.16.0-rc.15
53
53
  ```
54
54
 
55
55
  ## Configuration
@@ -69,7 +69,7 @@ Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_
69
69
  "mcpServers": {
70
70
  "engramx": {
71
71
  "command": "npx",
72
- "args": ["@engramx/mcp@0.16.0-rc.14"],
72
+ "args": ["@engramx/mcp@0.16.0-rc.15"],
73
73
  "env": {
74
74
  "ENGRAM_CANISTER_ID": "xxxxx-xxxxx-xxxxx-xxxxx-xxx",
75
75
  "ENGRAM_SESSION_KEY_PATH": "/Users/you/.engramx/session.key"
@@ -88,7 +88,7 @@ Add to `.cursor/mcp.json` in your project root:
88
88
  "mcpServers": {
89
89
  "engramx": {
90
90
  "command": "npx",
91
- "args": ["@engramx/mcp@0.16.0-rc.14"],
91
+ "args": ["@engramx/mcp@0.16.0-rc.15"],
92
92
  "env": {
93
93
  "ENGRAM_CANISTER_ID": "xxxxx-xxxxx-xxxxx-xxxxx-xxx",
94
94
  "ENGRAM_SESSION_KEY_PATH": "/Users/you/.engramx/session.key"
@@ -106,7 +106,7 @@ from mcp.client.stdio import stdio_client
106
106
 
107
107
  server = StdioServerParameters(
108
108
  command="npx",
109
- args=["@engramx/mcp@0.16.0-rc.14"],
109
+ args=["@engramx/mcp@0.16.0-rc.15"],
110
110
  env={
111
111
  "ENGRAM_CANISTER_ID": "xxxxx-xxxxx-xxxxx-xxxxx-xxx",
112
112
  "ENGRAM_SESSION_KEY_PATH": "/path/to/session.key",
@@ -125,7 +125,7 @@ Any MCP-compatible client can spawn the server over stdio:
125
125
  ```bash
126
126
  ENGRAM_CANISTER_ID=xxxxx-xxxxx-xxxxx-xxxxx-xxx \
127
127
  ENGRAM_SESSION_KEY_PATH=/path/to/session.key \
128
- npx @engramx/mcp@0.16.0-rc.14
128
+ npx @engramx/mcp@0.16.0-rc.15
129
129
  ```
130
130
 
131
131
  The server communicates over stdin/stdout using the MCP protocol. Set environment variables for authentication.
@@ -215,7 +215,7 @@ what else the credential carries.
215
215
  2. Generate an agent invite in the engram dashboard
216
216
  3. Pair your agent:
217
217
  ```bash
218
- npx @engramx/client@0.16.0-rc.14 pair <invite-code> --engram <canister-id>
218
+ npx @engramx/client@0.16.0-rc.15 pair <invite-code> --engram <canister-id>
219
219
  ```
220
220
  ⟨2026-10-03⟩ Every pairing command in this README names the package and the version it ships
221
221
  with. Before, it called the globally installed `engramx` command, which runs whatever version is
@@ -231,7 +231,7 @@ Point the published server at a local replica:
231
231
  ```bash
232
232
  ENGRAM_CANISTER_ID=<local-canister-id> \
233
233
  ENGRAM_HOST=http://localhost:4943 \
234
- npx @engramx/mcp@0.16.0-rc.14
234
+ npx @engramx/mcp@0.16.0-rc.15
235
235
  ```
236
236
 
237
237
  ⟨2026-09-30: this section began with building the server from a clone of its source, and the
@@ -241,7 +241,7 @@ came out; the published package is all you need to run or test the server.⟩
241
241
  Inspect with the MCP Inspector:
242
242
 
243
243
  ```bash
244
- npx @modelcontextprotocol/inspector -- npx @engramx/mcp@0.16.0-rc.14
244
+ npx @modelcontextprotocol/inspector -- npx @engramx/mcp@0.16.0-rc.15
245
245
  ```
246
246
 
247
247
  ## Troubleshooting
@@ -250,7 +250,7 @@ npx @modelcontextprotocol/inspector -- npx @engramx/mcp@0.16.0-rc.14
250
250
  The server exits with a clear error. Set the environment variable to your engram canister ID.
251
251
 
252
252
  **The key for this engram was not found**
253
- Generate one with `npx @engramx/client@0.16.0-rc.14 pair`. The default path is `~/.engramx/session.key`. Override with `ENGRAM_SESSION_KEY_PATH`.
253
+ Generate one with `npx @engramx/client@0.16.0-rc.15 pair`. The default path is `~/.engramx/session.key`. Override with `ENGRAM_SESSION_KEY_PATH`.
254
254
 
255
255
  **Canister unreachable**
256
256
  Check that `ENGRAM_HOST` is correct (default: `https://ic0.app` for mainnet). For local development, use `http://localhost:4943`. Verify network connectivity.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@engramx/mcp",
3
- "version": "0.16.0-rc.14",
3
+ "version": "0.16.0-rc.15",
4
4
  "description": "MCP server for EngramX — persistent, decentralized agent memory",
5
5
  "license": "Apache-2.0",
6
6
  "author": "EngramX <developer@engramx.ai>",
@@ -16,7 +16,7 @@
16
16
  "access": "public"
17
17
  },
18
18
  "dependencies": {
19
- "@engramx/client": "^0.16.0-rc.14",
19
+ "@engramx/client": "^0.16.0-rc.15",
20
20
  "@icp-sdk/core": "^6.1.0",
21
21
  "@modelcontextprotocol/sdk": "^1.32.1",
22
22
  "zod": "^4.6.5"