English Français العربية

dev.postbag/mcp

Official registry Other

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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
JSON configuration (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"
            }
        }
    }
}

Environment variables

  • POSTBAG_API_KEY required 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

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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.

Frequently asked questions

What is dev.postbag/mcp?

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

How do I install dev.postbag/mcp?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does dev.postbag/mcp need an API key?

Yes. It expects POSTBAG_API_KEY, which you set in its configuration.

Is dev.postbag/mcp open source?

Yes. Its code is on GitHub under the AGPL-3.0 license.

Who maintains dev.postbag/mcp?

It is published by faahim. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.