English Français العربية

dev.postbag/mcp

السجل الرسمي أخرى

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

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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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"
            }
        }
    }
}

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

  • POSTBAG_API_KEY إلزامي سري 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.

التوثيق

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

المحتويات
  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.

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

ما هو dev.postbag/mcp؟

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

كيف أثبّت dev.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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج dev.postbag/mcp إلى مفتاح API؟

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

هل dev.postbag/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص AGPL-3.0.

من يصون dev.postbag/mcp؟

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

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