English Français العربية

Lumail

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

Official Lumail email marketing MCP for campaigns, subscribers, and workflows.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http lumail 'https://lumail.io/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "lumail": {
            "type": "http",
            "url": "https://lumail.io/mcp"
        }
    }
}

التوثيق

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

المحتويات
  1. Lumail Agent Skills and Plugins
  2. Install
  3. What is in here
  4. How the connection works
  5. What agents can do
  6. The CLI
  7. WordPress plugin
  8. Example prompts
  9. Support

Lumail Agent Skills and Plugins

Install Lumail's agent skills or connect Lumail to Claude Code and Codex. The repository includes reusable marketing and copywriting skills alongside the Lumail CLI and OAuth MCP plugin skills.

Agent plugins authenticate with browser OAuth. Those sessions have no API token to create, paste, or store. The WordPress plugin in wordpress/ is the exception: it uses a lum_ organization token on the server.

Install

The fastest path is to let your agent do it. Paste this into Claude Code:

Read lumail.io/claude-code and install the Lumail plugin for me.

or into Codex:

Read lumail.io/codex and set up the Lumail connection for me.

or, for the terminal workflow (full API, including sending), into any agent:

Read lumail.io/cli and set up the Lumail CLI for me.

Prefer to run it yourself:

claude plugin marketplace add https://github.com/Melvynx/lumail-skills.git
claude plugin install lumail@lumail
claude mcp login plugin:lumail:lumail

Full guides: docs/claude-code-install.md · docs/codex-install.md

What is in here

PathWhat it is
wordpress/WordPress plugin — [lumail_form] → Lumail subscribers
.claude-plugin/marketplace.jsonClaude Code marketplace descriptor
claude/.claude-plugin/plugin.jsonClaude Code plugin, declares the MCP server inline
codex/.codex-plugin/plugin.jsonCodex plugin metadata
codex/.mcp.jsonCodex MCP server configuration
.agents/plugins/marketplace.jsonCodex marketplace descriptor
skills/lumail/The lumail CLI skill (npx lumail) — canonical copy
skills/lumail-plugin/How to drive the MCP connection, its limits and errors
skills/marketing/Marketing strategy, positioning, offers, funnels, and launches
skills/copywritting/Conversion copy for emails, pages, ads, scripts, and CTAs

claude/skills and codex/skills are real copies of skills/ (symlinks break on Windows checkouts), so both hosts ship the same skills. Edit the top-level skills/ first, then sync the copies.

How the connection works

The plugin points both hosts at https://lumail.io/mcp, an OAuth 2.1 protected resource. The host registers itself through dynamic client registration, runs PKCE, and stores the access token itself. During the browser flow you sign in, pick which organization the agent may reach, and approve the scopes. Only owners and admins of an organization can authorize it.

Access tokens carry the organization as a claim, so a session can never reach another organization in your account. Revoke from the connected-apps list in Lumail settings and access stops on the next request, with no local config to clean up.

What agents can do

Read — subscribers, tags, campaigns, campaign analytics and progress, workflows and workflow groups, org stats, subscriber growth, senders, custom fields, snippets, writing style.

Write — add subscribers, create and apply tags, create and edit campaign drafts, duplicate campaigns, create and configure workflow drafts.

Not available over OAuth — sending, scheduling, publishing or activating a workflow, unsubscribing, and every delete. Those tools are not registered on this endpoint, so an agent cannot reach them even with your approval. Do that work in the Lumail app, or with npx lumail if you want it in a terminal.

The CLI

npx lumail reaches the full API, including sending. It authenticates with the same browser flow:

npx lumail auth login

The lumail skill in this repository teaches agents the whole CLI.

WordPress plugin

wordpress/ is a PHP plugin: settings page for a lum_ token, shortcode [lumail_form], server-side POST /api/v2/subscribers. Copy the folder to wp-content/plugins/lumail. Details: wordpress/README.md and wordpress/BUILD.md.

Example prompts

  • How did last week's newsletter perform compared to the one before?
  • Draft a launch campaign with three subject line options.
  • Add user@example.com to my newsletter and tag them vip.
  • Build a three-email welcome sequence over a week and leave it as a draft.
  • Show me subscriber growth over the last 30 days.

Support

lumail.io · Documentation

MIT licensed.

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

ما هو Lumail؟

Official Lumail email marketing MCP for campaigns, subscribers, and workflows.

كيف أثبّت Lumail؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http lumail 'https://lumail.io/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

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

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Lumail؟

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

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