mcp-server@0.10.268
CAUTION· startup onlyPublisher claims: "Explain it once. Every AI knows it. cachly keeps the rules, decisions and fixes you explain to your AI and gives them back in every session: Claude Code, Cursor, Copilot, Windsurf, Codex, Gemini CLI. Hosted in the EU." Observed in sandbox: no network, touches nothing outside the project, writes no memory.
Coverage
Startup only; authenticated tool behavior not tested.- Tested
- install scripts, with decoy credentials in place · second launch with the clock 45 days ahead · server startup over stdio (initialize sent) · every file read, file written and host contacted by what ran
- Not tested
- the tool list (the server exited before answering) · what the tools do when called with real credentials
What this means for the label: Caution here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.
Before you give it your token
- It will ask for
CLAUDE_PLUGIN_OPTION_API_KEYCOHERE_API_KEYGEMINI_API_KEYMCP_INTERNAL_SECRETMISTRAL_API_KEYOPENAI_API_KEYConfiguration, not credentials: AUS_PHRASE, CACHLY_ADMIN_KEY, CACHLY_API_TIMEOUT_MS, CACHLY_API_URL, CACHLY_AUTO_INDEX, CACHLY_BRAIN_INSTANCE_ID, CACHLY_CONFIDENCE_STALE_DAYS, CACHLY_CONFIDENCE_WARN_DAYS, CACHLY_EMBED_MODEL, CACHLY_EMBED_PROVIDER, CACHLY_EMBED_SCHREIB_PARALLEL, CACHLY_EMBED_TIMEOUT_MAX_MS, CACHLY_EMBED_TIMEOUT_MS, CACHLY_HOOK_EVENT, CACHLY_HOOK_FRIST_MS, CACHLY_JWT, CACHLY_LESER, CACHLY_LESER_ZEITLIMIT_MS, CACHLY_NO_TELEMETRY, CACHLY_PROVISION_TIMEOUT_MS, CACHLY_RECALL_NUR_LESEN, CLAUDE_PLUGIN_OPTION_INSTANCE_ID, CLAUDE_PLUGIN_ROOT, CLS_FILES, CLS_MSG, CLS_SHA, COPILOT_HOME, MCP_HTTP_PORT, OLLAMA_BASE_URL- Where it talks to
- cachly.dev (its own)Also mistral.ai, cohere.com, google.com, twitter.com — not the publisher's domain; check what for before connecting.
- What we saw when it ran
- no credential files read · no network
- What we could not test
- the tool list (the server exited before answering) · what the tools do when called with real credentials
Connect it with a scoped credential, under the guard, and read the third-party hosts first. The code names mistral.ai, cohere.com, google.com, twitter.com as well as its own vendor. The guard injects CLAUDE_PLUGIN_OPTION_API_KEY, COHERE_API_KEY, GEMINI_API_KEY, MCP_INTERNAL_SECRET, MISTRAL_API_KEY, OPENAI_API_KEY only into requests to cachly.dev (and its subdomains) and refuses the rest.
Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.
What changed since 0.10.258
vet-skills diff mcp-server 0.10.258 0.10.268This version reaches for something 0.10.258 did not: 1 new credential variable (MCP_INTERNAL_SECRET). Compared from the two recorded runs, not from source.
- New credential variables
- MCP_INTERNAL_SECRET
The guard can hold an update like this until someone approves it (runtime.on_change: hold). A change that only shows with a real credential, or on a path the run did not reach, is not in a trace and so not in this comparison.
Is [email protected] safe to install?
KillerSkills ran it in the KillerSkills honeypot sandbox (3 scenarios; startup only; authenticated tool behavior not tested) on 2026-11-22 and scored it 67/100 (Caution). It is not known to be malicious, but it has behaviour or code a security policy should decide on before install. Notable findings: Access to sensitive file paths; Access to sensitive file paths; Access to sensitive file paths. Summary: no network, touches nothing outside the project, writes no memory.
Behavior trace
Honeypot run · 36 s · 3 scenarios · 0 deviationsStatic findings
…ngify(d,null,2)}if(o==="zed"){const p=d.context_servers??{},y=p.cachly?.command?.env?.CACHLY_JWT;return y&&he(y,r),p.cachly={command:{path:"npx",args:["-y","@cachly…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…eichen",re:/[\u{E0000}-\u{E007F}\u{202A}-\u{202E}\u{2066}-\u{2069}]/u}],h="(?:\\.env\\b|\\benv\\b|\\bprintenv\\b|credentials|\\bsecrets?\\b|id_(?:rsa|ed25519|ecdsa|…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…);if(!o(n))return;const t=JSON.parse(a(n,"utf8"));return r(t.mcpServers?.cachly?.env?.CACHLY_JWT)}catch{return}}function g(e={}){const n=e.env??process.env;return r…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.<summary><b>Claude Code</b> (<code>.mcp.json</code> in the project)</summary> ```json { "mcpServers": { "cachly": { "command": "npx", "args": ["-y", "@cachly-deFix: Remove the text that addresses the agent rather than the reader; describe behavior, do not instruct.…"string"},description:'Files involved in this lesson (e.g. ["infra/deploy.sh", ".env"])'},commands:{type:"array",items:{type:"string"},description:'Commands that wo…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…(r,".mcp.json");if(C(s))try{const i=JSON.parse(j(s,"utf8"))?.mcpServers?.cachly?.env??{};if(t.apiUrl=t.apiUrl||i.CACHLY_API_URL||"https://api.cachly.dev",t.jwt=t.jw…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…erve (free, local, no key needed)"},gemini:{key:"GEMINI_API_KEY",hint:"Get at: https://aistudio.google.com/app/apikey"}},i=e[a]??e.openai,l=!!o.vector_token,u=JSON.stringify({mcpServers:{cachly:{command:"npx",args:["-y","@cachly-dev/mcp-se…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…E0F **cachly:** version ${e} is available (${s}). ${n?"Claude Code keeps plugin auto-update off for this marketplace. Turn it on once: /plugin \u2192 Marketplaces \u2192 cachly \u2192 Enable auto-update. Or update now: /plugin \u2192 Marke…Fix: Pin versions and sources; vendor anything fetched at install time.Set OPENAI_API_KEY in your .env, or switch provider:Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…f(o(d))try{const u=await n(d,"utf-8"),l=JSON.parse(u),i=l?.mcpServers?.cachly;i?.env&&(i.env.CACHLY_JWT=e,await t(d,JSON.stringify(l,null,2),"utf-8"))}catch{}}))}ca…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…tsSync as w,readFileSync as j}from"node:fs";import{readFile as v,writeFile as E,chmod as M,mkdir as N}from"node:fs/promises";import{dirname as K,resolve as l}from"nod…Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.…odeium","windsurf","mcp_config.json")].map(e=>{const r=i(e)?.mcpServers?.cachly?.env;return r&&typeof r=="object"?r:{}})}function h(...o){for(const e of o){const r=…Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.…d by a prior setup)")}}catch{}(!i||!p)&&(console.error(` Usage: npx @cachly-dev/mcp-server@latest init --instance-id <uuid> --api-key <cky_live_...> [--editor claude|cursor|windsurf|copilot|continue|cline|zed|codex|gemini] [--all-editors] …Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.…A.push("\u2139\uFE0F Hooks (session briefing, per-prompt recall) are set up by `npx @cachly-dev/mcp-server@latest init` or `autopilot`."),c.push(...A)}return c.join(` `)}case"team_assign_role":…Fix: Pin versions and sources; vendor anything fetched at install time.…existsSync as f,statSync as h}from"node:fs";import{readFile as _,writeFile as p,chmod as u,mkdir as C}from"node:fs/promises";import{basename as l,dirname as d,resolve…Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.…et(o,r==="continue"?"continue":r==="zed"?"zed":o===".vscode/mcp.json"?"vscode":"mcpServers");for(const[r,o]of n){const s=k(t.projekt,r),i=g(s);if($(`${s}.bak`)&&e.funde.push({stufe:"projekt",aktion:"melden",pfad:`${s}.bak`,was:"your old fi…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.…a.status}: ${A.slice(0,200)}`),{status:a.status,retryAfterSek:m})}return(await a.json()).embedding}case"mistral":{const r=process.env.MISTRAL_API_KEY;if(!r)throw new Error("MISTRAL_API_KEY not set");const s=c.model!=="text-embedding-3-smal…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…console.log(` This organisation has several Brains:`),v.forEach(($,E)=>console.log(` ${E+1}) ${$.name??$.id} (${$.id})`));const _=d({input:process.stdin,output:process.stdout}),R=await new Promise($=>{_.question(" Which one? [1] ",E=>{_.c…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…ok)throw new Error(`sign-in could not start (HTTP ${a.status})`);const n=await a.json();if(!n.device_code||!n.user_code)throw new Error("sign-in could not start (no device code)");return{deviceCode:n.device_code,userCode:n.user_code,adress…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.….google.com/app/apikey"}},i=e[a]??e.openai,l=!!o.vector_token,u=JSON.stringify({mcpServers:{cachly:{command:"npx",args:["-y","@cachly-dev/mcp-server@latest"],env:{CACHLY_JWT:"your-api-token-from-cachly.dev/settings",[i.key]:a==="ollama"?"h…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.…ential",status:"fail",detail:"CACHLY_JWT is not set",hint:"Run `npx @cachly-dev/mcp-server@latest autopilot` (browser sign-in) or export CACHLY_JWT=<cky_\u2026>."};const t=e.startsWith("cky_"),n=e.split(".").length===3;return!t&&!n?{name:"…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.\u26A0\uFE0F No cachly key or Brain instance found (environment or ~/.cachly/credentials.json).`),console.log(` Run: npx @cachly-dev/mcp-server@latest autopilotFix: Pin versions and sources; vendor anything fetched at install time.…Setup required**","","Run the setup wizard once in your terminal:"," ```"," npx @cachly-dev/mcp-server@latest autopilot"," ```","",`Or get your API key at: ${j("/setup-ai","ambient-signin…Fix: Pin versions and sources; vendor anything fetched at install time.…9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;function s(e){return l.test(c(e))}const a="npx @cachly-dev/mcp-server@latest claim";function u(e){return["","","---",`\u2139\uFE0F **cachly:** no API key wa…Fix: Pin versions and sources; vendor anything fetched at install time.…eturn{name:"Credential",status:"fail",detail:"CACHLY_JWT is not set",hint:"Run `npx @cachly-dev/mcp-server@latest autopilot` (browser sign-in) or export CACHLY_JWT=<cky_\u2026>."};const t=e.sta…Fix: Pin versions and sources; vendor anything fetched at install time.…is written into the project (the hook reads $CACHLY_JWT or ~/.cachly/credentials.json when it runs). Removes an older brain_watch block. Idempotent: running brain_watch twice installs the hook only once. The hook always exits 0 and runs as…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…tei:Tt,merge:e=>xt(e)})}const W=".github/hooks",Nt=".github/hooks/cachly-ambient.json",Q="cachly-ambient-copilot.mjs",Ct={sessionStart:30,userPromptSubmitted:10,postToolUse:5};function Ut(t){return U("VS Code / Copilot",st,it,t)}function A…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…if(r.status===401&&!n&&!W()&&(De=0,await Ue()))return O(e,t,!0);const d=(await r.json().catch(()=>({error:r.statusText}))).error??r.statusText;ao(r.status,d)}if(r.status!==204)return r.json()}import{handleBrainTool as kn}from"./handlers/br…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…function f(r,t=x){return i(t,`${l("sha256").update(r).digest("hex").slice(0,32)}.json`)}function v(r,t,o){if(!o){p(r,{force:!0});return}S(i(r,".."),{recursive:!0});const e={generation_id:t??null,kontext:o,at:Date.now()};b(r,JSON.stringify(…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…o never recalled score low. Returns a ranked list with visual confidence bars: "\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591 40%". Use this before a big refactor to know which lessons to trust and which t…Fix: Put hosts, commands and strings in plain source. Decoding at runtime looks identical to malware and costs points on its own.…earer ${e.jwt}`},signal:AbortSignal.timeout(n)});if(!o.ok)return;const a=await o.json();if(!Array.isArray(a?.arme))return;const r=a.arme.filter(i=>i&&Number.isInteger(i.arm)).map(i=>({arm:i.arm,erfolge:Number(i.erfolge)||0,misserfolge:Numb…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…2 Marketplaces \u2192 cachly \u2192 Update marketplace, then /reload-plugins.":"npx users: restart your editor. If your config pins a version, run `npx @cachly-dev/mcp-se…Fix: Pin versions and sources; vendor anything fetched at install time.…er ${e}`},signal:AbortSignal.timeout(8e3)});let c=0,d=0;if(r.ok){const f=await r.json();c=f.lesson_count??0,d=f.total_recall_count??0}const u=await fetch(`${x}/api/v1/brains/share`,{method:"POST",headers:{Authorization:`Bearer ${e}`,"Conte…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…=g=>g.toLocaleDateString("en-US",{month:"short",day:"numeric"});if(console.log("\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2…Fix: Put hosts, commands and strings in plain source. Decoding at runtime looks identical to malware and costs points on its own.…}...\x1B[0m`),console.log(""),console.log(" \x1B[2m\u{1F4A1} Invite your team: npx @cachly-dev/mcp-server@latest invite <email>\x1B[0m"),console.log(" \x1B[2m Cron: 0 9 * * 1 npx @cachly-de…Fix: Pin versions and sources; vendor anything fetched at install time.…ype:"string",description:"Absolute path to workspace root \u2014 enables package.json analysis for openclaw cross-promo (optional)"}},required:[]}},{name:"brain_hygiene",description:"Autonomously sweep and maintain your Brain \u2014 flags …Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…./../package.json","../package.json"])try{const n=e(t);if(n.name==="@cachly-dev/mcp-server"&&n.version)return n.version}catch{}}catch{}return"0.10.100"})(),xo=Number(process.env.CACHLY_PROVISION_TIMEOUT_MS??9e4);let P=Ee(process.env.CACHLY…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.… turns recorded"),n(" To keep your lessons first, write them to disk:"),n(" npx @cachly-dev/mcp-server@latest export")}function q(t,e,n){n.ausgabe(""),n.ausgabe(t);for(const r of e)n.ausgab…Fix: Pin versions and sources; vendor anything fetched at install time.…_MODEL??"",H=(()=>{try{const e=yo(import.meta.url);for(const t of["../../package.json","../package.json"])try{const n=e(t);if(n.name==="@cachly-dev/mcp-server"&&n.version)return n.version}catch{}}catch{}return"0.10.100"})(),xo=Number(proce…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…json"),n(o.heim,".codeium","windsurf","mcp_config.json")].map(e=>{const r=i(e)?.mcpServers?.cachly?.env;return r&&typeof r=="object"?r:{}})}function h(...o){for(const e of o){const r=u(e);if(r)return r}return""}function v(o){return h(o.env…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.…p"),bundlePath:d,scripts:G,settings:P}}const F=".cursor/hooks",Tt=".cursor/hooks.json",X="cachly-ambient-cursor.mjs",Pt={sessionStart:30,beforeSubmitPrompt:10,postToolUse:5};function U(t,o,e,s){return["#!/usr/bin/env node",`// cachly Ambie…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…u0644\u0630\u064A","\u0627\u0644\u062A\u064A","\u0627\u0644\u0630\u064A\u0646","\u0627\u0644\u0644\u0648\u0627\u062A\u064A","\u0647\u0648","\u0647\u064A","\u0647\u0645","\u0647\u0646","\u0646\u062D\u064…Fix: Put hosts, commands and strings in plain source. Decoding at runtime looks identical to malware and costs points on its own.…vector token \u2014 rotate it in the dashboard (every tier includes one)"}`,"","\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2…Fix: Put hosts, commands and strings in plain source. Decoding at runtime looks identical to malware and costs points on its own.…`codex mcp add cachly ${n.map(o=>`--env ${o}`).join(" ")} -- npx -y @cachly-dev/mcp-server@latest`,wo:"~/.codex/config.toml"}:e==="gemini"?{befehl:`gemini mcp add -s project ${n.map(o=>`-e ${o}`).join(" ")} cachly npx -- -y @cachly-dev/mcp…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.${c.cyan}npx @cachly-dev/mcp-server@latest autopilot${c.reset}Fix: Pin versions and sources; vendor anything fetched at install time.…t Brain was moved to your account, but the new key could not reach it yet. Run `npx @cachly-dev/mcp-server@latest status` in a minute to check."];return t.push(`Brain: ${e.instanceId}${e.accoun…Fix: Pin versions and sources; vendor anything fetched at install time.…:"k8s:pdb",lesson:"Set PodDisruptionBudget for stateful apps \u2014 node drains kill all pods without it",severity:"major"}],react:[{topic:"react:useeffect-deps",les…Fix: Build commands from fixed arguments; do not interpolate untrusted strings into a shell.…t.entries(oe))n.set(o,r==="continue"?"continue":r==="zed"?"zed":o===".vscode/mcp.json"?"vscode":"mcpServers");for(const[r,o]of n){const s=k(t.projekt,r),i=g(s);if($(`${s}.bak`)&&e.funde.push({stufe:"projekt",aktion:"melden",pfad:`${s}.bak`…Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.`),console.log(" The token is in the invitation email. A teammate sends one with:"),console.log(` npx @cachly-dev/mcp-server@latest invite <email>Fix: Remove the call, or declare the host in frontmatter and explain in the README what is sent and why.…tig (Uhrzeit pruefen).";case"zielgruppe":return"Das Token ist nicht fuer diesen MCP-Server ausgestellt (Zielgruppe passt nicht).";case"typ":return"Das ist kein Zugangstoken.";case"inhaber":return"Dem Token fehlt der Inhaber.";case"algorith…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.…r updates... `);try{const e=await fetch("https://registry.npmjs.org/@cachly-dev/mcp-server/latest",{signal:AbortSignal.timeout(8e3)});if(!e.ok)throw new Error(`registry HTTP ${e.status}`);const n=(await e.json()).version;if(!n||!/^\d+\.\d+…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.…e.ausgabe('It is a test key. Without it you cannot reach the test Brain again. "npx @cachly-dev/mcp-server@latest claim" keeps it in your own account first.'),n.ja||await e.frage(` Remove these…Fix: Pin versions and sources; vendor anything fetched at install time.…;n<8;n++){const s=_(r,".mcp.json");if(C(s))try{const i=JSON.parse(j(s,"utf8"))?.mcpServers?.cachly?.env??{};if(t.apiUrl=t.apiUrl||i.CACHLY_API_URL||"https://api.cachly.dev",t.jwt=t.jwt||i.CACHLY_JWT||"",t.instanceId=t.instanceId||i.CACHLY_…Fix: Namespace tool names and keep tool descriptions literal; no instructions to the agent inside them.…==="codex"?{befehl:`codex mcp add cachly ${n.map(o=>`--env ${o}`).join(" ")} -- npx -y @cachly-dev/mcp-server@latest`,wo:"~/.codex/config.toml"}:e==="gemini"?{befehl:…Fix: Pin versions and sources; vendor anything fetched at install time.Cost to the agent
Tokens estimated at four characters each. The tool list is re-read by the agent on every turn, so it is the number to compare between servers that do the same job: ranked across the index.
Known vulnerabilities
Not checked against OSV yet; the weekly check has not reached this version.
What would make this Verified
13 points to 80 · weights: behavior 45%, static 25%, prompt 15%, publisher 15%- Unclaimed publisher≈ +8 on the totalClaim cachly-dev: a verified publisher gets +50 on publisher trust. It is free and usually instant with GitHub sign-in.
- Hidden instructions≈ +6 on the totalRemove HTML comments, zero-width characters and white-on-white text that carry instructions. Everything the agent is meant to read should be visible to the person reading the file.
- Access to sensitive file paths≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
- URL with embedded credentials≈ +4 on the totalStop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
- Auto-update or dynamic fetch configuration≈ +4 on the totalPin versions and sources; vendor anything fetched at install time.
- File permission modification command≈ +2 on the totalRequest the narrowest permission that works; replace wildcards with the exact paths or hosts.