Wavix

आधिकारिक

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

GitHub

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

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

दस्तावेज़

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 खाते से साइन इन करके या Wavix API कुंजी के साथ कनेक्ट करें। यदि आपको स्वयं-होस्ट करने की आवश्यकता है (कस्टम Wavix डिप्लॉयमेंट, फ़ायरवॉल के पीछे, समर्पित इंस्टेंस), तो अपना स्वयं का चलाएँ देखें।

विषय-सूची

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

एंडपॉइंट

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

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

इंस्टॉल

कनेक्ट करने के दो तरीके — जो भी आपका क्लाइंट समर्थन करता है उसे चुनें; दोनों में से कोई भी दूसरे पर आवश्यक नहीं है।

Wavix खाते से साइन इन करें

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

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>

साइन इन करके कनेक्ट करने के लिए, बिना प्रमाणीकरण हेडर के कनेक्टर जोड़ें और क्लाइंट के संकेत देने पर अपने Wavix खाते से साइन इन करें।

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 एंडपॉइंट को ओवरराइड करें (आंतरिक डिप्लॉयमेंट या स्टेजिंग के लिए)
`OAUTH_ISSUER`	unset	OAuth 2.1 प्राधिकरण सर्वर का बेस URL। इसकी JWKS `<issuer>/.well-known/jwks.json` से पढ़ी जाती है
`OAUTH_RESOURCE`	unset	सार्वजनिक बेस URL जिस पर यह सर्वर पहुँचा जाता है, संसाधन पहचानकर्ता के रूप में उपयोग किया जाता है
`OAUTH_API_KEY_PASSTHROUGH`	`true`	OAuth चालू होने पर, एक बियरर जो OAuth JWT नहीं है उसे स्वीकार करें और अपस्ट्रीम भेजें (API कुंजियाँ काम करती रहती हैं)। JWT की आवश्यकता के लिए `false` सेट करें
`MCP_PATH`	`/mcp`	वह पथ जिस पर MCP एंडपॉइंट परोसा जाता है

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

OAuth 2.1 (वैकल्पिक)

सर्वर को OAuth 2.1 संरक्षित संसाधन में बदलने के लिए OAUTH_ISSUER और OAUTH_RESOURCE को एक साथ सेट करें। यह तब RFC 9728 मेटाडेटा को /.well-known/oauth-protected-resource<MCP_PATH> पर प्रकाशित करता है, आने वाले एक्सेस टोकन को जारीकर्ता की JWKS के विरुद्ध JWT के रूप में मान्य करता है, और अनधिकृत अनुरोधों का उत्तर उस मेटाडेटा की ओर इंगित करते हुए WWW-Authenticate चुनौती के साथ देता है। OAuth का समर्थन करने वाले MCP क्लाइंट इसका उपयोग प्राधिकरण फ़्लो स्वयं चलाने के लिए करते हैं, इसलिए उपयोगकर्ताओं को अब अपने क्लाइंट कॉन्फ़िग में API कुंजी पेस्ट नहीं करनी पड़ती।

प्रत्येक टोकन को ले जाना चाहिए वह दर्शक OAUTH_RESOURCE + MCP_PATH है, जो मेटाडेटा में प्रकाशित resource मान भी है। RFC 8707 लागू करने वाले प्राधिकरण सर्वर क्लाइंट के resource पैरामीटर की तुलना उस स्ट्रिंग से ठीक उसी तरह करते हैं, इसलिए दोनों को मेल खाने के लिए कॉन्फ़िगर किया जाना चाहिए — पथ सहित।

OAuth सक्षम करना उन क्लाइंट्स को काटता नहीं है जो Wavix API कुंजी से प्रमाणित होते हैं। एक बियरर टोकन जो मान्य OAuth JWT नहीं है, बिना सत्यापित अपस्ट्रीम भेजा जाता है, ठीक पहले की तरह, Wavix API को उस पर एकमात्र प्राधिकरण छोड़ते हुए — इसलिए एक मौजूदा डिप्लॉयमेंट नए क्लाइंट्स के लिए OAuth चालू कर सकता है बिना पहले से जुड़े क्लाइंट्स को तोड़े। बिना किसी टोकन के अनुरोध को अभी भी WWW-Authenticate चुनौती मिलती है, जो OAuth-सक्षम क्लाइंट को प्राधिकरण सर्वर खोजने देती है। केवल OAuth-प्रमाणित कनेक्शन ही स्कोप-फ़िल्टर किए जाते हैं; एक API-कुंजी कनेक्शन पूरी टूल सतह देखता है।

उस फ़ॉलबैक को हटाने और एक मान्य JWT की आवश्यकता के लिए OAUTH_API_KEY_PASSTHROUGH=false सेट करें — सख्त मोड जिस पर API-कुंजी पहुँच सेवानिवृत्त होने के बाद स्विच करना है।

OAUTH_ISSUER / OAUTH_RESOURCE में से किसी को भी unset छोड़ना पिछला व्यवहार बनाए रखता है: कोई मेटाडेटा प्रकाशित नहीं होता और क्लाइंट द्वारा भेजा गया जो भी बियरर टोकन बिना सत्यापित अपस्ट्रीम भेजा जाता है।

उदाहरण

किसी भी कनेक्टेड क्लाइंट में डालने योग्य ठोस प्रॉम्प्ट।

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

एक लेन-देन संबंधी SMS भेजें

प्रॉम्प्ट: "+13105550100 से +447700900123 पर 'आपका सत्यापन कोड 4821 है' कहते हुए एक SMS भेजें।"

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

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

प्रॉम्प्ट: "+13105550100 पर SMS के माध्यम से एक 2FA सत्यापन कोड भेजें। जब मैं आपको प्राप्त कोड दूँ, तो जाँचें कि क्या यह सही है।"

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

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

प्रॉम्प्ट: "SMS क्षमता वाला एक उपलब्ध US टोल-फ्री नंबर खोजें, इसे मेरी कार्ट में जोड़ें, और चेकआउट करें।"

एजेंट buy_numbers_list (देश और सुविधा द्वारा फ़िल्टर करके), cart_add, और cart_checkout को श्रृंखलाबद्ध करता है। cart_checkout पहले नंबरों और उनके शुल्कों के साथ एक पूर्वावलोकन लौटाता है, और खाते को तभी चार्ज करता है जब उसके confirmation_token के साथ फिर से कॉल किया जाता है।

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

प्रॉम्प्ट: "मुझे कल के सभी इनबाउंड कॉल दिखाएँ जो दो मिनट से अधिक लंबे हैं जहाँ कॉलर ने 'रिफंड' का उल्लेख किया।"

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

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

प्रॉम्प्ट: "कॉल abc-123 के लिए रिकॉर्डिंग प्राप्त करें, Wavix से इसे ट्रांसक्राइब करने के लिए कहें, और ट्रांसक्रिप्शन लौटाएँ।"

एजेंट call_recording_get_by_call (एक पूर्व-हस्ताक्षरित डाउनलोड URL लौटाता है), cdrs_retranscribe को कॉल करता है, फिर cdrs_transcription_get को पोल करता है।

बिलिंग ऑडिट करें

प्रॉम्प्ट: "पिछले महीने हमने SMS पर कितना खर्च किया, और कौन से इनवॉइस जारी किए गए?"

एजेंट प्रकार और तिथि द्वारा फ़िल्टर किए गए billing_transactions_list को कॉल करता है, फिर billing_invoices_list को। इनवॉइस PDF को स्वयं डाउनलोड करना MCP पर प्रदर्शित नहीं है — इसे Wavix API या डैशबोर्ड से प्राप्त करें।

टूल्स

Wavix OpenAPI स्पेक से जनरेट किया गया। तर्क अनुरोध पैरामीटर और बॉडी फ़ील्ड को दर्शाते हैं। दिखाए गए टूल्स उन अनुमतियों पर निर्भर करते हैं जिन्हें आप साइन-इन पर स्वीकृत करते हैं और आपके खाते पर सक्षम सुविधाएँ।

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

पूर्ण टूल सूची एक-पंक्ति विवरण के साथ देखने के लिए 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 को।

प्रमाणीकरण

होस्टेड सर्वर दो कनेक्शन विधियाँ स्वीकार करता है — कोई भी प्राथमिकता नहीं है:

Wavix खाते से साइन इन करें (OAuth 2.1)। OAuth-सक्षम क्लाइंट के लिए। क्लाइंट प्राधिकरण प्रवाह चलाता है और उपयोगकर्ता साइन इन करता है; कोई API कुंजी संग्रहीत नहीं होती। पहुंच उस तक सीमित होती है जिसे उपयोगकर्ता स्वीकृत करता है और उनकी खाता भूमिका अनुमति देती है। Wavix खाते से साइन इन करें देखें।
Wavix API कुंजी (Bearer)। किसी भी Streamable-HTTP क्लाइंट के लिए। प्रत्येक अनुरोध में शामिल होना चाहिए:

Authorization: Bearer <api_key>

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

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

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

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

MCP के लिए समर्पित API कुंजी का उपयोग करें। https://wavix.com → प्रशासन → API कुंजियाँ पर एक अलग 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
```

यदि कोई क्रेडेंशियल समझौता हो जाए

यदि आपने API कुंजी से कनेक्ट किया है:

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

यदि आपने अपने Wavix खाते से साइन इन करके कनेक्ट किया है:

Wavix पोर्टल के अनुदान-प्रबंधन पृष्ठ से कनेक्शन रद्द करें, जो आपके द्वारा अधिकृत कनेक्शनों को सूचीबद्ध करता है और आपके चुने हुए को रद्द करता है — यह उस कनेक्शन के टोकन को अमान्य कर देता है। कोई API कुंजी शामिल नहीं है।
पुनः कनेक्ट करें और फिर से साइन इन करें।

किसी भी स्थिति में, अप्रत्याशित गतिविधि के लिए billing_transactions_list और cdrs_list की समीक्षा करें।

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

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

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

Streamable HTTP परिवहन का समर्थन करने वाले किसी भी MCP क्लाइंट के साथ संगत (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, कस्टम MCP SDK) और MCP क्लाइंट एडाप्टर वाले किसी भी एजेंट फ्रेमवर्क के साथ।
destructiveHint के साथ एनोटेट किया गया प्रत्येक टूल, साथ ही call_webhooks_create, sip_trunks_update और sub_accounts_update, दो चरणों में चलता है: पहला कॉल एक पूर्वावलोकन और एकल-उपयोग confirmation_token (5 मिनट के लिए वैध) लौटाता है, और क्रिया केवल तब चलती है जब टूल को समान तर्कों और उस टोकन के साथ फिर से कॉल किया जाता है। कोई भी 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 फ्रेमवर्क में बग मिलता है, तो कृपया इसे वहां अपस्ट्रीम रिपोर्ट करें।

सुरक्षा

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