io.github.zwebso/postlane

Registre officiel Productivité

Send transactional email and read send activity through the Postlane API.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package postlane-mcp
Claude Code
claude mcp add postlane -e 'POSTLANE_API_KEY=<your postlane_api_key>' -- npx -y postlane-mcp@0.1.0
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "postlane": {
            "command": "npx",
            "args": [
                "-y",
                "postlane-mcp@0.1.0"
            ],
            "env": {
                "POSTLANE_API_KEY": "<your postlane_api_key>"
            }
        }
    }
}

Variables d'environnement

  • POSTLANE_API_KEY obligatoire secret Bearer key from https://www.postlane.email/app/api-keys. It starts with pl_live_.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Postlane
  2. Send
  3. Cursor
  4. Development

Postlane

Postlane is a transactional email API. Applications use it to send welcome messages, address verification, password resets, and receipts from a verified domain.

Postlane is not an inbox, and it does not provide IMAP or hosted mailboxes.

Send

Create a key at API keys after you verify a sending domain. The secret is shown once and starts with pl_live_. Keep it on your server.

POST https://www.postlane.email/v1/emails
Authorization: Bearer pl_live_…
Content-Type: application/json
Idempotency-Key: welcome-user-123
{
  "from": "hello@send.yourdomain.com",
  "to": ["alex@example.com"],
  "subject": "Welcome",
  "html": "<h1>You’re in.</h1>"
}

A successful response is 202 with { "id": "em_…", "status": "queued" }. queued means the message was accepted for delivery. It does not mean the message is in the inbox. Repeating the same Idempotency-Key returns the original result and does not send again.

Errors use { "error": { "code", "message", "request_id", "retryable" } }. The same contract is published for agents at https://www.postlane.email/llms.txt.

Cursor

postlane-cursor/ is the Postlane plugin for Cursor. It teaches POST /v1/emails and exposes send_email, get_email, and list_emails. The API key is a plugin setting. It is not stored in this repository.

Development

npm install
npm run dev

Open http://localhost:5173. The first API request creates the local database schema. Local sends use a mock provider unless Email Sending is bound. accepted in that mode means the request was stored, not delivered.

npm test
npm run typecheck

Signed webhook delivery, attachments, and template versions are not part of the public API yet.

Questions fréquentes

Qu'est-ce que io.github.zwebso/postlane ?

Send transactional email and read send activity through the Postlane API.

Comment installer io.github.zwebso/postlane ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add postlane -e 'POSTLANE_API_KEY=<your postlane_api_key>' -- npx -y postlane-mcp@0.1.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.zwebso/postlane ?

Oui. Il attend POSTLANE_API_KEY, à renseigner dans sa configuration.

io.github.zwebso/postlane est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.zwebso/postlane ?

Il est publié par zwebso. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.