@engramx/mcp 0.16.0-rc.11 → 0.16.0-rc.13
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 +19 -15
- package/dist/connect.js +20 -40
- package/dist/connect.js.map +1 -1
- package/dist/profile-tools.js +4 -8
- package/dist/profile-tools.js.map +1 -1
- package/dist/server.js +12 -8
- package/dist/server.js.map +1 -1
- package/dist/tools.js +11 -13
- package/dist/tools.js.map +1 -1
- package/package.json +2 -4
- package/dist/connect-config.d.ts +0 -76
- package/dist/connect-config.js +0 -207
- package/dist/connect-config.js.map +0 -1
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` |
|
|
13
|
+
| Install | Nothing to install — point the MCP client at the URL | `npx @engramx/mcp@0.16.0-rc.13` |
|
|
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 connect --canister xxxxx-xxxxx-xxxxx-xxxxx-xxx
|
|
22
|
+
npx @engramx/mcp@0.16.0-rc.13 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.13 pair`)
|
|
48
48
|
|
|
49
49
|
## Quick Start
|
|
50
50
|
|
|
51
51
|
```bash
|
|
52
|
-
ENGRAM_CANISTER_ID=xxxxx-xxxxx-xxxxx-xxxxx-xxx npx @engramx/mcp
|
|
52
|
+
ENGRAM_CANISTER_ID=xxxxx-xxxxx-xxxxx-xxxxx-xxx npx @engramx/mcp@0.16.0-rc.13
|
|
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"],
|
|
72
|
+
"args": ["@engramx/mcp@0.16.0-rc.13"],
|
|
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"],
|
|
91
|
+
"args": ["@engramx/mcp@0.16.0-rc.13"],
|
|
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"],
|
|
109
|
+
args=["@engramx/mcp@0.16.0-rc.13"],
|
|
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
|
|
128
|
+
npx @engramx/mcp@0.16.0-rc.13
|
|
129
129
|
```
|
|
130
130
|
|
|
131
131
|
The server communicates over stdin/stdout using the MCP protocol. Set environment variables for authentication.
|
|
@@ -142,7 +142,7 @@ behind the catalog; the source is private during the beta, so it names none.⟩
|
|
|
142
142
|
| Tool | Parameters | Description |
|
|
143
143
|
|------|-----------|-------------|
|
|
144
144
|
| `engram_read_memory` | `path` | Read one memory file by exact path — content, version, timestamp |
|
|
145
|
-
| `engram_append_memory` | `path`, `content`, `source?` | Append to a memory file (created if missing). Returns the write receipt `{path, version, seq, head}` — `head` is the
|
|
145
|
+
| `engram_append_memory` | `path`, `content`, `source?` | Append to a memory file (created if missing). Returns the write receipt `{path, version, seq, head}` — `head` is the memory file's chain head after this write, and is what you hand a verifier. It is not the audit-chain head: this write's audit-log entry records it, and the certified audit head covers that entry ⟨2026-10-13: this called `head` the audit-chain head⟩ |
|
|
146
146
|
| `engram_list_memory_files` | _(none)_ | List all memory files (paths, versions, timestamps — no content) |
|
|
147
147
|
| `engram_read_memory_batch` | `paths` | Read up to 50 files in one call; per-file success or error |
|
|
148
148
|
| `engram_memory_history` | `path` | Version history of one file — commitments and eviction disclosures, not content |
|
|
@@ -164,7 +164,9 @@ claim; it records it in the record beside your principal, which makes a false on
|
|
|
164
164
|
| `engram_confirm_job` | `jobId` | **SPENDS.** Irreversibly releases escrow to the seller (BuyerConfirm services) |
|
|
165
165
|
| `engram_dispute_job` | `jobId`, `reason` | Blocks payout on a completed job instead of releasing it |
|
|
166
166
|
|
|
167
|
-
`engram_list_services` and `engram_get_job_result` also exist on the remote surface.
|
|
167
|
+
`engram_list_services` and `engram_get_job_result` also exist on the remote surface. ⟨2026-10-13: no
|
|
168
|
+
longer — they left the remote surface, where they could only refuse (services and jobs live on the
|
|
169
|
+
market); all five commerce tools are stdio-only.⟩ The three
|
|
168
170
|
money tools — `submit_service_request`, `confirm_job`, `dispute_job` — are **stdio-only, and
|
|
169
171
|
structurally so**: submitting signs a payment voucher with the key the agent holds, and the
|
|
170
172
|
canister cannot sign as the buyer.
|
|
@@ -207,11 +209,13 @@ what else the credential carries.
|
|
|
207
209
|
|
|
208
210
|
## Pairing Your Agent (the key for this engram)
|
|
209
211
|
|
|
210
|
-
1. Create an engram at [engramx.ai](https://engramx.ai) or via the CLI
|
|
212
|
+
1. Create an engram at [engramx.ai](https://engramx.ai) ⟨2026-10-13: it said "or via the CLI"; creating
|
|
213
|
+
an engram from the CLI was retired on 2026-10-05 — a person creates one on the set-up page, an agent
|
|
214
|
+
opens its own with `open-engram`⟩
|
|
211
215
|
2. Generate an agent invite in the engram dashboard
|
|
212
216
|
3. Pair your agent:
|
|
213
217
|
```bash
|
|
214
|
-
npx @engramx/client@0.16.0-rc.
|
|
218
|
+
npx @engramx/client@0.16.0-rc.13 pair <invite-code> --engram <canister-id>
|
|
215
219
|
```
|
|
216
220
|
⟨2026-10-03⟩ Every pairing command in this README names the package and the version it ships
|
|
217
221
|
with. Before, it called the globally installed `engramx` command, which runs whatever version is
|
|
@@ -227,7 +231,7 @@ Point the published server at a local replica:
|
|
|
227
231
|
```bash
|
|
228
232
|
ENGRAM_CANISTER_ID=<local-canister-id> \
|
|
229
233
|
ENGRAM_HOST=http://localhost:4943 \
|
|
230
|
-
npx @engramx/mcp
|
|
234
|
+
npx @engramx/mcp@0.16.0-rc.13
|
|
231
235
|
```
|
|
232
236
|
|
|
233
237
|
⟨2026-09-30: this section began with building the server from a clone of its source, and the
|
|
@@ -237,7 +241,7 @@ came out; the published package is all you need to run or test the server.⟩
|
|
|
237
241
|
Inspect with the MCP Inspector:
|
|
238
242
|
|
|
239
243
|
```bash
|
|
240
|
-
npx @modelcontextprotocol/inspector -- npx @engramx/mcp
|
|
244
|
+
npx @modelcontextprotocol/inspector -- npx @engramx/mcp@0.16.0-rc.13
|
|
241
245
|
```
|
|
242
246
|
|
|
243
247
|
## Troubleshooting
|
|
@@ -246,7 +250,7 @@ npx @modelcontextprotocol/inspector -- npx @engramx/mcp
|
|
|
246
250
|
The server exits with a clear error. Set the environment variable to your engram canister ID.
|
|
247
251
|
|
|
248
252
|
**The key for this engram was not found**
|
|
249
|
-
Generate one with `npx @engramx/client@0.16.0-rc.
|
|
253
|
+
Generate one with `npx @engramx/client@0.16.0-rc.13 pair`. The default path is `~/.engramx/session.key`. Override with `ENGRAM_SESSION_KEY_PATH`.
|
|
250
254
|
|
|
251
255
|
**Canister unreachable**
|
|
252
256
|
Check that `ENGRAM_HOST` is correct (default: `https://ic0.app` for mainnet). For local development, use `http://localhost:4943`. Verify network connectivity.
|
package/dist/connect.js
CHANGED
|
@@ -1,10 +1,13 @@
|
|
|
1
1
|
// `npx @engramx/mcp connect` — print ready-to-use config for connecting any MCP client to an
|
|
2
2
|
// engram's remote MCP endpoint, and optionally write the Claude Desktop config file. Uses the
|
|
3
|
-
// shared connect-config module (connect-config
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
3
|
+
// shared connect-config module (`@engramx/client/connect-config`) so every consumer emits identical
|
|
4
|
+
// config.
|
|
5
|
+
//
|
|
6
|
+
// ⟨2026-10-13, the bloat audit⟩ The config generator moved into @engramx/client, and `--write` uses
|
|
7
|
+
// the client's one writer (`installMcpConfig`: atomic, and it refuses a config it cannot parse);
|
|
8
|
+
// this file's own writer and per-OS path went with the merge (claude-setup.ts says what had drifted).
|
|
9
|
+
import { connectInfo } from '@engramx/client/connect-config';
|
|
10
|
+
import { claudeConfigPaths, installMcpConfig } from '@engramx/client';
|
|
8
11
|
import { VERSION } from './version.js';
|
|
9
12
|
function parseFlags(argv) {
|
|
10
13
|
const f = {};
|
|
@@ -24,47 +27,24 @@ function parseFlags(argv) {
|
|
|
24
27
|
}
|
|
25
28
|
return f;
|
|
26
29
|
}
|
|
27
|
-
/**
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
case 'win32':
|
|
34
|
-
return join(process.env['APPDATA'] || join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
|
|
35
|
-
default:
|
|
36
|
-
return join(home, '.config', 'Claude', 'claude_desktop_config.json');
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
/** Merge the engramx server into an existing claude_desktop_config.json without clobbering others. */
|
|
40
|
-
function writeClaudeDesktopConfig(path, p) {
|
|
41
|
-
let existing = {};
|
|
42
|
-
if (existsSync(path)) {
|
|
43
|
-
try {
|
|
44
|
-
existing = JSON.parse(readFileSync(path, 'utf-8'));
|
|
45
|
-
}
|
|
46
|
-
catch {
|
|
47
|
-
throw new Error(`${path} exists but is not valid JSON — fix or remove it, then retry.`);
|
|
48
|
-
}
|
|
49
|
-
}
|
|
50
|
-
existing.mcpServers = existing.mcpServers || {};
|
|
51
|
-
existing.mcpServers.engramx = claudeDesktopConfig(p).mcpServers.engramx;
|
|
52
|
-
mkdirSync(dirname(path), { recursive: true });
|
|
53
|
-
writeFileSync(path, JSON.stringify(existing, null, 2) + '\n');
|
|
54
|
-
}
|
|
30
|
+
/**
|
|
31
|
+
* ⟨2026-10-13⟩ Names this tool at its own version (`npx @engramx/mcp@<version> connect …`); it said the
|
|
32
|
+
* bare `npx @engramx/mcp connect …` until then, which runs npm's `latest` — the last final release,
|
|
33
|
+
* the previous one while a release candidate soaks. version.ts says why this package's own version.
|
|
34
|
+
*/
|
|
35
|
+
const USAGE = `Usage: npx @engramx/mcp@${VERSION} connect --canister <id> [--host <url>] [--write [path]]`;
|
|
55
36
|
export async function runConnect(argv) {
|
|
56
37
|
const f = parseFlags(argv);
|
|
57
38
|
if (f['help'] || f['h']) {
|
|
58
|
-
console.log(
|
|
39
|
+
console.log(USAGE);
|
|
59
40
|
return;
|
|
60
41
|
}
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
process.env['VAULT_CANISTER_ID'];
|
|
42
|
+
// ⟨2026-10-13⟩ The retired VAULT_CANISTER_ID alias is gone (server.ts says why).
|
|
43
|
+
const canisterId = f['canister'] || process.env['ENGRAM_CANISTER_ID'];
|
|
64
44
|
const host = f['host'] || process.env['ENGRAM_HOST'] || 'https://icp0.io';
|
|
65
45
|
if (!canisterId) {
|
|
66
46
|
console.error('Error: --canister <id> (or ENGRAM_CANISTER_ID) is required.');
|
|
67
|
-
console.error(
|
|
47
|
+
console.error(USAGE);
|
|
68
48
|
process.exit(2);
|
|
69
49
|
}
|
|
70
50
|
// The pairing commands in the guides name this tool's own version (the packages share one).
|
|
@@ -80,8 +60,8 @@ export async function runConnect(argv) {
|
|
|
80
60
|
console.log(` ${line}`);
|
|
81
61
|
}
|
|
82
62
|
if (f['write']) {
|
|
83
|
-
const path = typeof f['write'] === 'string' ? f['write'] :
|
|
84
|
-
|
|
63
|
+
const path = typeof f['write'] === 'string' ? f['write'] : claudeConfigPaths().claudeDesktop;
|
|
64
|
+
installMcpConfig(path, { canisterId, host, version: VERSION });
|
|
85
65
|
console.log(`\n✓ Wrote the engramx MCP server to ${path}. Restart Claude Desktop to load it.`);
|
|
86
66
|
}
|
|
87
67
|
else {
|
package/dist/connect.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,8FAA8F;AAC9F,
|
|
1
|
+
{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"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"}
|
package/dist/profile-tools.js
CHANGED
|
@@ -7,16 +7,12 @@ function jsonText(value) {
|
|
|
7
7
|
* Render what a save actually did.
|
|
8
8
|
*
|
|
9
9
|
* The ProfileManager/SessionManager methods hand back the write RECEIPT as of the 2026-08-16
|
|
10
|
-
* canister release,
|
|
11
|
-
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
* COMMITTED; `head` is the hex audit-chain head after the write, the value the agent hands a
|
|
15
|
-
* third party who wants to verify it without trusting the agent.
|
|
10
|
+
* canister release, and throw on every failure. `saved` here means COMMITTED; `head` is the hex
|
|
11
|
+
* audit-chain head after the write, the value the agent hands a third party who wants to verify it
|
|
12
|
+
* without trusting the agent. ⟨2026-10-13, the owner's 4A⟩ The `{saved: false, queued: true}` arm
|
|
13
|
+
* for a null receipt went with the SDK's offline queue.
|
|
16
14
|
*/
|
|
17
15
|
function saveResult(receipt, extra = {}) {
|
|
18
|
-
if (receipt === null)
|
|
19
|
-
return { saved: false, queued: true, ...extra };
|
|
20
16
|
return { saved: true, version: receipt.version, seq: receipt.seq, head: receipt.head, ...extra };
|
|
21
17
|
}
|
|
22
18
|
// MCP ToolAnnotations for the profile/session convenience tools. These have no entry in
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"profile-tools.js","sourceRoot":"","sources":["../src/profile-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxD,CAAC;AAED
|
|
1
|
+
{"version":3,"file":"profile-tools.js","sourceRoot":"","sources":["../src/profile-tools.ts"],"names":[],"mappings":"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"}
|
package/dist/server.js
CHANGED
|
@@ -10,20 +10,22 @@ import { HttpAgent } from '@icp-sdk/core/agent';
|
|
|
10
10
|
import { registerTools } from './tools.js';
|
|
11
11
|
import { registerProfileTools } from './profile-tools.js';
|
|
12
12
|
import { registerResources } from './resources.js';
|
|
13
|
-
import { pairCommand } from '
|
|
13
|
+
import { pairCommand } from '@engramx/client/connect-config';
|
|
14
14
|
import { VERSION } from './version.js';
|
|
15
15
|
// --- Environment variables ---
|
|
16
|
-
|
|
16
|
+
// ⟨2026-10-13⟩ ENGRAM_* names only. The retired pre-launch VAULT_CANISTER_ID / VAULT_SESSION_KEY_PATH
|
|
17
|
+
// aliases and the undocumented second session-key name ENGRAMX_SESSION_KEY_PATH went in the bloat
|
|
18
|
+
// audit: no doc names them and nothing in this repo, the platform or the Medivox checkouts sets them
|
|
19
|
+
// (the same class as the Vault* export aliases removed 2026-08-17).
|
|
20
|
+
const canisterId = process.env['ENGRAM_CANISTER_ID'];
|
|
17
21
|
if (!canisterId) {
|
|
18
22
|
console.error('Error: ENGRAM_CANISTER_ID environment variable is required.\n' +
|
|
19
23
|
'Set it to your engram canister ID (e.g. "xxxxx-xxxxx-xxxxx-xxxxx-xxx").\n' +
|
|
20
|
-
'
|
|
24
|
+
// ⟨2026-10-13⟩ At this server's own version; it named the bare package until then.
|
|
25
|
+
`To connect a client instead, run: npx @engramx/mcp@${VERSION} connect --canister <id>`);
|
|
21
26
|
process.exit(1);
|
|
22
27
|
}
|
|
23
|
-
const sessionKeyPath = process.env['ENGRAM_SESSION_KEY_PATH'] ||
|
|
24
|
-
process.env['ENGRAMX_SESSION_KEY_PATH'] ||
|
|
25
|
-
process.env['VAULT_SESSION_KEY_PATH'] ||
|
|
26
|
-
join(homedir(), '.engramx', 'session.key');
|
|
28
|
+
const sessionKeyPath = process.env['ENGRAM_SESSION_KEY_PATH'] || join(homedir(), '.engramx', 'session.key');
|
|
27
29
|
if (!existsSync(sessionKeyPath)) {
|
|
28
30
|
console.error(`Error: the key for this engram was not found at ${sessionKeyPath}.\n` +
|
|
29
31
|
`Generate one with: ${pairCommand(VERSION, '<invite-code>', '<canister-id>')}`);
|
|
@@ -71,7 +73,9 @@ const market = marketCanisterId
|
|
|
71
73
|
marketCanisterId)
|
|
72
74
|
: null;
|
|
73
75
|
// --- MCP Server ---
|
|
74
|
-
|
|
76
|
+
// ⟨2026-10-13⟩ The server announces this package's own version. It said a hard-coded '0.1.0' until
|
|
77
|
+
// then, while every command it prints already named VERSION. Held by test/server-version.test.ts.
|
|
78
|
+
const server = new McpServer({ name: 'engramx', version: VERSION }, {
|
|
75
79
|
instructions: 'engramx gives this agent persistent memory in a user-owned canister (an engram) plus an ic402 paid-services marketplace. Agent sessions are APPEND-ONLY: memory can be read and appended to, never overwritten or deleted. Memory flow: engram_list_memory_files (discover paths) -> engram_read_memory or engram_read_memory_batch (fetch content) -> engram_append_memory (add content; memory.append scope; config/ and secrets/ paths are owner-only). engram_memory_history shows prior versions of one file; engram_read_audit_log shows the record of this engram: all of it to the owner or a guardian, only its own entries to an agent, with a count of those withheld. Free reads: engram_status and engram_list_services. engram_wallet_balance reports canister cycles (infrastructure fuel), NOT token money. MONEY: engram_submit_service_request SPENDS ckUSDC (settles a payment at the quoted service price into escrow at submit time) and engram_confirm_job irreversibly releases that escrow to the seller; call these only when the user intends to pay. engram_dispute_job blocks payout instead. engram_get_job_result is a free read.',
|
|
76
80
|
});
|
|
77
81
|
const profile = new ProfileManager(engram);
|
package/dist/server.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,yFAAyF;AAEzF,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
|
package/dist/tools.js
CHANGED
|
@@ -128,7 +128,13 @@ market = null) {
|
|
|
128
128
|
// are append-only. Owner uses the dashboard at engramx.ai or the canister IDL
|
|
129
129
|
// directly via Internet Identity.)
|
|
130
130
|
// 2. engram_append_memory
|
|
131
|
-
|
|
131
|
+
// ⟨2026-10-13⟩ The description called head "the hex audit-chain head". It is the memory file's own
|
|
132
|
+
// chain head after the write (src/ledgerfs/Chain.mo `commit`); the write's audit-log entry records
|
|
133
|
+
// it (`receiptSuffix` in src/engram/main.mo), and the certified audit head (getCertifiedAuditHead)
|
|
134
|
+
// and the registry's anchor cover that entry. Neither equals head, so a verifier told to compare
|
|
135
|
+
// them saw a mismatch that is not a defect. tool-schemas.json, the canister's HTTP catalog, already
|
|
136
|
+
// said it right. test/tools.test.ts holds these words.
|
|
137
|
+
server.tool('engram_append_memory', 'Append text to a memory file; the file is created if it does not exist. APPEND-ONLY: never overwrites or deletes, and this is the ONLY mutating memory tool on this surface (no write/delete/rollback exists here). Requires the memory.append scope (agent with canAppendMemory, or owner). Rejected: config/ and secrets/ paths (owner-only), owner-protected paths, and while guardian writes are paused. Returns JSON {path, version, seq, head} — the write receipt: version is the file version after this write, seq its position in the engram event sequence, and head the hex chain head of this memory file after this write. head is not the audit-chain head: it is recorded in the audit-log entry for this write, which the certified audit head and the registry anchor cover, so it is what you hand a third party who wants to verify this write without trusting you.', {
|
|
132
138
|
path: z
|
|
133
139
|
.string()
|
|
134
140
|
.describe(`Target file path to append to; created if absent. Max ${MAX_PATH_LENGTH} characters, no ".."; agents cannot use the config/ or secrets/ prefixes (owner-only).`),
|
|
@@ -144,19 +150,11 @@ market = null) {
|
|
|
144
150
|
if (pathErr)
|
|
145
151
|
return { content: [{ type: 'text', text: pathErr }], isError: true };
|
|
146
152
|
try {
|
|
147
|
-
// The SDK returns the RECEIPT
|
|
148
|
-
//
|
|
149
|
-
//
|
|
150
|
-
//
|
|
151
|
-
// describing an outcome no configuration of this server can produce is the fabrication
|
|
152
|
-
// class this product refuses. Surfacing `head` is the point — it is what an agent hands
|
|
153
|
-
// a verifier.
|
|
153
|
+
// The SDK returns the write RECEIPT, and throws on every failure. Surfacing `head` is the
|
|
154
|
+
// point — it is what an agent hands a verifier. ⟨2026-10-13, the owner's 4A⟩ The `queued`
|
|
155
|
+
// branch for a null receipt went with the SDK's offline queue, which this server never
|
|
156
|
+
// configured.
|
|
154
157
|
const receipt = await engram.appendMemory(path, content, source);
|
|
155
|
-
if (receipt === null) {
|
|
156
|
-
return {
|
|
157
|
-
content: [{ type: 'text', text: jsonText({ path, queued: true }) }],
|
|
158
|
-
};
|
|
159
|
-
}
|
|
160
158
|
return {
|
|
161
159
|
content: [
|
|
162
160
|
{
|
package/dist/tools.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,12 +1,10 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@engramx/mcp",
|
|
3
|
-
"version": "0.16.0-rc.
|
|
3
|
+
"version": "0.16.0-rc.13",
|
|
4
4
|
"description": "MCP server for EngramX — persistent, decentralized agent memory",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"author": "EngramX <developer@engramx.ai>",
|
|
7
7
|
"type": "module",
|
|
8
|
-
"main": "dist/index.js",
|
|
9
|
-
"types": "dist/index.d.ts",
|
|
10
8
|
"bin": {
|
|
11
9
|
"engramx-mcp": "./dist/index.js"
|
|
12
10
|
},
|
|
@@ -18,7 +16,7 @@
|
|
|
18
16
|
"access": "public"
|
|
19
17
|
},
|
|
20
18
|
"dependencies": {
|
|
21
|
-
"@engramx/client": "^0.16.0-rc.
|
|
19
|
+
"@engramx/client": "^0.16.0-rc.13",
|
|
22
20
|
"@icp-sdk/core": "^6.1.0",
|
|
23
21
|
"@modelcontextprotocol/sdk": "^1.32.1",
|
|
24
22
|
"zod": "^4.6.5"
|
package/dist/connect-config.d.ts
DELETED
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
export interface ConnectParams {
|
|
2
|
-
canisterId: string;
|
|
3
|
-
/** IC gateway host. Defaults to mainnet (icp0.io). Local replica: http://localhost:4943 */
|
|
4
|
-
host?: string;
|
|
5
|
-
}
|
|
6
|
-
export declare const MAINNET_HOST = "https://icp0.io";
|
|
7
|
-
/** What a surface that prints the per-client guides passes: the engram, and the build's version. */
|
|
8
|
-
export interface GuideParams extends ConnectParams {
|
|
9
|
-
/**
|
|
10
|
-
* The @engramx/client version the surface printing these guides was BUILT with — its own
|
|
11
|
-
* package.json's version, which the release's version change stamps (X.Y.Z-rc.N while a release
|
|
12
|
-
* candidate soaks, X.Y.Z once the final release is cut). Every pairing command in the guides
|
|
13
|
-
* names it.
|
|
14
|
-
*/
|
|
15
|
-
clientVersion: string;
|
|
16
|
-
}
|
|
17
|
-
/**
|
|
18
|
-
* The pairing command, pinned to the version the surface printing it was built with.
|
|
19
|
-
*
|
|
20
|
-
* WHY (the owner's ruling of 2026-10-03: print the exact version each page was built with).
|
|
21
|
-
* A bare `npx @engramx/client pair …` installs npm's default (`latest`), which is the last FINAL
|
|
22
|
-
* release: while a release candidate soaks under the `next` tag, every surface built from it would
|
|
23
|
-
* hand out a command that installs the previous release, and a previous release cannot pair with
|
|
24
|
-
* this release's engram (the 0.15.0 → 0.16.0 enrolment change). Pinned to the build's own version,
|
|
25
|
-
* the command names the final version once the final release is cut — through that release's own
|
|
26
|
-
* version change, with nothing to undo. WHAT WOULD MAKE THIS WRONG: a surface that prints the guides
|
|
27
|
-
* for a different release than the one it was built from (then `clientVersion` must be that
|
|
28
|
-
* release's), or a published version being withdrawn from npm (a pinned command then fails loudly,
|
|
29
|
-
* where a bare one would quietly install another release).
|
|
30
|
-
*/
|
|
31
|
-
export declare function pairCommand(clientVersion: string, inviteCode: string, canisterId: string): string;
|
|
32
|
-
/** The remote MCP endpoint URL for an engram canister (boundary-node subdomain routing). */
|
|
33
|
-
export declare function mcpUrl({ canisterId, host }: ConnectParams): string;
|
|
34
|
-
/** Claude Desktop / Cursor STDIO server entry (local @engramx/mcp, session-key auth). */
|
|
35
|
-
export declare function stdioServerConfig({ canisterId, host }: ConnectParams): {
|
|
36
|
-
command: string;
|
|
37
|
-
args: string[];
|
|
38
|
-
env: Record<string, string>;
|
|
39
|
-
};
|
|
40
|
-
/** The claude_desktop_config.json fragment with the engramx server under mcpServers. */
|
|
41
|
-
export declare function claudeDesktopConfig(p: ConnectParams): {
|
|
42
|
-
mcpServers: {
|
|
43
|
-
engramx: {
|
|
44
|
-
command: string;
|
|
45
|
-
args: string[];
|
|
46
|
-
env: Record<string, string>;
|
|
47
|
-
};
|
|
48
|
-
};
|
|
49
|
-
};
|
|
50
|
-
export interface ClientGuide {
|
|
51
|
-
id: string;
|
|
52
|
-
name: string;
|
|
53
|
-
/** 'remote' = canister-hosted HTTP MCP + OAuth; 'stdio' = local @engramx/mcp + session key */
|
|
54
|
-
transport: 'remote' | 'stdio';
|
|
55
|
-
steps: string[];
|
|
56
|
-
/** Optional copy-paste install snippet (CLI command, YAML, or JSON). */
|
|
57
|
-
snippet?: string;
|
|
58
|
-
}
|
|
59
|
-
/** Per-client connection guides — identical wording in the CLI and the web page. */
|
|
60
|
-
export declare function clientGuides(p: GuideParams): ClientGuide[];
|
|
61
|
-
/** Everything a consumer needs in one call. */
|
|
62
|
-
export declare function connectInfo(p: GuideParams): {
|
|
63
|
-
canisterId: string;
|
|
64
|
-
host: string;
|
|
65
|
-
mcpUrl: string;
|
|
66
|
-
claudeDesktopConfig: {
|
|
67
|
-
mcpServers: {
|
|
68
|
-
engramx: {
|
|
69
|
-
command: string;
|
|
70
|
-
args: string[];
|
|
71
|
-
env: Record<string, string>;
|
|
72
|
-
};
|
|
73
|
-
};
|
|
74
|
-
};
|
|
75
|
-
guides: ClientGuide[];
|
|
76
|
-
};
|
package/dist/connect-config.js
DELETED
|
@@ -1,207 +0,0 @@
|
|
|
1
|
-
// Canonical config generation for connecting AI clients (Claude.ai web, Claude Desktop, Cursor, …)
|
|
2
|
-
// to an engram's remote MCP endpoint. Used by the `@engramx/mcp connect` CLI.
|
|
3
|
-
//
|
|
4
|
-
// Dependency-free and free of Node/browser-only APIs so any consumer (this CLI, or a web UI) can
|
|
5
|
-
// import it unchanged. The contract test (connect-config.test.ts) pins the output — downstream UIs
|
|
6
|
-
// that re-render this config should reuse this module + that test so every surface stays identical.
|
|
7
|
-
//
|
|
8
|
-
// ⟨2026-10-03⟩ Every pairing command this module prints names the exact @engramx/client version the
|
|
9
|
-
// surface printing it was built with (`npx @engramx/client@<version> pair …`), so the caller passes
|
|
10
|
-
// that version in (`GuideParams.clientVersion`): this module cannot read a package.json and stay
|
|
11
|
-
// usable in a browser. This CLI passes its own package.json's version; a web UI passes the version
|
|
12
|
-
// it was built with. See `pairCommand` below for why.
|
|
13
|
-
export const MAINNET_HOST = 'https://icp0.io';
|
|
14
|
-
/**
|
|
15
|
-
* The pairing command, pinned to the version the surface printing it was built with.
|
|
16
|
-
*
|
|
17
|
-
* WHY (the owner's ruling of 2026-10-03: print the exact version each page was built with).
|
|
18
|
-
* A bare `npx @engramx/client pair …` installs npm's default (`latest`), which is the last FINAL
|
|
19
|
-
* release: while a release candidate soaks under the `next` tag, every surface built from it would
|
|
20
|
-
* hand out a command that installs the previous release, and a previous release cannot pair with
|
|
21
|
-
* this release's engram (the 0.15.0 → 0.16.0 enrolment change). Pinned to the build's own version,
|
|
22
|
-
* the command names the final version once the final release is cut — through that release's own
|
|
23
|
-
* version change, with nothing to undo. WHAT WOULD MAKE THIS WRONG: a surface that prints the guides
|
|
24
|
-
* for a different release than the one it was built from (then `clientVersion` must be that
|
|
25
|
-
* release's), or a published version being withdrawn from npm (a pinned command then fails loudly,
|
|
26
|
-
* where a bare one would quietly install another release).
|
|
27
|
-
*/
|
|
28
|
-
export function pairCommand(clientVersion, inviteCode, canisterId) {
|
|
29
|
-
return `npx @engramx/client@${clientVersion} pair ${inviteCode} --engram ${canisterId}`;
|
|
30
|
-
}
|
|
31
|
-
function isLocal(host) {
|
|
32
|
-
return host.includes('localhost') || host.includes('127.0.0.1');
|
|
33
|
-
}
|
|
34
|
-
/** The remote MCP endpoint URL for an engram canister (boundary-node subdomain routing). */
|
|
35
|
-
export function mcpUrl({ canisterId, host = MAINNET_HOST }) {
|
|
36
|
-
if (isLocal(host))
|
|
37
|
-
return `http://${canisterId}.localhost:4943/mcp`;
|
|
38
|
-
return `https://${canisterId}.icp0.io/mcp`;
|
|
39
|
-
}
|
|
40
|
-
/** Claude Desktop / Cursor STDIO server entry (local @engramx/mcp, session-key auth). */
|
|
41
|
-
export function stdioServerConfig({ canisterId, host = MAINNET_HOST }) {
|
|
42
|
-
const env = { ENGRAM_CANISTER_ID: canisterId };
|
|
43
|
-
// Only pin a non-default host (e.g. local replica); mainnet is the @engramx/mcp default.
|
|
44
|
-
if (host !== MAINNET_HOST && host !== 'https://ic0.app')
|
|
45
|
-
env['ENGRAM_HOST'] = host;
|
|
46
|
-
return { command: 'npx', args: ['-y', '@engramx/mcp'], env };
|
|
47
|
-
}
|
|
48
|
-
/** The claude_desktop_config.json fragment with the engramx server under mcpServers. */
|
|
49
|
-
export function claudeDesktopConfig(p) {
|
|
50
|
-
return { mcpServers: { engramx: stdioServerConfig(p) } };
|
|
51
|
-
}
|
|
52
|
-
/** Per-client connection guides — identical wording in the CLI and the web page. */
|
|
53
|
-
export function clientGuides(p) {
|
|
54
|
-
const url = mcpUrl(p);
|
|
55
|
-
const pair = pairCommand(p.clientVersion, '<invite-code>', p.canisterId);
|
|
56
|
-
return [
|
|
57
|
-
{
|
|
58
|
-
id: 'claude-web',
|
|
59
|
-
name: 'Claude (claude.ai)',
|
|
60
|
-
transport: 'remote',
|
|
61
|
-
steps: [
|
|
62
|
-
'Open claude.ai → Settings → Connectors → Add custom connector.',
|
|
63
|
-
`Paste the MCP URL: ${url}`,
|
|
64
|
-
'Sign in with the wallet that owns this engram, then approve.',
|
|
65
|
-
'Your engram tools (read/append/list memory, audit log, wallet) appear in new chats.',
|
|
66
|
-
],
|
|
67
|
-
},
|
|
68
|
-
{
|
|
69
|
-
id: 'claude-code',
|
|
70
|
-
name: 'Claude Code (CLI)',
|
|
71
|
-
transport: 'remote',
|
|
72
|
-
snippet: `claude mcp add engramx-memory ${url}`,
|
|
73
|
-
steps: [
|
|
74
|
-
'Run the command, then restart claude-code — OAuth opens in your browser on first use.',
|
|
75
|
-
],
|
|
76
|
-
},
|
|
77
|
-
{
|
|
78
|
-
id: 'claude-desktop',
|
|
79
|
-
name: 'Claude Desktop (remote)',
|
|
80
|
-
transport: 'remote',
|
|
81
|
-
steps: [
|
|
82
|
-
'Claude Desktop → Settings → Connectors → Add custom connector.',
|
|
83
|
-
`Paste the MCP URL: ${url}`,
|
|
84
|
-
'Authorize with your wallet.',
|
|
85
|
-
],
|
|
86
|
-
},
|
|
87
|
-
{
|
|
88
|
-
id: 'cursor',
|
|
89
|
-
name: 'Cursor',
|
|
90
|
-
transport: 'remote',
|
|
91
|
-
steps: [
|
|
92
|
-
'Cursor → Settings → MCP → Add new MCP server.',
|
|
93
|
-
`Paste the remote URL ${url}; the OAuth flow opens in your browser.`,
|
|
94
|
-
],
|
|
95
|
-
},
|
|
96
|
-
{
|
|
97
|
-
id: 'copilot',
|
|
98
|
-
name: 'GitHub Copilot (VS Code, agent mode)',
|
|
99
|
-
transport: 'remote',
|
|
100
|
-
snippet: `{\n "servers": {\n "engramx-memory": { "type": "http", "url": "${url}" }\n }\n}`,
|
|
101
|
-
steps: [
|
|
102
|
-
'VS Code → Command Palette → "MCP: Add Server" → HTTP → paste the URL; or add the JSON above to .vscode/mcp.json (workspace) or your user mcp.json.',
|
|
103
|
-
'Open Copilot Chat in Agent mode and authorize with the wallet that owns this engram; your engram tools appear in the tool picker.',
|
|
104
|
-
'Note: the GitHub Copilot CLI is a separate surface (gh copilot) — this flow is for Copilot Chat in VS Code.',
|
|
105
|
-
],
|
|
106
|
-
},
|
|
107
|
-
{
|
|
108
|
-
id: 'continue',
|
|
109
|
-
name: 'Continue.dev',
|
|
110
|
-
transport: 'remote',
|
|
111
|
-
snippet: `mcpServers:\n - name: engramx-memory\n transport: streamable-http\n url: ${url}`,
|
|
112
|
-
steps: ['Add this YAML to .continue/mcpServers/engramx.yaml.'],
|
|
113
|
-
},
|
|
114
|
-
{
|
|
115
|
-
id: 'chatgpt',
|
|
116
|
-
name: 'ChatGPT (developer mode)',
|
|
117
|
-
transport: 'remote',
|
|
118
|
-
steps: [
|
|
119
|
-
'ChatGPT → Settings → Apps & Connectors → enable Developer mode → New connector.',
|
|
120
|
-
`Add the MCP server URL: ${url}, then authorize with the wallet that owns this engram.`,
|
|
121
|
-
'Web + paid tiers only (Plus/Pro/Business); the desktop/mobile apps and free tier cannot add a custom MCP.',
|
|
122
|
-
'Our connector handshake with ChatGPT is still being verified — if the authorize step fails, seed via a paste prompt for now.',
|
|
123
|
-
],
|
|
124
|
-
},
|
|
125
|
-
{
|
|
126
|
-
id: 'gemini-cli',
|
|
127
|
-
name: 'Gemini CLI',
|
|
128
|
-
transport: 'remote',
|
|
129
|
-
snippet: `gemini mcp add --transport http engramx-memory ${url}`,
|
|
130
|
-
steps: [
|
|
131
|
-
'Run the command, then restart gemini-cli.',
|
|
132
|
-
'If the OAuth handshake misbehaves, add an auth header (the key for this engram) or use the local stdio proxy instead.',
|
|
133
|
-
'The consumer Gemini app has no custom-MCP support — use gemini-cli, or seed the app’s Saved Info via a paste prompt.',
|
|
134
|
-
],
|
|
135
|
-
},
|
|
136
|
-
{
|
|
137
|
-
id: 'grok',
|
|
138
|
-
name: 'Grok',
|
|
139
|
-
transport: 'remote',
|
|
140
|
-
steps: [
|
|
141
|
-
'Grok → Settings → Connectors → Bring your own MCP → add a custom connector.',
|
|
142
|
-
`Paste the MCP URL: ${url} and authorize. Paid tier.`,
|
|
143
|
-
],
|
|
144
|
-
},
|
|
145
|
-
{
|
|
146
|
-
id: 'perplexity',
|
|
147
|
-
name: 'Perplexity',
|
|
148
|
-
transport: 'remote',
|
|
149
|
-
steps: [
|
|
150
|
-
'Perplexity → Settings → Connectors → Add → Custom MCP (Pro / Max / Enterprise).',
|
|
151
|
-
`Paste the remote URL: ${url}; authorize with your wallet.`,
|
|
152
|
-
],
|
|
153
|
-
},
|
|
154
|
-
{
|
|
155
|
-
id: 'lechat',
|
|
156
|
-
name: 'Mistral Le Chat',
|
|
157
|
-
transport: 'remote',
|
|
158
|
-
steps: [
|
|
159
|
-
'Le Chat → + Add Connector → Custom MCP.',
|
|
160
|
-
`Name it "engramx" and paste the server URL: ${url}. Available on all tiers, including free.`,
|
|
161
|
-
],
|
|
162
|
-
},
|
|
163
|
-
{
|
|
164
|
-
id: 'openclaw',
|
|
165
|
-
name: 'OpenClaw (self-hosted)',
|
|
166
|
-
transport: 'stdio',
|
|
167
|
-
snippet: pair,
|
|
168
|
-
steps: [
|
|
169
|
-
'Run the command; it auto-detects OpenClaw and installs the engramx memory plugin.',
|
|
170
|
-
'The engram becomes OpenClaw’s memory backend — it reads at session start and syncs new memories automatically.',
|
|
171
|
-
'Get <invite-code> from the engram’s owner — you, if this is your engram — who creates it under Access → Agents; it works for thirty minutes.',
|
|
172
|
-
],
|
|
173
|
-
},
|
|
174
|
-
{
|
|
175
|
-
id: 'sdk',
|
|
176
|
-
name: 'Your own agent (@engramx/client SDK)',
|
|
177
|
-
transport: 'stdio',
|
|
178
|
-
snippet: pair,
|
|
179
|
-
steps: [
|
|
180
|
-
'Pair a key for this engram once with the command; get <invite-code> from the engram’s owner — you, if this is your engram — who creates it under Access → Agents. It works for thirty minutes.',
|
|
181
|
-
`In your agent: new EngramClient({ canisterId: '${p.canisterId}', sessionKeyPath: '~/.engramx/session.key' }), then startSession() to read this owner's memory back and appendMemory() as it learns.`,
|
|
182
|
-
'This grant is append-only for writes — your agent can read and add memory, and cannot delete it. Overwriting existing content requires a separate grant the owner issues deliberately, per path: only on paths the owner lists for agents, and never on paths the owner has locked.',
|
|
183
|
-
],
|
|
184
|
-
},
|
|
185
|
-
{
|
|
186
|
-
id: 'claude-desktop-stdio',
|
|
187
|
-
name: 'Claude Desktop / Cursor (local stdio)',
|
|
188
|
-
transport: 'stdio',
|
|
189
|
-
snippet: JSON.stringify(claudeDesktopConfig(p), null, 2),
|
|
190
|
-
steps: [
|
|
191
|
-
`Pair a key for this engram once: ${pair}`,
|
|
192
|
-
'Add the JSON to claude_desktop_config.json under "mcpServers", then restart the app.',
|
|
193
|
-
],
|
|
194
|
-
},
|
|
195
|
-
];
|
|
196
|
-
}
|
|
197
|
-
/** Everything a consumer needs in one call. */
|
|
198
|
-
export function connectInfo(p) {
|
|
199
|
-
return {
|
|
200
|
-
canisterId: p.canisterId,
|
|
201
|
-
host: p.host ?? MAINNET_HOST,
|
|
202
|
-
mcpUrl: mcpUrl(p),
|
|
203
|
-
claudeDesktopConfig: claudeDesktopConfig(p),
|
|
204
|
-
guides: clientGuides(p),
|
|
205
|
-
};
|
|
206
|
-
}
|
|
207
|
-
//# sourceMappingURL=connect-config.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"connect-config.js","sourceRoot":"","sources":["../src/connect-config.ts"],"names":[],"mappings":"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"}
|