मुख्य सामग्री पर जाएं

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Model Context Protocol (MCP) is an open standard that enables AI applications to securely connect to external data sources and APIs. The Dodo Payments MCP Server provides AI assistants like Claude, Cursor, and other MCP-compatible clients with structured access to your payment infrastructure. Dodo Payments MCP सर्वर कोड मोड वास्तुकला का उपयोग करता है। प्रत्येक API एंडपॉइंट के लिए सैकड़ों व्यक्तिगत टूल्स को उजागर करने के बजाय, कोड मोड AI एजेंट्स को अलग संडबॉक्स वातावरण में Dodo Payments SDK के खिलाफ TypeScript कोड लिखने और निष्पादित करने में सक्षम बनाता है।

Key capabilities

  • Payment Operations: Create, retrieve, and manage payments and refunds
  • Subscription Management: Handle recurring billing, upgrades, and cancellations
  • Customer Administration: Manage customer data and portal access
  • Product Catalog: Create and update products, pricing, and discounts
  • License Management: Activate, validate, and manage software licenses
  • Usage-Based Billing: Track and bill for metered usage

How Code Mode Works

Dodo Payments MCP सर्वर आपके AI एजेंट को केवल दो टूल्स प्रदान करता है:
  1. डॉक्स सर्च टूल: Dodo Payments API और SDK के बारे में डॉक्स को क्वेरी करता है ताकि उपलब्ध ऑपरेशंस और पैरामीटर समझे जा सकें।
  2. कोड निष्पादन टूल: SDK के खिलाफ TypeScript कोड लिखता है जो सुरक्षित संडबॉक्स परिवेश में निष्पादित होता है।
यह वास्तुकला एजेंट्स को एकल इनवोकेशन में जटिल, बहु-चरण ऑपरेशंस करने की अनुमति देती है। उदाहरण के लिए, एक एजेंट सभी सक्रिय सब्सक्रिप्शन सूचीबद्ध कर सकता है, उन्हें विशिष्ट मानदंडों के आधार पर फ़िल्टर कर सकता है, और प्रत्येक पर छूट लागू कर सकता है—सब एक ही स्क्रिप्ट में।
कोड मोड का उपयोग करके, एजेंट कई API कॉल्स को चेन कर सकते हैं, सशर्त तर्क संभाल सकते हैं, और गणनाएँ कर सकते हैं बिना LLM के साथ कई राउंड-ट्रिप्स की आवश्यकता के।

त्वरित सेटअप

अपने AI क्लाइंट में Dodo Payments MCP सर्वर से कनेक्ट करें:
Node.js 18 या उच्चतर की आवश्यकता है। रिमोट सर्वर OAuth का उपयोग करके प्रमाणीकरण करता है — पहली बार कनेक्शन पर आपको अपनी API कुंजी दर्ज करने और अपने वातावरण का चयन करने के लिए कहा जाएगा।

Dodo Knowledge MCP

Dodo Payments MCP Server (API संचालन निष्पादित करने के लिए) के अतिरिक्त, हम Dodo Knowledge MCP—एक समानार्थी खोज सर्वर प्रदान करते हैं जो AI सहायकों को Dodo Payments प्रलेखन और ज्ञान आधार तक तत्काल पहुँच प्रदान करता है।
ContextMCP.ai के साथ निर्मित**: Dodo Knowledge MCP ContextMCP द्वारा संचालित है, जो हमारे दस्तावेज़ीकरण में तेज़ समानार्थी खोज को सक्षम करता है।

Dodo Knowledge MCP क्या है?

Dodo Knowledge MCP एक रिमोट MCP सर्वर है जो प्रदान करता है:
  • समानार्थी दस्तावेज़ खोज: प्राकृतिक भाषा क्वेरी का उपयोग करके प्रासंगिक दस्तावेज़ीकरण खोजें।
  • प्रासंगिक उत्तर: AI सहायकों को Dodo Payments के बारे में सटीक, अद्यतन जानकारी मिलती है।
  • शून्य सेटअप: कोई API कुंजियाँ या स्थानीय स्थापना आवश्यक नहीं—बस कनेक्ट करें और पूछताछ शुरू करें।

त्वरित सेटअप

अपने AI क्लाइंट में Dodo Knowledge MCP से कनेक्ट करें:
Add to ~/.cursor/mcp.json:
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    }
  }
}
Node.js 18 या उच्चतर की आवश्यकता है। mcp-remote पैकेज रिमोट MCP सर्वर से कनेक्शन को संभालता है।

दोनों MCP सर्वरों का एक साथ उपयोग करना

सर्वोत्तम AI-सहायता प्राप्त विकास अनुभव के लिए, हम दोनों MCP सर्वरों का उपयोग करने की अनुशंसा करते हैं:
सर्वरउद्देश्यउपयोग का मामला
Dodo Knowledge MCPदस्तावेज़ खोज”मैं वेबहुक्स को कैसे संभालूँ?”, “कौन से भुगतान तरीके समर्थित हैं?”
Dodo Payments MCPAPI संचालनभुगतान बनाएं, सदस्यताओं का प्रबंधन करें, रिफंड को संभालें
{
  "mcpServers": {
    "dodo-knowledge": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://knowledge.dodopayments.com/mcp"]
    },
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
दोनों सर्वरों को कॉन्फ़िगर करने के बाद, आपका AI सहायक पहले फीचर को लागू करने की प्रक्रिया को समझने के लिए दस्तावेज़ खोज सकता है, फिर वास्तविक API कॉल्स को निष्पादित कर सकता है - यह सब एक ही वार्तालाप में।

Knowledge MCP में समस्या निवारण

यदि आपको कनेक्शन समस्याएँ आती हैं:
  1. MCP प्रमाणिकरण कैश साफ करें: rm -rf ~/.mcp-auth
  2. अपना क्लाइंट एप्लिकेशन पुनरारंभ करें
  3. क्लाइंट लॉग्स की जाँच करें त्रुटि संदेशों के लिए
  4. Node.js संस्करण सत्यापित करें: Node.js 18+ की आवश्यकता है

Knowledge MCP Server

Dodo Knowledge MCP कॉन्फ़िगरेशन पेज तक पहुँचें

इंस्टॉलेशन

उस स्थापना विधि का चयन करें जो आपकी कार्यप्रणाली के लिए सबसे उपयुक्त है।

रिमोट MCP सर्वर (अनुशंसित)

बिना किसी स्थानीय सेटअप या स्थापना के होस्टेड MCP सर्वर तक पहुँचें। यह शुरू करने का सबसे तेज़ तरीका है।
1

Access the remote server

अपने ब्राउज़र में https://mcp.dodopayments.com पर नेविगेट करें।
2

Configure your MCP client

अपने विशिष्ट क्लाइंट के लिए प्रदत्त JSON कॉन्फ़िगरेशन कॉपी करें। Cursor या Claude Desktop के लिए, इसे अपने MCP सेटिंग्स में जोड़ें:
{
  "mcpServers": {
    "dodopayments_api": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
3

Authenticate and configure

OAuth फ़्लो आपको प्रॉम्प्ट करेगा:
  • अपनी Dodo Payments API कुंजी दर्ज करें
  • अपना वातावरण चुनें (परीक्षण या लाइव)
  • अपना MCP क्लाइंट प्रकार चुनें
अपनी API कुंजी को सुरक्षित रखें। विकास के दौरान परीक्षण मोड कुंजियों का उपयोग करें।
4

Complete setup

कनेक्शन को अधिकृत करने के लिए लॉगिन और स्वीकृत करें पर क्लिक करें।
कनेक्ट होने के बाद, आपका AI सहायक आपके लिए Dodo Payments API के साथ इंटरैक्ट कर सकता है।

NPM पैकेज

MCP सर्वर को स्थानीय रूप से NPM का उपयोग करके इंस्टॉल और चलाएँ।
# Set your environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."
export DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key"
export DODO_PAYMENTS_ENVIRONMENT="live_mode"

# Run the latest version
npx -y dodopayments-mcp@latest
@latest का उपयोग करें ताकि हमेशा नवीनतम संस्करण प्राप्त कर सकें, या स्थिरता के लिए @1.0.0 को किसी विशिष्ट संस्करण पर स्थिर करें।

Docker

संगत तैनाती के लिए कंटेनरीकृत वातावरण में MCP सर्वर चलाएँ।
# Pull the latest image
docker pull ghcr.io/dodopayments/mcp:latest

# Run the container
docker run -e DODO_PAYMENTS_API_KEY="dodo_test_..." \
  -e DODO_PAYMENTS_WEBHOOK_KEY="your_webhook_key" \
  -e DODO_PAYMENTS_ENVIRONMENT="live_mode" \
  ghcr.io/dodopayments/mcp:latest
Docker छवियाँ GitHub Container Registry पर उपलब्ध हैं।

क्लाइंट कॉन्फ़िगरेशन

अपने पसंदीदा AI क्लाइंट में Dodo Payments MCP सर्वर को कॉन्फ़िगर करें।
Dodo Payments MCP सर्वर को Cursor में सेट करें ताकि आपके भुगतानों के डेटा तक संवादात्मक पहुँच मिल सके।एक-क्लिक इंस्टॉलCursor में सीधे MCP सर्वर को इंस्टॉल करने के लिए नीचे दिए गए बटन का उपयोग करें:[Cursor में जोड़ें](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)क्लिक करने के बाद, Cursor के mcp.json में अपने पर्यावरण चर सेट करें Cursor Settings > Tools & MCP > New MCP Server के माध्यम से।मैनुअल कॉन्फ़िगरेशन
1

Open Cursor settings

Cursor Settings > Features > Model Context Protocol पर नेविगेट करें या Cmd/Ctrl + Shift + P दबाएँ और “MCP Settings” खोजें।
2

Edit configuration

mcp_config.json फ़ाइल खोलने के लिए Edit Config पर क्लिक करें।
3

Add Dodo Payments configuration

निम्नलिखित कॉन्फ़िगरेशन में से एक चुनें:रिमोट सर्वर (अनुशंसित)
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.dodopayments.com/sse"]
    }
  }
}
स्थानीय NPX
{
  "mcpServers": {
    "dodopayments": {
      "command": "npx",
      "args": ["-y", "dodopayments-mcp@latest"],
      "env": {
        "DODO_PAYMENTS_API_KEY": "dodo_test_...",
        "DODO_PAYMENTS_WEBHOOK_KEY": "your_webhook_key"
      }
    }
  }
}
4

Save and restart

कॉन्फ़िगरेशन फ़ाइल सहेजें और Cursor पुनरारंभ करें।
अपने Dodo Payments डेटा के बारे में AI सहायक से पूछकर कनेक्शन सत्यापित करें।

पर्यावरण वेरिएबल्स

पर्यावरण वेरिएबल्स का उपयोग करके MCP सर्वर व्यवहार को कॉन्फ़िगर करें।
वेरिएबलवर्णनआवश्यक
DODO_PAYMENTS_API_KEYआपकी Dodo Payments API कुंजीहाँ
DODO_PAYMENTS_WEBHOOK_KEYआपका वेबहुक साइनिंग कुंजीनहीं
DODO_PAYMENTS_ENVIRONMENTlive_mode को उत्पादन के लिए सेट करेंनहीं

रिमोटली चलाना

वेब-आधारित क्लाइंट्स या एजेंटिक वर्कफ़्लो के लिए MCP सर्वर को रिमोट HTTP सर्वर के रूप में तैनात करें।
# Start as remote server
npx -y dodopayments-mcp --transport=http

# Specify a custom port
npx -y dodopayments-mcp --transport=http --port=3000

रिमोट सर्वर कॉन्फ़िगरेशन

एक बार तैनात होने के बाद, क्लाइंट्स सर्वर URL का उपयोग करके कनेक्ट कर सकते हैं:
{
  "mcpServers": {
    "dodopayments_api": {
      "url": "http://localhost:3000",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

ऑथराइजेशन हैडर्स

रिमोट सर्वर निम्न हैडर्स के माध्यम से प्रमाणीकरण स्वीकार करता है:
हैडरवर्णन
Authorizationबियरर टोकन प्रमाणीकरण
x-dodo-payments-api-keyडायरेक्ट API कुंजी हैडर

सुरक्षा सर्वोत्तम प्रथाएँ

कोड मोड इनहेरेंट सुरक्षा प्रदान करता है जो एक सैंडबॉक्स वातावरण में कोड चलाकर और सर्वर-साइड API कुंजियों की इंजेक्शन प्रदान करता है। अपनी क्रेडेंशियल्स को सुरक्षित रखने के लिए इन अतिरिक्त सर्वोत्तम प्रथाओं का पालन करें।
क्रेडेंशियल्स को कभी भी वर्शन कंट्रोल में न देंAPI कुंजियों को पर्यावरण वेरिएबल्स या सुरक्षित सीक्रेट प्रबंधन प्रणालियों में स्टोर करें।
# Use environment variables
export DODO_PAYMENTS_API_KEY="dodo_test_..."

# Use a .env file (add to .gitignore)
echo "DODO_PAYMENTS_API_KEY=dodo_test_..." > .env
कुंजी नियमित रूप से घुमाएँनई API कुंजियाँ नियमित रूप से उत्पन्न करें और पुरानी कुंजियों को अपने Dodo Payments डैशबोर्ड के माध्यम से निष्क्रिय करें।विकास के लिए परीक्षण कुंजियों का उपयोग करेंहमेशा परीक्षण मोड API कुंजियों का उपयोग विकास के दौरान करें ताकि उत्पादन डेटा को प्रभावित न करें।
रिमोट सर्वरों के लिए प्रमाणीकरण लागू करेंरिमोटली तैनात करते समय, हमेशा Authorization हैडर या x-dodo-payments-api-key हैडर के माध्यम से प्रमाणीकरण की आवश्यकता होती है।API उपयोग की निगरानी करेंअपने Dodo Payments डैशबोर्ड के माध्यम से MCP सर्वर गतिविधि को ट्रैक करें और असामान्य पैटर्न के लिए अलर्ट सेट करें।
रिमोट सर्वरों के लिए HTTPS का उपयोग करेंहमेशा रिमोट MCP सर्वरों को HTTPS एंडपॉइंट्स के पीछे तैनात करें।रेट लिमिटिंग लागू करेंदुरुपयोग से सुरक्षा के लिए MCP सर्वर और API स्तरों पर रेट लिमिट्स लागू करें।नेटवर्क एक्सेस प्रतिबंधित करेंकिस क्लाइंट्स आपके MCP सर्वर से कनेक्ट कर सकते हैं, इसे सीमित करने के लिए फ़ायरवॉल नियमों को कॉन्फ़िगर करें।

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

अपनी API कुंजी सत्यापित करेंसुनिश्चित करें कि आपकी API कुंजी सही ढंग से सेट है और आवश्यक अनुमतियाँ हैं।
# Test your API key
curl -H "Authorization: Bearer dodo_test_..." \
  https://test.dodopayments.com/payments
अपने नेटवर्क कनेक्शन की जाँच करेंसुनिश्चित करें कि आप Dodo Payments API एंडपॉइंट्स तक पहुँच सकते हैं।क्लाइंट लॉग्स की समीक्षा करेंकनेक्शन समस्याओं का निदान करने के लिए अपने MCP क्लाइंट में विस्तृत लॉगिंग सक्षम करें।
API कुंजी पर्यावरण की पुष्टि करेंसुनिश्चित करें कि आप परीक्षण कुंजियों के साथ परीक्षण एंडपॉइंट्स और उत्पादन कुंजियों के साथ उत्पादन एंडपॉइंट्स का उपयोग कर रहे हैं।पर्यावरण वेरिएबल की जाँच करेंसुनिश्चित करें DODO_PAYMENTS_ENVIRONMENT सही ढंग से सेट है (उत्पादन के लिए live_mode है)।क्रेडेंशियल्स पुन: उत्पन्न करेंयदि समस्याएँ बनी रहती हैं, तो अपने डैशबोर्ड के माध्यम से एक नई API कुंजी उत्पन्न करें।
इनपुट पैरामीटर्स सत्यापित करेंसुनिश्चित करें कि AI सहायक प्रत्येक उपकरण के लिए सही तरीके से स्वरूपित पैरामीटर प्रदान कर रहा है।त्रुटि संदेशों की समीक्षा करेंगलती प्रतिक्रिया से विशिष्ट मार्गदर्शन के लिए API की त्रुटि प्रतिक्रिया की जाँच करें।API के साथ सीधे परीक्षण करेंसुनिश्चित करें कि ऑपरेशन सीधे Dodo Payments API को curl या Postman के माध्यम से कॉल करते समय काम करता है।

कोड मोड क्यों

पारंपरिक MCP कार्यान्वयन अक्सर “उपकरण प्रसार” से पीड़ित होते हैं, जहां प्रत्येक API समाप्ति बिंदु को एक अलग उपकरण के रूप में उजागर किया जाता है। कोड मोड कई कारणों से श्रेष्ठ दृष्टिकोण है:

LLMs औजारों को बुलाने की तुलना में कोड लिखने में बेहतर हैं

LLMs को लाखों वास्तविक दुनिया के कोड लाइनों पर प्रशिक्षित किया गया है, जिससे वे स्वभाव से स्क्रिप्ट लिखने में निपुण हैं। इसके विपरीत, औजार बुलाने को अक्सर सिंथेटिक उदाहरणों के आधार पर किया जाता है।
“एक LLM को टूल कॉलिंग के साथ कार्य संरचना देने की कोशिश शेक्सपियर को एक महीने की मंडारिन क्लास में भेज कर उससे उसी भाषा में नाटक लिखवाना जैसा है।” — Cloudflare

संदर्भ विंडो ब्लोट को समाप्त करता है

पारंपरिक दृष्टिकोण में, प्रत्येक औजार परिभाषा बातचीत शुरू होने से पहले टोकन का उपभोग करती है। 50+ उपकरणों को उजागर करने से आसानी से 55K–100K+ टोकन खा सकते हैं। Anthropic ने पाया कि औजार परिभाषाएँ अनुकूलन से पहले 134K तक टोकन का उपभोग कर सकती हैं। कोड मोड के साथ, केवल 2 टूल परिभाषाएँ लोड की जाती हैं (~1K टोकन्स)। एजेंट दस्तावेज़ीकरण को आवश्यकता होने पर मांग पर खोजता है। Anthropic के टूल सर्च टूल ने संदर्भ विंडो के 95% को संरक्षित किया, ओवरहेड को 77K से 8.7K टोकन्स तक घटाकर।

प्रोग्रामेटिक ऑर्केस्ट्रेशन के माध्यम से विलंबता को कम करता है

पारंपरिक टूल-कॉलिंग के लिए हर एक ऑपरेशन के लिए एक पूर्ण मॉडल इंफेरेंस राउंड-ट्रिप की आवश्यकता होती है। यदि एक कार्य में 20 API कॉल की आवश्यकता होती है, तो यह 20 राउंड-ट्रिप्स हैं। कोड मोड में, एजेंट एक स्क्रिप्ट लिखता है जो सभी कॉल निष्पादित करता है और केवल अंतिम परिणाम लौटाता है। अनथ्रोपिक ने इस प्रोग्रामेटिक दृष्टिकोण का उपयोग करके टोकनों में 37% की कमी देखी और सटीकता में सुधार (ज्ञान पुनः प्राप्ति 25.6% से 28.5% तक सुधरी)।

डिज़ाइन द्वारा अधिक सुरक्षित

कोड मोड इनहेरेंट सुरक्षा लाभ प्रदान करता है:
  • पैरामीटर में कोई API कुंजी नहीं: API कुंजियों को सर्वर-साइड इंजेक्ट किया जाता है और कभी भी LLM को भेजे गए टूल पैरामीटर में उजागर नहीं किया जाता है।
  • अलग सैंडबॉक्स: कोड एक सुरक्षित पर्यावरण में चलता है जिसका नेटवर्क या होस्ट फ़ाइल सिस्टम तक कोई पहुँच नहीं है।
  • नियंत्रित SDK: एजेंट को केवल अधिकृत SDK के तरीके उपलब्ध हैं।

किसी भी API आकार तक स्केल करता है

जैसे-जैसे API बढ़ता है, पारंपरिक MCP प्रदर्शन में गिरावट आती है क्योंकि संदर्भ में अधिक उपकरणों को लोड करना पड़ता है। कोड मोड का स्तर 2 टूल्स के साथ लगातार बना रहता है जिससे कोई फर्क नहीं पड़ता API की सतह क्षेत्र कितना बड़ा है। Cloudflare ने सफलतापूर्वक 2,500 से अधिक API एंडपॉइंट्स को सिर्फ 2 टूल्स और लगभग 1,000 टोकन्स के संदर्भ में संकुचित किया।
इस आर्किटेक्चर के लाभों के बारे में अधिक विवरण के लिए, Anthropic और Cloudflare के इंजीनियरिंग ब्लॉग्स और Claude के Programmatic Tool Calling दस्तावेज़ देखें।

संसाधन

API Reference

पूरी Dodo Payments API दस्तावेज़ीकरण का अन्वेषण करें

MCP Protocol

मॉडल संदर्भ प्रोटोकॉल मानक के बारे में अधिक जानें

GitHub Repository

MCP सर्वर स्रोत कोड देखें और योगदान करें

NPM Package

NPM से MCP सर्वर इंस्टॉल करें
Last modified on May 4, 2026