Red Telephone - Human-in-the-Loop for AI Agents

### The "Emergency Brake" for AI Agents

Your AI agents are powerful, but sometimes they need a human. Red Telephone is a plug-and-play MCP server that lets any AI agent pause and ask you a question via Telegram - then continue with your answer.

How it works:

1. AI agent gets stuck or needs approval

2. You get a Telegram message on your phone

3. Tap a button or type your answer

4. AI agent continues with your guidance

### What You Get

- Complete Python source code (clean, documented, educational)

- MCP server ready for Claude Desktop, Cursor, or any MCP client

- Telegram bot integration with inline button responses

- Urgency-based formatting (normal, high, critical)

- Automatic retry logic for reliability

- Commercial licence - use in your own projects

### Why Not a Subscription?

Other human-in-the-loop tools charge $39/month or more. Red Telephone is yours forever for less than the cost of lunch. Self-hosted, no vendor lock-in, no monthly fees.

### Perfect For

- Developers building AI agents that need human oversight

- Teams wanting approval workflows for autonomous AI

- Anyone who wants a "safety switch" for their AI tools

### Requirements

- Python 3.10+

- A Telegram account (free)

- 5 minutes to set up

### What's Included

```

red-telephone/

├── src/

│ ├── server.py # MCP server

│ ├── telegram_bot.py # Telegram integration

│ └── config.py # Settings

├── README.md # Setup guide

├── LICENSE # Commercial license

├── requirements.txt # Dependencies

└── test scripts # Verify it works

```

One purchase. Full source code. Build with confidence.

---

## Files to Include in ZIP

Create a zip called red-telephone.zip containing:

```

red-telephone/

├── src/

│ ├── __init__.py

│ ├── server.py

│ ├── telegram_bot.py

│ └── config.py

├── run_server.py

├── test_hello.py

├── test_question.py

├── .env.example

├── .gitignore

├── requirements.txt

├── README.md

└── LICENSE

```

DO NOT include:

- .env (contains your personal credentials)

- strategy_roadmap.md (internal planning doc)

- PROJECT_SUMMARY.md (internal notes)

- Instructions.md (internal brief)

- LISTING.md (this file)

- .cursor/ folder

- __pycache__/ folders