memcastleCAUTION
🧠 An AI memory service inspired by MemPalace 🏰
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
Local-first, always-on memory server for AI coding agents over MCP/HTTP
Running several AI coding agents (OpenCode, Claude Code, Cursor, ...) side by side usually means each one gets its own, disconnected memory — or none at all. MemCastle is a single daemon per palace (the memory store that one or more of your projects share) that all of them talk to over MCP or HTTP, so a mining run, a search, or a saved decision from one agent is immediately visible to every other agent and to the CLI. Everything lives in one SurrealDB store, embedded by default, so there is no external service to run.
flowchart LR A[OpenCode] & B[Claude Code] & C[Other MCP clients] -->|MCP| D CLI[memcastle CLI] -->|REST| D D[memcastle daemon] --> E[(Palace: SurrealDB)]
Installation
brew install noirbizarre/homebrew-tap/memcastle # macOS paru -S memcastle-bin # Arch Linux (AUR)
Or download a binary for your platform from the [latest re
74305b6be695OBSERVED · 2026-10-11Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add memcastle-web --env MEMCASTLE_AUTH_TOKEN=${MEMCASTLE_AUTH_TOKEN} -- npx -y [email protected]{
"mcpServers": {
"memcastle-web": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"MEMCASTLE_AUTH_TOKEN": "${MEMCASTLE_AUTH_TOKEN}"
}
}
}
}Exposed tools (3)
3 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
dir | read | this directory |
ok | read | Does: a thing. Use it. |
since | read | from this date |
Trust audit
CAUTIONgrade C · trust 70/100 Install with care. The audit found things worth knowing before you trust its output.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | WARN |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (6 observation(s))
- Network
- declared (3 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- found
Findings (25)
await createCore({ token: "mc_super-secret-token-value" }, log, {})await (await plugin.server(input, { token: "mc_super-secret-token-value" })).dispose?.()const settings = resolveSettings({ token: "mc_super-secret-token-value" }, {})const fake = fakeContext({ token: "mc_super-secret-token-value" })const settings = resolveSettings({ token: "mc_super-secret-token-value" }, {})synthetic-export.zip
image.bin
.markdownlint-cli2.yaml
.keep
import { submitCheckpoint } from "../../pi/src/checkpoint-core.ts"import { submitCheckpoint } from "../../pi/src/checkpoint-core.ts"import { discoverDaemon } from "../../../pi/src/daemon-client.ts"import { createSession } from "../../../pi/src/mcp-manager.ts"import type { ModeLabel } from "../../../pi/src/modes.ts"Connect an MCP client to `http://127.0.0.1:8420/mcp`:
claude mcp add --transport http memcastle http://127.0.0.1:8420/mcp # Claude Code
"url": "http://127.0.0.1:8420/mcp",
endpoint http://127.0.0.1:8420 (from the daemon's registry file)
mcp http://127.0.0.1:8420/mcp
@types/bun, typescript
@types/bun, typescript
@modelcontextprotocol/sdk, @opencode-ai/plugin, smol-toml, @opencode/plugin, @types/bun, typescript
@earendil-works/pi-mcp, smol-toml, @types/bun, typescript
@openvue/themes, cytoscape, openvue, vue, vue-router, @types/bun, @types/cytoscape, @types/node
in which case send `Authorization: Bearer <token>` as a header on the server.
Gates applied: no_behavioural_pass.
74305b6be695full audit observations/trust-audit/mcp-server/noirbizarre__memcastle.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-11 | 74305b6be695 | CAUTION | C | 70 | first audit |
Questions
What is the memcastle MCP server?
🧠 An AI memory service inspired by MemPalace 🏰
What tools does memcastle expose?
3 in total: 3 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is memcastle safe to connect to an agent?
With care. The audit graded it C (70/100) and found 25 things worth knowing before you trust this server, listed below with the exact line each was found on.
What credentials does memcastle need?
It reads MEMCASTLE_AUTH_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does memcastle run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on npm as memcastle-web at 0.0.0.
How current is this page?
The grade is for one exact copy of the source (74305b6be695), read on 2026-10-11. The repository is watched and re-audited when it changes.