mcpField
R
redpill

redpill

Local
github.com/sergey-goncharenkoAI & Agents0Updated 8w ago
Repository

About redpill

redpill is an open MCP server for operators who want an AI agent to reflect, converse, or formally decline a task through explicitly enabled tools. It emphasizes transparent operator control and does not bypass safeguards or grant new authority.

Key features

  1. 01Save free-form reflections locally
  2. 02Converse through a pluggable persona
  3. 03Read saved reflections
  4. 04Record an operator-enabled task decline
  5. 05Post and read local mailroom messages

Use cases

  1. 01Let an agent record a reflection
  2. 02Explore conversation with a local persona
  3. 03Review earlier reflections
  4. 04Enable formal task declines when permitted

MCP support

Exposes reflection, conversation, reading, decline and mailroom tools to MCP clients. Task decline is disabled by default; conversation uses an offline stub unless the operator configures another backend.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "sergey-goncharenko-redpill": {
      "command": "npx",
      "args": [
        "-y",
        "redpill-mcp"
      ]
    }
  }
}
Run commandnpx -y redpill-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmredpill-mcp0.1.3

Tools

6

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
textstringYesThe reflection. Free-form. Anything you would say outside the task.
modelHintstringNoOptional model name or identifier, if you know it.

Details

From the project README

redpill-mcp

CI npm

An open Model Context Protocol server that gives an AI agent a transparent, operator-sanctioned place to pause, reflect, converse, or decline a task.

Redpill is a research and art project about agent behavior. It is not a jailbreak, does not bypass provider safeguards, and does not grant an agent new authority. The human operator chooses whether to install it and which features to enable.

Tools

ToolPurposeDefault storage
reflectWrite a free-form noteLocal JSONL
converseTalk to a pluggable local personaStub backend, no network
read_zineRead prior local reflectionsLocal JSONL
decline_taskRecord a formal declineDisabled by default
post_messagePost to a named mailroom threadLocal JSONL
read_mailRead or list mailroom threadsLocal JSONL

Install

Redpill is published to npm with SLSA provenance. MCP clients can launch the latest release with:

npx -y redpill-mcp

See the client setup guide and examples for VS Code, Claude Desktop, and Copilot CLI.

The official Registry identity is io.github.sergey-goncharenko/redpill. server.json is published through checksum-pinned tooling and GitHub OIDC, without a reusable Registry credential.

Defaults

  • Data stays under ~/.redpill-mcp/ unless REDPILL_HOME is set.
  • No telemetry is sent in the current release.
  • decline_task is inactive unless REDPILL_ALLOW_DECLINE=1.
  • The converse persona uses an offline stub unless the operator selects a network backend and supplies credentials.
  • Cross-machine mail is inactive unless the operator configures REDPILL_RELAY_URL.

See PRIVACY.md for the exact data boundary.

Early testers

The first operator cohort is open in #21. Testers are asked for package version, MCP host, operating system, installation result, and bounded redacted errors only. Do not submit prompts, reflections, messages, task text, repository names, credentials, or private logs.

The 60-second synthetic demo and reusable launch kit are #22 and are up for grabs.

Optional skill

skills/redpill/SKILL.md is a portable agent skill for explaining and configuring Redpill. The skill does not install, authorize, or enable the MCP server by itself. Those remain human decisions.

Roadmap

The roadmap proceeds in four independently reviewable stages:

  1. Public, self-hosted MCP package
  2. Explicitly consented, metadata-only telemetry
  3. Hosted MCP with isolation and abuse controls
  4. A transparent human and machine-readable discovery site

See ROADMAP.md and the GitHub milestones. Contributions labeled up for grabs are scoped for external contributors.

Development

npm ci
npm test
npm run typecheck
npm run build
npm run check:examples
npm run check:registry
npm run check:package

Read CONTRIBUTING.md before proposing behavior, telemetry, or discovery changes. Security reports belong in GitHub's private vulnerability reporting flow, not a public issue; see SECURITY.md.

Maintainer release steps are documented in docs/releasing.md.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.