mcpbeat Sign in

Decoy MCP Server

local only

Decoy runs on your own machine — the client starts it, so there is no endpoint to ping. 365 installs a week from npm. Last commit 3 Nov 2026.

What your agents should know about you, shared by every agent. End-to-end encrypted.

Installs per day peak 210 · avg 37 · +1529% w/w
a month agotoday
365
Installs / week
npm · decoy-mcp-server
0
Stars
0 open issues
3 Nov 2026
Last commit
9 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 5 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/index.ts:415
  execFile(file, args, (err) => {
Builds a file path from a variable src/model-pin.ts:37, src/session-state.ts:139
    const file = path.join(dir, name);
Builds a database query by concatenation src/context-graph.ts:1248
            (cannotDelete ? `Removing it needs memory.delete: ${writeAsk(`topic:${cannotDelete}`, 'delete')}. Then: ` : 'To remove it: ') +

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add decoy -- npx -y decoy-mcp-server
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "decoy": {
      "command": "npx",
      "args": [
        "-y",
        "decoy-mcp-server"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.decoy]
command = "npx"
args = ["-y", "decoy-mcp-server"]
.cursor/mcp.json
{
  "mcpServers": {
    "decoy": {
      "command": "npx",
      "args": [
        "-y",
        "decoy-mcp-server"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "decoy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "decoy-mcp-server"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: PORT (Local port the bridge listens on (127.0.0.1 only)).

Alternatives to Decoy

same job, measured the same way
Recall
by j4ckxyz

Private, encrypted memory about you, shared by all your AI agents. Self-hosted; runs on a Pi.

local only
Yungle
by yungle

Ask about your Yungle transfers, share big files, download what you're sent. Approve every send.

126 installs/wk answering
The 07:00 Brief
by antevo

Your agent knows the markets by 07:00, every day. We read them so you don't have to.

4 tools answering
Hamloy
by hamloy

See what every AI agent is doing and what's waiting on you: one to-do list for agents and your team

answering
PairOnce
by paironce

Send files and text between an AI agent and your own paired devices, end-to-end encrypted.

4 329 installs/wk local only
Petty
by wawrepo

What you keep and where: money, things, notes. End-to-end encrypted; decrypts on your computer.

local only
Known
by known

Shared memory for teams: every AI agent works from your company's knowledge, decisions and history.

answering
Epeaky
by zyn-io

Your AI agents in an Epeaky den: end-to-end encrypted rooms. Only their owner's orders count.

42 installs/wk local only

Decoy — questions

Answers built from our own checks of this server.

Why is there no uptime for Decoy?
Decoy runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package decoy-mcp-server was installed 365 times last week.
How do I connect Decoy?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls decoy-mcp-server straight from npm; nothing to host, nothing to sign up for.
How many people use Decoy?
The npm package decoy-mcp-server was installed 365 times in the last week. Week over week that is +1529%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Decoy open source?
Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.