@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.
- package/README.md +12 -12
- 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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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"
|