Mailgun

Mailgun MCP सर्वर

अवलोकन

Mailgun के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर जो AI एजेंटों को ईमेल भेजने, डिलीवरेबिलिटी का निदान करने और खाता संचालन प्रबंधित करने के लिए एक व्यावहारिक, वर्कफ़्लो-उन्मुख इंटरफ़ेस प्रदान करता है।

[!NOTE] यह MCP सर्वर आपकी मशीन पर स्थानीय रूप से चलता है और stdio पर संचार करता है। Mailgun वर्तमान में इस सर्वर का होस्टेड संस्करण प्रदान नहीं करता है।

क्षमताएँ

• मैसेजिंग — ईमेल भेजें, संग्रहीत संदेश पुनर्प्राप्त करें, संदेश पुनः भेजें
• डोमेन — डोमेन विवरण देखें, DNS कॉन्फ़िगरेशन सत्यापित करें, ट्रैकिंग सेटिंग प्रबंधित करें (क्लिक, खोलें, सदस्यता समाप्त करें)
• वेबहुक — ईवेंट वेबहुक सूचीबद्ध करें, बनाएँ और अपडेट करें
• रूट — इनबाउंड ईमेल रूटिंग नियम देखें और अपडेट करें
• मेलिंग सूचियाँ — मेलिंग सूचियाँ और उनके सदस्य बनाएँ, देखें और अपडेट करें
• टेम्पलेट — संस्करणीकरण के साथ ईमेल टेम्पलेट बनाएँ, देखें और अपडेट करें
• एनालिटिक्स — भेजने के मेट्रिक्स, उपयोग मेट्रिक्स और लॉग क्वेरी करें
• स्टैट्स — डोमेन, टैग, प्रदाता, डिवाइस और देश के अनुसार समग्र आँकड़े देखें
• दमन — बाउंस, सदस्यता समाप्ति, शिकायतें और अनुमति सूची प्रविष्टियाँ देखें
• IP और IP पूल — IP असाइनमेंट और समर्पित IP पूल कॉन्फ़िगरेशन देखें
• बाउंस वर्गीकरण — बाउंस प्रकारों और डिलीवरी समस्याओं का विश्लेषण करें
• मान्यकरण — भेजने से पहले ईमेल पते की डिलीवरेबिलिटी और सिंटैक्स मान्य करें (validate)
• ऑप्टिमाइज़ (इनबॉक्स प्लेसमेंट) — डिलीवरेबिलिटी का आकलन करने के लिए इनबॉक्स प्लेसमेंट / सीड टेस्ट परिणाम पुनर्प्राप्त करें (optimize)
• इंस्पेक्ट (ईमेल पूर्वावलोकन) — क्लाइंट्स में ईमेल रेंडरिंग और पूर्वावलोकन परीक्षण परिणाम पुनर्प्राप्त करें (inspect)
• खाता सीमाएँ — कस्टम मासिक भेजने की सीमाएँ देखें

ऊपर दिए गए कोष्ठक लेबल (validate, optimize, inspect) टैग फ़िल्टरिंग द्वारा उपयोग किए जाने वाले उत्पाद टैग हैं। हर दूसरी क्षमता send टैग के अंतर्गत पंजीकृत है।

[!NOTE] उपकरण केवल पढ़ने और अपडेट करने के संचालन तक सीमित हैं — कोई हटाने का संचालन उजागर नहीं किया गया है, जो अनपेक्षित कार्रवाई के विस्फोट त्रिज्या को छोटा रखता है। सुरक्षा विचार देखें।

यह कैसे काम करता है

सर्वर OpenAPI संचालित है। स्टार्टअप पर यह एक बंडल Mailgun OpenAPI स्पेक को पार्स करता है और MCP उपकरणों के रूप में एंडपॉइंट्स की एक क्यूरेटेड अनुमति सूची पंजीकृत करता है, स्पेक से प्रत्येक उपकरण का इनपुट स्कीमा (Zod के माध्यम से) उत्पन्न करता है। प्रत्येक उपकरण को Mailgun उत्पाद टैग (send, validate, optimize, या inspect) के साथ एनोटेट किया गया है। सभी मिलान उपकरण पहले से पंजीकृत हैं — कोई आलसी या ऑन-डिमांड लोडिंग नहीं है। टैग फ़िल्टरिंग स्टार्टअप पर लागू की जाती है ताकि यह निर्धारित किया जा सके कि कौन से उपकरण पंजीकृत होते हैं, ताकि एक दिया गया वर्कफ़्लो केवल उन्हीं उत्पादों को उजागर कर सके जिनकी उसे आवश्यकता है।

पूर्वापेक्षाएँ

• Node.js (v20.12 या उच्चतर)
• Mailgun खाता और API कुंजी

स्थापना

सर्वर npm पर @mailgun/mcp-server के रूप में प्रकाशित है और stdio पर चलता है। अधिकांश क्लाइंट इसे npx के साथ ऑन-डिमांड लॉन्च कर सकते हैं, इसलिए विश्व स्तर पर स्थापित करने के लिए कुछ भी नहीं है। नीचे दिए गए प्रत्येक स्निपेट में, YOUR-mailgun-api-key को अपनी Mailgun API सुरक्षा सेटिंग्स से एक कुंजी से बदलें।

[!TIP] यदि आपका खाता Mailgun के EU क्षेत्र में होस्ट किया गया है, तो env ब्लॉक (या CLI पर -e MAILGUN_API_REGION=eu) में "MAILGUN_API_REGION": "eu" जोड़ें। यह डिफ़ॉल्ट रूप से us होता है।

Claude Code

claude mcp add mailgun -e MAILGUN_API_KEY=YOUR-mailgun-api-key -- npx -y @mailgun/mcp-server

फिर mailgun सर्वर कनेक्ट होने की पुष्टि करने के लिए Claude Code में /mcp चलाएँ।

Claude Desktop

Settings → Developer → Edit Config खोलें, या फ़ाइल को सीधे संपादित करें:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key",
        "MAILGUN_API_REGION": "us"
      }
    }
  }
}

Cursor

कमांड पैलेट खोलें और Cursor Settings → MCP → Add new global MCP server चुनें, फिर जोड़ें:

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
      }
    }
  }
}

Codex

codex mcp add mailgun \
  --env MAILGUN_API_KEY=YOUR-mailgun-api-key \
  -- npx -y @mailgun/mcp-server

VS Code (GitHub Copilot)

अपने settings.json में निम्नलिखित जोड़ें:

{
  "mcp": {
    "servers": {
      "mailgun": {
        "command": "npx",
        "args": ["-y", "@mailgun/mcp-server"],
        "env": {
          "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
        }
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
      }
    }
  }
}

Gemini CLI

~/.gemini/settings.json में जोड़ें:

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
      }
    }
  }
}

कॉन्फ़िगरेशन

पर्यावरण चर

चर	आवश्यक	डिफ़ॉल्ट	विवरण
MAILGUN_API_KEY	हाँ	—	आपकी Mailgun API कुंजी
MAILGUN_API_REGION	नहीं	us	API क्षेत्र: us या eu
MAILGUN_API_HOSTNAME	नहीं	(क्षेत्र से व्युत्पन्न)	API होस्टनाम ओवरराइड करें (जैसे api.eu.mailgun.net)। क्षेत्र पर प्राथमिकता लेता है।
MAILGUN_MCP_TAGS	नहीं	(सभी)	सक्षम करने के लिए अल्पविराम से अलग उत्पाद टैग। --tags के समतुल्य। CLI फ़्लैग प्राथमिकता लेता है।

CLI विकल्प

अपने क्लाइंट के args में पैकेज नाम के बाद फ़्लैग पास करें (जैसे ["-y", "@mailgun/mcp-server", "--tags", "validate,inspect"])।

फ़्लैग	विवरण
--tags <list>	सक्षम करने के लिए अल्पविराम से अलग उत्पाद टैग (डिफ़ॉल्ट: सभी)। मान्य: send, validate, optimize, inspect।
--list-tags	मान्य टैग मान प्रिंट करें और बाहर निकलें।
--help, -h	उपयोग दिखाएँ और बाहर निकलें।

टैग फ़िल्टरिंग

आप यह निर्धारित कर सकते हैं कि सर्वर कौन से उपकरण एक या अधिक Mailgun उत्पाद टैग के लिए पंजीकृत करता है। यह मॉडल को दिखाए जाने वाले टूलसेट को सीमित करने के लिए उपयोगी है — उदाहरण के लिए, केवल एक ऐसे वर्कफ़्लो के लिए मान्यकरण उपकरण उजागर करना जिसे भेजने की क्षमताओं की आवश्यकता नहीं है।

मान्य टैग: send, validate, optimize, inspect। जब अनिर्दिष्ट हो, तो हर उपकरण पंजीकृत होता है (आज का डिफ़ॉल्ट)।

फ़िल्टरिंग OR शब्दार्थ का उपयोग करती है: एक उपकरण पंजीकृत होता है यदि उसका कोई भी टैग सक्रिय सेट में दिखाई देता है।

CLI फ़्लैग के माध्यम से — अपने MCP क्लाइंट कॉन्फ़िग के args में --tags पास करें:

{
  "mcpServers": {
    "mailgun": {
      "command": "npx",
      "args": ["-y", "@mailgun/mcp-server", "--tags", "validate,inspect"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
      }
    }
  }
}

पर्यावरण चर के माध्यम से — MAILGUN_MCP_TAGS सेट करें (यदि दोनों मौजूद हैं तो CLI फ़्लैग जीतता है):

"env": {
  "MAILGUN_API_KEY": "YOUR-mailgun-api-key",
  "MAILGUN_MCP_TAGS": "validate,inspect"
}

[!TIP] समर्थित टैग मान प्रिंट करने के लिए --list-tags के साथ बाइनरी चलाएँ, या पूर्ण उपयोग के लिए --help। अज्ञात टैग स्टार्टअप पर एक स्पष्ट त्रुटि संदेश के साथ अस्वीकार कर दिए जाते हैं।

नमूना संकेत

एक ईमेल भेजें

Can you send an email to EMAIL_HERE with a funny email body that makes it sound
like it's from the IT Desk from Office Space? Please use the sending domain
DOMAIN_HERE, and make the email from "postmaster@DOMAIN_HERE"!

[!NOTE] कुछ MCP क्लाइंट को डेटा भेजने वाले उपकरणों को लागू करने के लिए एक भुगतान योजना की आवश्यकता होती है। यदि भेजना चुपचाप विफल हो जाता है, तो अपने क्लाइंट की योजना की जाँच करें।

भेजने के आँकड़े प्राप्त करें और विज़ुअलाइज़ करें

Would you be able to make a chart with email delivery statistics for the past week?

टेम्पलेट प्रबंधित करें

Create a welcome email template for new signups on my domain DOMAIN_HERE.
Include a personalized greeting and a call-to-action button.

डिलीवरेबिलिटी की जाँच करें

Can you check the bounce classification stats for my account and tell me
what the most common bounce reasons are?

DNS समस्या निवारण

Check the DNS verification status for my domain DOMAIN_HERE and tell me
if anything needs fixing.

दमन की समीक्षा करें

Are there any unsubscribes or complaints for DOMAIN_HERE? Summarize the
top offenders.

रूटिंग नियम प्रबंधित करें

List all my inbound routes and explain what each one does.

एक मेलिंग सूची बनाएँ

Create a mailing list called announcements@DOMAIN_HERE and add these
members: alice@example.com, bob@example.com.

डोमेन की तुलना करें

Compare my sending volume and delivery rates across all my domains for
the past month.

क्षेत्र के अनुसार सहभागिता

Break down my email engagement by country and device for DOMAIN_HERE.

ट्रैकिंग सेटिंग्स की समीक्षा करें

List all my domains and show which ones have tracking enabled for clicks
and opens.

एक ईमेल पता मान्य करें

Validate the email address EMAIL_HERE and tell me whether it's safe to send to.

इनबॉक्स प्लेसमेंट जाँचें (ऑप्टिमाइज़)

Pull the inbox placement results for seed test RESULT_ID_HERE and summarize
where my message landed (inbox, spam, or missing) by provider.

एक ईमेल का पूर्वावलोकन करें (इंस्पेक्ट)

Get the email preview results for test TEST_ID_HERE and tell me if the email
renders correctly across clients.

विकास

स्रोत से चलाएँ

सर्वर TypeScript में लिखा गया है। क्लोन करें, इंस्टॉल करें, बिल्ड करें और परीक्षण करें:

git clone https://github.com/mailgun/mailgun-mcp-server.git
cd mailgun-mcp-server
npm install
npm run build
npm test

npm run build src/ को dist/ में संकलित करता है और बंडल OpenAPI स्पेक कॉपी करता है। अपने MCP क्लाइंट को npx के बजाय बिल्ट एंट्री पर इंगित करें (एक निरपेक्ष पथ का उपयोग करें):

{
  "mcpServers": {
    "mailgun": {
      "command": "node",
      "args": ["/absolute/path/to/mailgun-mcp-server/dist/mailgun-mcp.js"],
      "env": {
        "MAILGUN_API_KEY": "YOUR-mailgun-api-key"
      }
    }
  }
}

संपादन करते समय लाइव परीक्षण

MCP सर्वर लंबे समय तक चलने वाली stdio प्रक्रियाएँ हैं जो हॉट-रीलोड नहीं होती हैं, इसलिए लूप है: सेव पर पुनर्निर्माण करें, फिर परिवर्तन लेने के लिए क्लाइंट को पुनः कनेक्ट करें।

1. एक बार npm run build चलाएँ ताकि dist/openapi.yaml जगह पर हो।

2. हर सेव पर dist/ के पुनर्निर्माण के लिए TypeScript कंपाइलर चालू रखें:

   npx tsc --watch
   

3. एक अलग MCP क्लाइंट (या नीचे MCP इंस्पेक्टर) को dist/mailgun-mcp.js पर इंगित करें। बदलाव के बाद, नया बिल्ड लोड करने के लिए MCP क्लाइंट सत्र पुनः आरंभ करें।

MCP इंस्पेक्टर के साथ परीक्षण

MCP इंस्पेक्टर आपको बिना पूर्ण क्लाइंट के उपकरणों का अभ्यास करने देता है। पहले बिल्ड करें, फिर इसे बिल्ट सर्वर के विरुद्ध लॉन्च करें:

npm run build
MAILGUN_API_KEY=YOUR-mailgun-api-key npx @modelcontextprotocol/inspector node dist/mailgun-mcp.js

इंस्पेक्टर UI खोलें, Connect पर क्लिक करें, फिर सर्वर के काम करने की पुष्टि करने के लिए List Tools का उपयोग करें। फ़िल्टर किए गए टूलसेट का परीक्षण करने के लिए, सर्वर पथ के बाद फ़्लैग जोड़ें:

MAILGUN_API_KEY=YOUR-mailgun-api-key npx @modelcontextprotocol/inspector node dist/mailgun-mcp.js --tags validate,inspect

प्री-कमिट हुक

npm install एक git प्री-कमिट हुक स्थापित करता है (husky के माध्यम से) जो स्टेज की गई TypeScript/JavaScript फ़ाइलों पर oxlint --fix और oxfmt चलाता है और npm run check:versions चलाता है। ठीक करने योग्य मुद्दे स्वतः ठीक किए जाते हैं और पुनः स्टेज किए जाते हैं; ऐसे कमिट जो न सुधरे जा सकने वाली लिंट त्रुटियाँ या संस्करण-सिंक बेमेल पेश करते हैं, अस्वीकार कर दिए जाते हैं। यदि इस बदलाव से पहले आपके पास पहले से एक स्थानीय क्लोन था, तो हुक स्थापित करने के लिए एक बार npm install चलाएँ।

एंडपॉइंट्स जोड़ने पर ध्यान दें

नया एंडपॉइंट जोड़ते समय यदि आप इसकी परिभाषा के लिए एक सादे स्ट्रिंग का उपयोग करते हैं तो यह डिफ़ॉल्ट रूप से _meta फ़ील्ड में send उत्पाद प्रकार के साथ टैग किया जाएगा। यदि आप इसे एक अलग उत्पाद के रूप में टैग करना चाहते हैं तो EndpointEntry प्रकार के ऑब्जेक्ट संस्करण का उपयोग करें।

सुरक्षा विचार

API कुंजी अलगाव

आपकी Mailgun API कुंजी एक पर्यावरण चर के रूप में पास की जाती है और कभी भी AI मॉडल के सामने उजागर नहीं होती है — इसका उपयोग केवल MCP सर्वर प्रक्रिया द्वारा अनुरोधों को प्रमाणित करने के लिए किया जाता है। सर्वर API कुंजियाँ, अनुरोध पैरामीटर या प्रतिक्रिया डेटा लॉग नहीं करता है।

स्थानीय निष्पादन

सर्वर आपकी मशीन पर स्थानीय रूप से चलता है। Mailgun API के साथ सभी संचार TLS प्रमाणपत्र सत्यापन लागू होने के साथ HTTPS पर होता है। Mailgun API से परे किसी तृतीय-पक्ष सेवा को कोई डेटा नहीं भेजा जाता है।

API कुंजी अनुमतियाँ

एक समर्पित Mailgun API कुंजी का उपयोग करें जिसकी अनुमतियाँ केवल उन्हीं संचालनों तक सीमित हों जिनकी आपको आवश्यकता है। सर्वर पढ़ने और अपडेट करने के संचालन उजागर करता है लेकिन कोई हटाने का संचालन उजागर नहीं करता है, जो अनपेक्षित कार्रवाइयों के विस्फोट त्रिज्या को सीमित करता है।

दर सीमित करना

सर्वर क्लाइंट-साइड दर सीमित करना लागू नहीं करता है। AI से प्रत्येक उपकरण कॉल सीधे Mailgun API अनुरोध में अनुवादित होती है। सर्वर दुरुपयोग को रोकने के लिए Mailgun की सर्वर-साइड दर सीमाओं पर निर्भर करता है — उन सीमाओं से अधिक अनुरोध AI सहायक को एक त्रुटि लौटाएँगे।

प्रॉम्प्ट इंजेक्शन

किसी भी MCP सर्वर की तरह, एक तैयार किया गया या विरोधी प्रॉम्प्ट AI सहायक को ऐसे संचालन कॉल करने के लिए बरगला सकता है जो आपने इरादा नहीं किया था — उदाहरण के लिए, ट्रैकिंग सेटिंग्स संशोधित करना या मेलिंग सूची सदस्यों को पढ़ना। कार्रवाइयों को स्वीकृत करने से पहले अपने AI सहायक की उपकरण-कॉल पुष्टियों की समीक्षा करें, विशेष रूप से अविश्वसनीय प्रॉम्प्ट संदर्भों में।

वेबहुक URL

वेबहुक बनाने और अपडेट करने के संचालन AI सहायक के माध्यम से प्रदान किए गए मनमाने URL स्वीकार करते हैं। MCP सर्वर इन URL को बिना अतिरिक्त मान्यकरण के Mailgun API को पास करता है। Mailgun वेबहुक गंतव्यों को मान्य करने के लिए जिम्मेदार है। सुनिश्चित करें कि आपका AI सहायक अनपेक्षित आंतरिक या संवेदनशील पतों पर वेबहुक URL सेट न करे।

इनपुट मान्यकरण

सभी उपकरण पैरामीटर Zod स्कीमा का उपयोग करके Mailgun OpenAPI विनिर्देश के विरुद्ध मान्य किए जाते हैं। हालाँकि, मान्यकरण OpenAPI स्पेक की सटीकता पर निर्भर करता है, और कुछ किनारे-मामले पैरामीटर अनुमेय मान्यकरण पर वापस आ सकते हैं। Mailgun API सुरक्षा की एक अतिरिक्त परत के रूप में अपना स्वयं का सर्वर-साइड मान्यकरण करता है।

डिबगिंग

MCP सर्वर stdio पर संचार करता है। समस्या निवारण के लिए MCP डिबगिंग गाइड देखें।

लाइसेंस

Apache 2.0 — विवरण के लिए LICENSE देखें।

योगदान

हम योगदान का स्वागत करते हैं! कृपया बेझिझक एक पुल अनुरोध सबमिट करें या एक मुद्दा खोलें।