English Français العربية

dev.postbag/mcp

Registre officiel Autres

Form backend that routes: one tool per Postbag API operation, plus quickstart and explain.

Code source Site web Documentation

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 @postbag/mcp
Claude Code 
claude mcp add dev-postbag-mcp -e 'POSTBAG_API_KEY=<your postbag_api_key>' -e 'POSTBAG_API_URL=https://postbag.dev' -- npx -y @postbag/mcp@0.1.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dev-postbag-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@postbag/mcp@0.1.1"
            ],
            "env": {
                "POSTBAG_API_KEY": "<your postbag_api_key>",
                "POSTBAG_API_URL": "https://postbag.dev"
            }
        }
    }
}

Variables d'environnement

  • POSTBAG_API_KEY obligatoire secret A Postbag API key (pb_live_… or pb_test_…). Mint one at https://postbag.dev/app or with `postbag login`.
  • POSTBAG_API_URL Base URL of the Postbag API. Defaults to https://postbag.dev — set this only for a self-hosted instance.

Documentation

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

Sommaire
  1. Postbag
  2. Why it exists
  3. The one idea
  4. Status
  5. Documentation
  6. License

Postbag

A form backend that routes. Point any HTML form at a Postbag endpoint and it lands in your inbox — then goes wherever it should: email, Telegram, a webhook, a partner, your CRM. Built for people who run many sites, and for the AI agents that build them.

<form action="https://api.postbag.dev/s/fm_8f3kq2" method="POST">
  <input name="email" type="email" required>
  <textarea name="message"></textarea>
  <button>Send</button>
</form>

That's the whole integration for one form. Everything else — grouping forty forms into one stream, mapping their different fields onto one shape, sending that shape to a partner between two dates, a daily digest, never losing a submission — is there when you need it and invisible when you don't.

New here (human or AI agent)? Read CLAUDE.md first.

Why it exists

Every website has forms. Every form needs somewhere to go. Formspree and friends solve "somewhere" for one site; they fall over when you have fifteen sites feeding one partner with fifteen slightly different forms. Postbag is the source of truth for what each form collects, what each downstream system receives, and the versioned contract between them.

The one idea

The database makes it correct; events make it fast.

A submission is accepted the instant it is a row. Delivery is a durable outbox that a worker drains with retries. Realtime nudges are an accelerator, never a transport. If every event stream in the system died, every submission would still arrive — late, never lost. (Inherited from the lead pipeline this generalises; see docs/ARCHITECTURE.md.)

Status

Phase 1 — MVP live at postbag.dev (site, docs, dashboard at /app, API at /v1). See PROGRESS.md for the live blueprint and docs/ROADMAP.md for phases.

Documentation

Start at docs/README.md.

License

The server, dashboard, site and domain packages (apps/*, packages/core, packages/db, packages/auth) are licensed under AGPL-3.0. The client packages that run inside your own code — @postbag/sdk, the postbag CLI and @postbag/mcp — are MIT. Rationale in ADR-006.

Questions fréquentes

Qu'est-ce que dev.postbag/mcp ?

Form backend that routes: one tool per Postbag API operation, plus quickstart and explain.

Comment installer dev.postbag/mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add dev-postbag-mcp -e 'POSTBAG_API_KEY=<your postbag_api_key>' -e 'POSTBAG_API_URL=https://postbag.dev' -- npx -y @postbag/mcp@0.1.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour dev.postbag/mcp ?

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

dev.postbag/mcp est-il open source ?

Oui. Son code est sur GitHub sous licence AGPL-3.0.

Qui maintient dev.postbag/mcp ?

Il est publié par faahim. 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.