Wavix

आधिकारिक

Wavix एक वैश्विक संचार प्लेटफॉर्म है जो वॉइस, एसएमएस, 2FA और फोन नंबरों के लिए एपीआई प्रदान करता है। हमारा MCP सर्वर इन क्षमताओं को AI एजेंटों और एजेंटिक वर्कफ़्लो में लाता है।

GitHub

इस MCP को आज़माएँप्रायोजित

Wavix MCP के साथ आप क्या कर सकते हैं?

ट्रांज़ैक्शनल SMS/MMS भेजें — sms_and_mms_messages_send के माध्यम से संदेश भेजने का अनुरोध करें, जिससे संदेश ID और डिलीवरी स्थिति प्राप्त होती है।
2FA सत्यापन फ़्लो चलाएँ — two_fa_verification_create से कोड बनाएँ, फिर two_fa_verification_check से उसे मान्य करें।
फ़ोन नंबर खोजें और खरीदें — buy_numbers_list से उपलब्ध नंबर खोजें, cart_add से कार्ट में जोड़ें, और cart_checkout से खरीद पूरी करें।
कॉल ट्रांसक्रिप्ट खोजें — cdrs_search का उपयोग करके ट्रांसक्रिप्शन कीवर्ड से कॉल खोजें, फिर cdrs_get से परिणाम समृद्ध करें।
रिकॉर्डिंग प्राप्त करें और ट्रांसक्राइब करें — call_recording_get से रिकॉर्डिंग प्राप्त करें, cdrs_retranscribe से ट्रांसक्रिप्शन का अनुरोध करें, और cdrs_transcription_get से परिणाम लाएँ।
बिलिंग और इनवॉइस का ऑडिट करें — billing_transactions_list से खर्च की समीक्षा करें और billing_invoices_download से इनवॉइस PDF डाउनलोड करें।

दस्तावेज़

Wavix MCP सर्वर

एक Model Context Protocol सर्वर जो LLMs और AI एजेंट्स को Wavix टेलीकॉम प्लेटफ़ॉर्म तक सीधी पहुँच देता है — SMS/MMS, वॉइस कॉल, 2FA, SIP ट्रंकिंग, फ़ोन नंबर प्रबंधन, 10DLC पंजीकरण, कॉल रिकॉर्डिंग, स्पीच एनालिटिक्स, और बिलिंग।

Wavix एक वैश्विक संचार प्लेटफ़ॉर्म है जो एक ही API के माध्यम से SMS भेजने, वॉइस कॉल करने और 2FA फ़्लो चलाने के लिए है। एक निःशुल्क ट्रायल उपलब्ध है; भुगतान किया गया उपयोग आपके खाते से जुड़ी Wavix मूल्य निर्धारण योजना के अनुसार होता है।

इस MCP सर्वर का उपयोग करने का सबसे तेज़ तरीका https://mcp.wavix.com/mcp पर होस्टेड एंडपॉइंट है — किसी भी MCP-संगत क्लाइंट को उस पर इंगित करें और अपनी Wavix API कुंजी से प्रमाणित करें। यदि आपको स्वयं-होस्ट करने की आवश्यकता है (कस्टम Wavix डिप्लॉयमेंट, फ़ायरवॉल के पीछे, समर्पित इंस्टेंस), तो अपना खुद का चलाएँ देखें।

विषय-सूची

एंडपॉइंट
इंस्टॉल — वन-क्लिक, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
अपना खुद का चलाएँ (सेल्फ-होस्ट)
उदाहरण
टूल्स → TOOLS.md में पूरी सूची
संसाधन
प्रमाणीकरण (सर्वोत्तम अभ्यास, यदि टोकन से समझौता हो)
समस्या निवारण
संगतता और सीमाएँ
सहायता, योगदान, सुरक्षा, लाइसेंस

एंडपॉइंट

फ़ील्ड	मान
URL	`https://mcp.wavix.com/mcp`
ट्रांसपोर्ट	Streamable HTTP
प्रमाणीकरण	`Authorization: Bearer <api_key>`
टूल्स	TOOLS.md देखें
संसाधन	Wavix दस्तावेज़ + OpenAPI स्पेक (स्वतः-खोजे गए)

Wavix Console → Administration → API keys → Create new से Wavix API कुंजी प्राप्त करें।

इंस्टॉल

शुरू करने से पहले: अपनी Wavix API कुंजी प्राप्त करें।

https://wavix.com पर साइन इन करें।
Administration → API keys खोलें।
Create new पर क्लिक करें (या कोई मौजूदा कुंजी कॉपी करें)। इसे पास रखें — आप इसे नीचे YOUR_API_KEY के स्थान पर पेस्ट करेंगे।

वन-क्लिक इंस्टॉल

⚠️ नीचे दिए गए बटन आपके एडिटर के MCP कॉन्फ़िग में एक प्लेसहोल्डर टोकन YOUR_API_KEY डालते हैं। एडिटर इंस्टॉल पूरा करने के बाद, जनरेट किया गया कॉन्फ़िग खोलें और कोई भी अनुरोध भेजने से पहले प्लेसहोल्डर को अपनी वास्तविक API कुंजी से बदलें — अन्यथा हर कॉल 401 Unauthorized लौटाएगी।

बाद में हटाने के लिए: वही कॉन्फ़िग फ़ाइल खोलें (~/.cursor/mcp.json, .vscode/mcp.json, या आपके एडिटर के समकक्ष) और wavix प्रविष्टि हटा दें, या अपने एडिटर के MCP / Connectors UI के माध्यम से कनेक्टर हटाएँ।

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

सत्यापित करने के लिए claude mcp list और सत्र के अंदर स्थिति के लिए /mcp का उपयोग करें।

Claude Desktop / Claude Web

Settings → Connectors → Add custom connector:

नाम: Wavix
URL: https://mcp.wavix.com/mcp
ट्रांसपोर्ट: Streamable HTTP
प्रमाणीकरण हेडर: Authorization: Bearer <api_key>

Cursor (मैनुअल)

~/.cursor/mcp.json में जोड़ें (या प्रोजेक्ट-स्तरीय .cursor/mcp.json):

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ पूरी सूची दिखाता है; पुराने संस्करण 40 पर सीमित होते हैं।

VS Code (मैनुअल, GitHub Copilot Chat)

अपने वर्कस्पेस में .vscode/mcp.json बनाएँ (या उपयोगकर्ता settings.json में "mcp" कुंजी के अंतर्गत वही servers ऑब्जेक्ट जोड़ें):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

अद्यतन स्कीमा के लिए VS Code MCP सर्वर गाइड देखें।

Codex CLI

Codex CLI stdio पर MCP का समर्थन करता है। mcp-remote के माध्यम से होस्टेड सर्वर से ब्रिज करें। ~/.codex/config.toml संपादित करें:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / अन्य क्लाइंट

कोई भी MCP क्लाइंट जो कस्टम हेडर के साथ Streamable HTTP ट्रांसपोर्ट का समर्थन करता है, काम करेगा। उपयोग करें:

URL: https://mcp.wavix.com/mcp
हेडर: Authorization: Bearer <api_key>

किसी AI एजेंट के माध्यम से सेटअप कर रहे हैं? अपने एजेंट को llms-install.md पर इंगित करें — यह एक मशीन-पठनीय इंस्टॉल गाइड है जो मॉडल को निर्धारित प्रारूप में URL, हेडर और प्रति-क्लाइंट कॉन्फ़िगरेशन देता है ताकि वह एंडपॉइंट मानों का अनुमान न लगाए।

अपना खुद का चलाएँ

होस्टेड सर्वर अधिकांश उपयोगकर्ताओं के लिए आउट-ऑफ-द-बॉक्स काम करता है। यदि आपको किसी गैर-सार्वजनिक Wavix डिप्लॉयमेंट को इंगित करना है, फ़ायरवॉल के पीछे चलाना है, या अपने स्वयं के इन्फ्रास्ट्रक्चर के अंदर संचालित करना है, तो सेल्फ-होस्ट करें।

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

सर्वर पोर्ट 8000 पर सुनता है और /mcp पर MCP एंडपॉइंट प्रदर्शित करता है। अपने क्लाइंट को http://<host>:8000/mcp पर इंगित करें।

स्रोत से

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Python 3.10+ आवश्यक है।

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

Env var	डिफ़ॉल्ट	उद्देश्य
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	अपस्ट्रीम Wavix API एंडपॉइंट को ओवरराइड करें (आंतरिक डिप्लॉयमेंट या स्टेजिंग के लिए)

सर्वर को चलाने के लिए कोई Wavix क्रेडेंशियल आवश्यक नहीं हैं — वे प्रति-अनुरोध MCP क्लाइंट के Authorization: Bearer <api_key> हेडर से अग्रेषित किए जाते हैं। सेल्फ-होस्टर्स सर्वर को सार्वजनिक रूप से प्रदर्शित करने से पहले उसके सामने TLS समाप्त करने के लिए जिम्मेदार हैं (nginx, Caddy, क्लाउड लोड बैलेंसर)।

उदाहरण

ठोस प्रॉम्प्ट जिन्हें आप किसी भी कनेक्टेड क्लाइंट में डाल सकते हैं।

नीचे दिए गए फ़ोन नंबर (+1 310 555 0100, +44 7700 900123) आरक्षित परीक्षण श्रेणियों (NANP 555 और Ofcom 070 09xx) में हैं — शब्दशः कॉपी करना सुरक्षित है, उनके माध्यम से कोई वास्तविक ग्राहक पहुँच योग्य नहीं है।

ट्रांज़ैक्शनल SMS भेजें

प्रॉम्प्ट: "Send an SMS from +13105550100 to +447700900123 saying 'Your verification code is 4821'."

एजेंट sms_and_mms_messages_send को from, to, और text के साथ कॉल करता है। संदेश ID और डिलीवरी स्थिति लौटाता है।

2FA सत्यापन चलाएँ

प्रॉम्प्ट: "Send a 2FA verification code to +13105550100 via SMS. When I give you the code I receive, check whether it's correct."

एजेंट two_fa_verification_create को कॉल करता है, आपके द्वारा SMS के माध्यम से प्राप्त कोड साझा करने की प्रतीक्षा करता है, फिर two_fa_verification_check को कॉल करता है। बिना इंटीग्रेशन कोड लिखे पासवर्डलेस फ़्लो का प्रोटोटाइप बनाने के लिए उपयोगी है।

फ़ोन नंबर खोजें और खरीदें

प्रॉम्प्ट: "Find an available US toll-free number with SMS capability, add it to my cart, and check out."

एजेंट buy_numbers_list (देश और सुविधा द्वारा फ़िल्टर करना), cart_add, और cart_checkout को श्रृंखलित करता है। चेकआउट से पहले उपयोगकर्ता से पुष्टि करें — यह खाते से शुल्क लेता है।

कॉल ट्रांसक्रिप्ट खोजें

प्रॉम्प्ट: "Show me all inbound calls from yesterday longer than two minutes where the caller mentioned 'refund'."

एजेंट ट्रांसक्रिप्शन के विरुद्ध cdrs_search का उपयोग करता है, फिर पूर्ण कॉल मेटाडेटा के लिए प्रत्येक परिणाम को cdrs_get के माध्यम से समृद्ध करता है।

रिकॉर्डिंग खींचें और ट्रांसक्राइब करें

प्रॉम्प्ट: "Get the recording for call abc-123, ask Wavix to transcribe it, and return the transcription."

एजेंट call_recording_get (प्री-साइन किया गया डाउनलोड URL लौटाता है), cdrs_retranscribe को कॉल करता है, फिर cdrs_transcription_get को पोल करता है।

बिलिंग ऑडिट

प्रॉम्प्ट: "How much did we spend on SMS last month? Give me a download link for the most recent invoice PDF."

एजेंट प्रकार और दिनांक द्वारा फ़िल्टर किए गए billing_transactions_list को कॉल करता है, फिर billing_invoices_list + billing_invoices_download को। डाउनलोड टूल PDF के लिए प्री-साइन किया गया URL लौटाता है, फ़ाइल स्वयं नहीं — वास्तविक दस्तावेज़ प्राप्त करने के लिए URL को ब्राउज़र में खोलें या अपने क्लाइंट को दें।

टूल्स

Wavix OpenAPI स्पेक से उत्पन्न 122 टूल्स। तर्क अनुरोध पैरामीटर और बॉडी फ़ील्ड को प्रतिबिंबित करते हैं।

समूह	#	कवरेज
SMS और MMS	10	संदेश भेजें, सूचीबद्ध करें, प्राप्त करें; प्रेषक ID; ऑप्ट-आउट
कॉल नियंत्रण	9	कॉल शुरू / उत्तर / समाप्त करें; ऑडियो चलाएँ; DTMF एकत्र करें
कॉल रिकॉर्डिंग	4	सूचीबद्ध करें, डाउनलोड करें (प्री-साइन URL), हटाएँ
कॉल स्ट्रीमिंग	2	मीडिया स्ट्रीम शुरू / बंद करें
कॉल वेबहुक	3	सूचीबद्ध करें, बनाएँ, हटाएँ
CDR	7	सूचीबद्ध करें, निर्यात करें, प्राप्त करें; ट्रांसक्रिप्शन खोज और पुनः-ट्रांसक्राइब
स्पीच एनालिटिक्स	4	अपलोड, ट्रांसक्राइब, मूल फ़ाइल प्राप्त करें
2FA	6	सत्यापन बनाएँ / जाँचें / रद्द करें / पुनः भेजें; ईवेंट
मेरे नंबर	6	सूचीबद्ध करें, अपडेट करें, रिलीज़ करें; SMS / वॉइस रूटिंग; दस्तावेज़ अपलोड
खरीदें	5	देश, क्षेत्र, शहर; उपलब्ध नंबर खोज
कार्ट	4	जोड़ें, हटाएँ, प्राप्त करें, चेकआउट
नंबर वैलिडेटर	3	एकल और बल्क सत्यापन
SIP ट्रंक	5	पूर्ण CRUD
10DLC	30	ब्रांड, कैंपेन, वेटिंग, साक्ष्य, ईवेंट सब्सक्रिप्शन
प्रोफ़ाइल	3	प्रोफ़ाइल प्राप्त / अपडेट करें; खाता कॉन्फ़िग
API कुंजियाँ	4	सूचीबद्ध करें, बनाएँ, सक्रिय / निष्क्रिय करें, हटाएँ
उप-खाते	5	सूचीबद्ध करें, बनाएँ, प्राप्त करें, अपडेट करें; लेनदेन
बिलिंग	3	लेनदेन, चालान, स्टेटमेंट डाउनलोड
वॉइस कैंपेन	2	ट्रिगर करें और प्राप्त करें
Wavix Embeddable (WebRTC)	5	विजेट टोकन CRUD
लिंक शॉर्टनर	2	शॉर्ट लिंक बनाएँ; मेट्रिक्स

पूरी टूल सूची एक-पंक्ति विवरण के साथ देखने के लिए TOOLS.md देखें। प्रामाणिक स्रोत Wavix OpenAPI स्पेक है — आपका क्लाइंट हमेशा वर्तमान लाइव सूची देखता है।

संसाधन

टूल्स के अतिरिक्त, सर्वर Wavix दस्तावेज़ीकरण को MCP संसाधनों के रूप में प्रदर्शित करता है, ताकि मॉडल पिछले ज्ञान से अनुमान लगाने के बजाय माँग पर प्रामाणिक संदर्भ खींच सके।

URI स्कीम	सामग्री
`wavix://docs/<path>`	docs.wavix.com से दस्तावेज़ीकरण पृष्ठ (`llms.txt` के माध्यम से स्वतः-खोजे गए)।
`wavix://api/openapi.yaml`	पूर्ण Wavix OpenAPI 3.0 स्पेकिफिकेशन।

दोनों स्रोत — docs.wavix.com और Wavix OpenAPI स्पेक — सार्वजनिक रूप से उपलब्ध हैं और बिना प्रमाणीकरण के सीधे ब्राउज़ किए जा सकते हैं।

संसाधन resources/read पर आलसी रूप से लाए जाते हैं और सर्वर-साइड पर 1-घंटे के TTL के साथ कैश किए जाते हैं। अपस्ट्रीम Bearer टोकन दस्तावेज़ीकरण होस्ट्स को कभी अग्रेषित नहीं किया जाता — केवल api.wavix.com को।

प्रमाणीकरण

क्लाइंट से प्रत्येक अनुरोध में शामिल होना चाहिए:

Authorization: Bearer <api_key>

सर्वर इस हेडर को प्रति-अनुरोध api.wavix.com पर अग्रेषित करता है। टोकन:

कभी लॉग नहीं किया जाता,
क्रॉस-होस्ट रीडायरेक्ट पर कभी अग्रेषित नहीं किया जाता (जैसे प्री-साइन किए गए S3 डाउनलोड URL),
दस्तावेज़ीकरण होस्ट्स को कभी नहीं भेजा जाता।

यदि आपका क्लाइंट call_recording_get, billing_invoices_download, speech_analytics_file_get, या ten_dlc_brand_evidence_get द्वारा लौटाए गए प्री-साइन किए गए डाउनलोड URL का अनुसरण करता है, तो इसे Authorization हेडर के बिना सीधे प्राप्त करें।

सर्वोत्तम अभ्यास

MCP के लिए एक समर्पित API कुंजी उपयोग करें। https://wavix.com → Administration → API keys पर एक अलग API कुंजी बनाएँ (या किसी अन्य सत्र से api_keys_create टूल के माध्यम से)। यह आपको अन्य इंटीग्रेशन को बाधित किए बिना MCP पहुँच रद्द करने की अनुमति देता है।
समय-समय पर रोटेट करें। API कुंजी को किसी भी उत्पादन रहस्य की तरह मानें: निर्धारित समय पर और किसी भी लीक के संदेह पर रोटेट करें।
API कुंजियों को git से दूर रखें। MCP क्लाइंट कॉन्फ़िग को गलती से कमिट करना आसान है, टोकन को अपने साथ इतिहास और CI लॉग में ले जाता है। अधिकांश क्लाइंट हेडर मान में ${env:VAR} प्रतिस्थापन का समर्थन करते हैं — API कुंजी को env var या अपने OS कीचेन में संग्रहीत करें और इसे कॉन्फ़िग से संदर्भित करें। सुरक्षा जाल के रूप में, सामान्य क्लाइंट-कॉन्फ़िग पथों को अपने प्रोजेक्ट के .gitignore में जोड़ें:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

यदि टोकन से समझौता हो

Wavix कंसोल में, कुंजी को तुरंत निष्क्रिय करें (या api_keys_deactivate को कॉल करें)।
api_keys_create या कंसोल के माध्यम से एक प्रतिस्थापन बनाएँ।
क्लाइंट का कॉन्फ़िग अपडेट करें और पुनः कनेक्ट करें।
अप्रत्याशित गतिविधि के लिए billing_transactions_list और cdrs_list की समीक्षा करें।

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

लक्षण	संभावित कारण / समाधान
किसी भी टूल से `401 Unauthorized`	`Authorization: Bearer …` हेडर गुम या अमान्य है। Wavix कंसोल में API कुंजी सक्रिय है, यह सत्यापित करें।
टूल `download_url` लौटाता है, न कि फ़ाइल स्वयं	अपेक्षित है। रिकॉर्डिंग, इनवॉइस, स्पीच-एनालिटिक्स और 10DLC साक्ष्य एंडपॉइंट प्री-साइन किए गए URL लौटाते हैं (देखें प्रमाणीकरण)। बिना `Authorization` हेडर के URL सीधे लाएँ।
क्लाइंट केवल ~40 टूल दिखाता है, पूरी सूची नहीं	पुराने क्लाइंट प्रति-सर्वर टूल सीमा लागू करते हैं। अपग्रेड करें (Cursor 2.4+, नवीनतम VS Code, नवीनतम Claude)।
इस README में सूचीबद्ध किसी टूल के लिए `Tool not found`	स्थानीय क्लाइंट पुरानी टूल सूची कैश कर रहा हो सकता है। क्लाइंट पुनः प्रारंभ करें, या सर्वर को हटाकर फिर से जोड़ें।
`errors` सरणी के साथ 4xx	Wavix API से मान्यता त्रुटि। `errors` निरीक्षण करें; संबंधित `wavix://docs/*` पृष्ठ या OpenAPI विनिर्देश से क्रॉस-रेफरेंस करें।
सर्वर तक पहुँच असंभव	`mcp.wavix.com:443` के लिए DNS और आउटबाउंड HTTPS सत्यापित करें।
एजेंट अप्रत्याशित रूप से विनाशकारी टूल कॉल करता है	अधिकांश क्लाइंट टूल कॉल से पहले पुष्टि की माँग कर सकते हैं — उस सेटिंग को सक्षम करें और समर्पित MCP API कुंजी का उपयोग करें (देखें सर्वोत्तम अभ्यास)।

संगतता और सीमाएँ

Streamable HTTP परिवहन (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, कस्टम MCP SDK) का समर्थन करने वाले किसी भी MCP क्लाइंट के साथ संगत, और MCP क्लाइंट एडेप्टर वाले किसी भी एजेंट फ्रेमवर्क के साथ।
पुराने क्लाइंट प्रति-सर्वर टूल सीमा लागू कर सकते हैं; पूरी सूची तक पहुँचने के लिए नवीनतम संस्करण में अपग्रेड करें।
दर सीमाएँ और उपयोग शुल्क आपके Wavix खाते की योजना के अनुसार हैं। देखें Wavix मूल्य निर्धारण।

परिवर्तन लॉग

होस्ट किया गया सर्वर Wavix OpenAPI विनिर्देश के विकसित होने के साथ निरंतर अपडेट होता है; नए टूल स्वचालित रूप से दिखाई देते हैं और मौजूदा टूल तर्कों में वैकल्पिक फ़ील्ड जुड़ सकती हैं। इस रिपॉजिटरी के दस्तावेज़ परिवर्तन रिलीज़ के अंतर्गत ट्रैक किए जाते हैं। टूल इनपुट या प्रमाणीकरण को प्रभावित करने वाले महत्वपूर्ण व्यवहार परिवर्तनों के लिए, हम वहाँ और Wavix रिलीज़ नोट्स दोनों में सूचना प्रकाशित करेंगे।

समर्थन

उत्पाद दस्तावेज़: https://docs.wavix.com
API संदर्भ: https://docs.wavix.com/api-reference
प्रश्न / प्रतिक्रिया: support@wavix.com

योगदान

यह रिपॉजिटरी स्रोत-उपलब्ध है लेकिन बाहरी योगदान के लिए खुला नहीं है। पुल रिक्वेस्ट स्वतः बंद कर दी जाती हैं, और Issues / Discussions अक्षम हैं। बग रिपोर्ट, सुविधा अनुरोध और प्रतिक्रिया support@wavix.com पर भेजें। विवरण के लिए देखें CONTRIBUTING.md।

यदि आपको अंतर्निहित FastMCP फ्रेमवर्क में बग मिलता है, तो कृपया इसे वहाँ ऊपर रिपोर्ट करें।

सुरक्षा

सुरक्षा भेद्यता की रिपोर्ट करने के लिए, कृपया support@wavix.com पर विषय Security: <short summary> के साथ ईमेल करें, न कि सार्वजनिक मुद्दा खोलें। विवरण के लिए देखें SECURITY.md।