English Français العربية

Postfleet

السجل الرسمي الإنتاجية

Give an AI agent its own email address: send, reply, read, and wait for mail.

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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http postfleet 'https://api.postfleet.ai/api/mcp' --header 'Authorization: <Bearer auth with your Postfleet API key.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "postfleet": {
            "type": "http",
            "url": "https://api.postfleet.ai/api/mcp",
            "headers": {
                "Authorization": "<Bearer auth with your Postfleet API key.>"
            }
        }
    }
}
NPM package @postfleet/mcp
Claude Code 
claude mcp add postfleet -e 'POSTFLEET_API_KEY=<your postfleet_api_key>' -e 'POSTFLEET_API_URL=https://api.postfleet.ai' -- npx -y @postfleet/mcp@0.1.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "postfleet": {
            "command": "npx",
            "args": [
                "-y",
                "@postfleet/mcp@0.1.4"
            ],
            "env": {
                "POSTFLEET_API_KEY": "<your postfleet_api_key>",
                "POSTFLEET_API_URL": "https://api.postfleet.ai"
            }
        }
    }
}

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

  • POSTFLEET_API_KEY إلزامي سري Your Postfleet API key (pf_...) from https://postfleet.ai
  • POSTFLEET_API_URL API origin override for staging or self-hosted deployments

التوثيق

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

المحتويات
  1. Postfleet MCP
  2. Tools
  3. Install
  4. Keys
  5. Links
  6. Build from source

Postfleet MCP

Give an AI agent its own email address. Postfleet is email infrastructure for agents — inbound is parsed, classified, extracted to your schema, and screened for prompt injection before your agent reads a word.

This repo holds the server source and its plugin manifests. It is a mirror — the code is developed in the Postfleet application repo and published to npm as @postfleet/mcp; open issues here, send patches here, and they land upstream. The server ships two ways:
Hosted (no install)https://api.postfleet.ai/api/mcp, streamable HTTP, Authorization: Bearer pf_...
Local (stdio)@postfleet/mcp via npx

Get a pf_ API key at postfleet.ai.

Tools

list_mailboxes, create_mailbox, list_domains, create_domain, verify_domain, send_email, reply_email, list_inbox, read_email, wait_for_email — plus the draft lifecycle (create_draft, list_drafts, get_draft, update_draft, send_draft, delete_draft) for flows where a human approves before mail goes out. A send that lands in that gate returns 202 pending_approval, which is not a failure.

Every tool is thin-over-REST — it calls the same /api/v1/ endpoints your key already reaches (OpenAPI), so auth, scoping, and quotas are enforced once.

Install

Cursor marketplace plugin

The manifests in this repo (mcp.json, .cursor-plugin/plugin.json) declare headers.Authorization = Bearer ${POSTFLEET_API_KEY} for the hosted server and the same variable for local npx @postfleet/mcp. Installing the plugin should prompt for that key and attach it as a real Bearer header — a raw URL add without the header will 401 on initialize until a key is supplied or the hosted connect card finishes OAuth.

Cursor (manual)
{
  "mcpServers": {
    "postfleet": {
      "url": "https://api.postfleet.ai/api/mcp",
      "headers": { "Authorization": "Bearer pf_your_key_here" }
    }
  }
}
Local stdio (npx -y @postfleet/mcp)
npx -y @postfleet/mcp

Any MCP client that speaks stdio can run that command with POSTFLEET_API_KEY set:

{
  "mcpServers": {
    "postfleet": {
      "command": "npx",
      "args": ["-y", "@postfleet/mcp"],
      "env": { "POSTFLEET_API_KEY": "pf_your_key_here" }
    }
  }
}
Claude Code
claude mcp add postfleet --env POSTFLEET_API_KEY=pf_your_key_here -- npx -y @postfleet/mcp

POSTFLEET_API_URL (default https://api.postfleet.ai) overrides the API origin for staging or self-hosted deployments.

Keys

Keys are scoped — bootstrap can only create mailboxes, api covers mail operations, mcp is the one to hand a client. Use a separate key per workload so you can revoke one without breaking the rest. Never commit a key; the manifests in this repo deliberately contain none.

Build from source

npm install && npm run build   # tsup → dist/

MIT licensed.

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

ما هو Postfleet؟

Give an AI agent its own email address: send, reply, read, and wait for mail.

كيف أثبّت Postfleet؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http postfleet 'https://api.postfleet.ai/api/mcp' --header 'Authorization: <Bearer auth with your Postfleet API key.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Postfleet إلى مفتاح API؟

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

هل Postfleet مفتوح المصدر؟

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

من يصون Postfleet؟

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

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