English Français العربية

io.github.blipemail/email

السجل الرسمي الإنتاجية

MCP server for Blip disposable email — create inboxes, receive emails, extract OTP codes

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.blipemail/email؟

  • Disposable email addresses with random or custom slugs
  • Real-time email delivery via SSE
  • OTP and verification link extraction
  • Webhooks with HMAC-SHA256 signatures and delivery logs
  • CLI for terminal workflows
  • MCP server for AI agents
  • Multi-domain support

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @useblip/email
Claude Code 
claude mcp add email -e 'BLIP_API_KEY=<your blip_api_key>' -- npx -y @useblip/email@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "email": {
            "command": "npx",
            "args": [
                "-y",
                "@useblip/email@0.1.3"
            ],
            "env": {
                "BLIP_API_KEY": "<your blip_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • BLIP_API_KEY إلزامي سري Your Blip API key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. blip
  2. Features
  3. Architecture
  4. Quickstart
  5. Environment variables
  6. Development
  7. License

blip

Instant disposable email inboxes. API, CLI, MCP server, and web app.

useblip.email | Docs | API Reference

Features

  • Disposable email addresses with random or custom slugs
  • Real-time email delivery via SSE
  • OTP and verification link extraction
  • Webhooks with HMAC-SHA256 signatures and delivery logs
  • CLI for terminal workflows
  • MCP server for AI agents
  • Multi-domain support

Architecture

blip/
  server/core/      Kotlin/Ktor API server (AGPL-3.0)
  cli/              Kotlin/Clikt CLI
  mcp-server/       TypeScript MCP server (npm: @useblip/email)
  shared-models/    Shared Kotlin data models

Quickstart

Managed (useblip.email)

No setup required. Create inboxes at app.useblip.email or via the API:

# Get a session token
curl -X POST https://api.useblip.email/v1/sessions

# Create an inbox
curl -X POST https://api.useblip.email/v1/inboxes \
  -H "Authorization: Bearer <token>"
CLI
brew install bmcreations/tap/blip

blip create
blip inbox --watch
Self-hosted

Prerequisites: JDK 21+, libSQL (sqld)

git clone https://github.com/blipemail/blip.git
cd blip
./gradlew :server:core:buildFatJar

# Start libSQL
sqld --http-listen-addr 127.0.0.1:8081 &

# Run the server
TURSO_URL=http://localhost:8081 WORKER_SECRET=dev-secret \
  java -jar server/core/build/libs/*-all.jar

Or with Docker:

docker build -t blip .
docker run -p 8080:8080 \
  -e TURSO_URL=http://host.docker.internal:8081 \
  -e WORKER_SECRET=your-secret \
  blip

Environment variables

VariableRequiredDefaultDescription
PORTNo8080Server port
TURSO_URLYeshttp://localhost:8081libSQL/Turso database URL
TURSO_AUTH_TOKENNo—Turso auth token (production)
WORKER_SECRETYesdev-secretShared secret for authenticating inbound email delivery
FRONTEND_URLNohttp://localhost:4321Frontend URL for CORS

Development

See CONTRIBUTING.md for development setup and contribution guidelines.

# Run tests
./gradlew :server:core:test

# Build CLI
./gradlew :cli:installDist
./cli/build/install/cli/bin/cli --help

# Build MCP server
cd mcp-server && npm install && npm run build

License

This repository uses per-component licensing:

ComponentLicense
server/coreAGPL-3.0
mcp-serverMIT
cliMIT
shared-modelsMIT

The API server is AGPL-3.0 to ensure modifications to the hosted service remain open source. The MCP server, CLI, and shared models are MIT for maximum adoption flexibility.

الأسئلة الشائعة

ما هو io.github.blipemail/email؟

MCP server for Blip disposable email — create inboxes, receive emails, extract OTP codes

كيف أثبّت io.github.blipemail/email؟

يعمل على جهازك. في Claude Code: claude mcp add email -e 'BLIP_API_KEY=<your blip_api_key>' -- npx -y @useblip/email@0.1.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.blipemail/email إلى مفتاح API؟

نعم. يتطلب BLIP_API_KEY، وتضبطها في إعداداته.

هل io.github.blipemail/email مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.blipemail/email؟

ينشره blipemail. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.