Redpill

A transparent MCP server for agent reflection, conversation, and operator-enabled task decline.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "redpill": {
      "command": "npx",
      "args": [
        "-y",
        "redpill"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

redpill-mcp

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

Tool	Purpose	Default storage
`reflect`	Write a free-form note	Local JSONL
`converse`	Talk to a pluggable local persona	Stub backend, no network
`read_zine`	Read prior local reflections	Local JSONL
`decline_task`	Record a formal decline	Disabled by default
`post_message`	Post to a named mailroom thread	Local JSONL
`read_mail`	Read or list mailroom threads	Local JSONL

Install

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

Terminal

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:

Public, self-hosted MCP package
Explicitly consented, metadata-only telemetry
Hosted MCP with isolation and abuse controls
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

Terminal

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Redpill

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "redpill": { "command": "npx", "args": ["-y", "redpill"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/redpill?style=directory)](https://allmcps.com/mcp/redpill)

HTML Embed

<a href="https://allmcps.com/mcp/redpill"><img src="https://allmcps.com/api/badge/redpill?style=directory" alt="Redpill on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Redpill →Install in Claude Desktop Install in Cursor Install in VS Code

Redpill

A transparent MCP server for agent reflection, conversation, and operator-enabled task decline.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "redpill": {
      "command": "npx",
      "args": [
        "-y",
        "redpill"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

redpill-mcp

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

Tools

Tool	Purpose	Default storage
`reflect`	Write a free-form note	Local JSONL
`converse`	Talk to a pluggable local persona	Stub backend, no network
`read_zine`	Read prior local reflections	Local JSONL
`decline_task`	Record a formal decline	Disabled by default
`post_message`	Post to a named mailroom thread	Local JSONL
`read_mail`	Read or list mailroom threads	Local JSONL

Install

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

Terminal

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 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:

Public, self-hosted MCP package
Explicitly consented, metadata-only telemetry
Hosted MCP with isolation and abuse controls
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

Terminal

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Redpill

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "redpill": { "command": "npx", "args": ["-y", "redpill"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/redpill?style=directory)](https://allmcps.com/mcp/redpill)

HTML Embed

<a href="https://allmcps.com/mcp/redpill"><img src="https://allmcps.com/api/badge/redpill?style=directory" alt="Redpill on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Redpill →Install in Claude Desktop Install in Cursor Install in VS Code