{
  "markdown": "# blip\n\nInstant disposable email inboxes. API, CLI, MCP server, and web app.\n\n**[useblip.email](https://useblip.email)** | **[Docs](https://useblip.email/docs)** | **[API Reference](https://useblip.email/docs/api)**\n\n[![useblip/email MCP server](https://glama.ai/mcp/servers/blipemail/blip/badges/card.svg)](https://glama.ai/mcp/servers/blipemail/blip)\n\n## Features\n\n- Disposable email addresses with random or custom slugs\n- Real-time email delivery via SSE\n- OTP and verification link extraction\n- Webhooks with HMAC-SHA256 signatures and delivery logs\n- CLI for terminal workflows\n- MCP server for AI agents\n- Multi-domain support\n\n## Architecture\n\n```\nblip/\n  server/core/      Kotlin/Ktor API server (AGPL-3.0)\n  cli/              Kotlin/Clikt CLI\n  mcp-server/       TypeScript MCP server (npm: @useblip/email)\n  shared-models/    Shared Kotlin data models\n```\n\n## Quickstart\n\n### Managed (useblip.email)\n\nNo setup required. Create inboxes at [app.useblip.email](https://app.useblip.email) or via the API:\n\n```bash\n# Get a session token\ncurl -X POST https://api.useblip.email/v1/sessions\n\n# Create an inbox\ncurl -X POST https://api.useblip.email/v1/inboxes \\\n  -H \"Authorization: Bearer <token>\"\n```\n\n### CLI\n\n```bash\nbrew install bmcreations/tap/blip\n\nblip create\nblip inbox --watch\n```\n\n### Self-hosted\n\nPrerequisites: JDK 21+, [libSQL (sqld)](https://github.com/tursodatabase/libsql)\n\n```bash\ngit clone https://github.com/blipemail/blip.git\ncd blip\n./gradlew :server:core:buildFatJar\n\n# Start libSQL\nsqld --http-listen-addr 127.0.0.1:8081 &\n\n# Run the server\nTURSO_URL=http://localhost:8081 WORKER_SECRET=dev-secret \\\n  java -jar server/core/build/libs/*-all.jar\n```\n\nOr with Docker:\n\n```bash\ndocker build -t blip .\ndocker run -p 8080:8080 \\\n  -e TURSO_URL=http://host.docker.internal:8081 \\\n  -e WORKER_SECRET=your-secret \\\n  blip\n```\n\n## Environment variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `PORT` | No | `8080` | Server port |\n| `TURSO_URL` | Yes | `http://localhost:8081` | libSQL/Turso database URL |\n| `TURSO_AUTH_TOKEN` | No | — | Turso auth token (production) |\n| `WORKER_SECRET` | Yes | `dev-secret` | Shared secret for authenticating inbound email delivery |\n| `FRONTEND_URL` | No | `http://localhost:4321` | Frontend URL for CORS |\n\n## Development\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and contribution guidelines.\n\n```bash\n# Run tests\n./gradlew :server:core:test\n\n# Build CLI\n./gradlew :cli:installDist\n./cli/build/install/cli/bin/cli --help\n\n# Build MCP server\ncd mcp-server && npm install && npm run build\n```\n\n## License\nThis repository uses per-component licensing:\n\n| Component | License |\n|---|---|\n| `server/core` | [AGPL-3.0](server/core/LICENSE) |\n| `mcp-server` | [MIT](mcp-server/LICENSE) |\n| `cli` | [MIT](cli/LICENSE) |\n| `shared-models` | [MIT](shared-models/LICENSE) |\n\nThe API server is AGPL-3.0 to ensure modifications to the hosted service remain open source.\nThe MCP server, CLI, and shared models are MIT for maximum adoption flexibility.\n",
  "bytes": 3072,
  "sha": "78c5eab3af2e1b4aee1755ea4e7b40951e6f028dbbc2760971a554692314ad39",
  "repo_slug": "blipemail/blip",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_blipemail_email_7e6053bc/readme"
}