Skip to main content

Overview

Model Context Protocol (MCP) एक open standard है, जो AI applications को external data sources और APIs से कनेक्ट करने देता है। Dodo Payments MCP Server, Claude, Cursor और अन्य MCP-compatible clients जैसे AI assistants को आपके payment infrastructure तक access देता है। Dodo Payments MCP Server Code Mode architecture का उपयोग करता है। प्रत्येक API endpoint के लिए सैकड़ों अलग-अलग tools expose करने के बजाय, Code Mode AI agents को isolated sandbox में Dodo Payments SDK के विरुद्ध TypeScript code लिखने और execute करने देता है।

मुख्य क्षमताएँ

  • Payment Operations — payments और refunds बनाएँ, प्राप्त करें और प्रबंधित करें
  • Subscription Management — recurring billing, upgrades और cancellations संभालें
  • Customer Administration — customer data और portal access प्रबंधित करें
  • Product Catalog — products, pricing और discounts बनाएँ और update करें
  • License Management — software licenses activate, validate और प्रबंधित करें
  • Usage-Based Billing — metered usage को track और bill करें

How Code Mode Works

Dodo Payments MCP Server आपके AI agent को दो tools देता है:
  1. Docs Search Tool — उपलब्ध operations और parameters को समझने के लिए Dodo Payments API और SDK के documentation को query करता है।
  2. Code Execution Tool — SDK के विरुद्ध TypeScript code लिखता है, जो secure sandbox में execute होता है।
यह architecture agents को एक ही invocation में जटिल, multi-step operations करने देता है। उदाहरण के लिए, कोई agent सभी active subscriptions को list कर सकता है, उन्हें criteria के अनुसार filter कर सकता है और प्रत्येक पर discount लागू कर सकता है—वह भी एक ही script में।
Agents कई API calls को chain कर सकते हैं, conditional logic संभाल सकते हैं और LLM पर वापस round-trip किए बिना calculations कर सकते हैं।

त्वरित सेटअप

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

Dodo Knowledge MCP

Dodo Payments MCP Server के अलावा (API operations execute करने के लिए), हम Dodo Knowledge MCP भी प्रदान करते हैं—एक semantic search server, जो AI assistants को Dodo Payments documentation तक तुरंत access देता है।
ContextMCP.ai के साथ निर्मित**: Dodo Knowledge MCP ContextMCP द्वारा संचालित है, जो हमारे दस्तावेज़ीकरण में तेज़ समानार्थी खोज को सक्षम करता है।

Dodo Knowledge MCP क्या है?

Dodo Knowledge MCP एक remote MCP server है, जो semantic documentation search प्रदान करता है। Natural language queries का उपयोग करके relevant documentation खोजें, Dodo Payments के बारे में accurate और up-to-date information प्राप्त करें और बिना API keys या local installation के connect करें।

त्वरित Setup

अपने AI client में Dodo Knowledge MCP से connect करें:
~/.cursor/mcp.json में जोड़ें:
Node.js 18 या उसके बाद का version आवश्यक है। mcp-remote package remote MCP server से connection संभालता है।

दोनों MCP Servers का साथ में उपयोग

AI-assisted development के सर्वोत्तम अनुभव के लिए, दोनों MCP servers का उपयोग करें:
दोनों servers configured होने पर, आपका agent किसी feature को समझने के लिए documentation search कर सकता है, फिर उसे implement करने के लिए API calls execute कर सकता है—वह भी एक ही conversation में।

Knowledge MCP की Troubleshooting

यदि connection issues आएँ, तो rm -rf ~/.mcp-auth से MCP authentication cache clear करें, अपना client application restart करें, error messages के लिए client logs जाँचें और Node.js version verify करें (18+ आवश्यक है)।

Knowledge MCP Server

Dodo Knowledge MCP configuration page access करें

Installation

अपने workflow के अनुरूप installation method चुनें। Local setup या installation के बिना hosted MCP server access करें।
1

Access the remote server

अपने browser में https://mcp.dodopayments.com पर जाएँ।
2

Configure your MCP client

अपने specific client के लिए दी गई JSON configuration copy करें। Cursor या Claude Desktop के लिए, इसे अपनी MCP settings में जोड़ें:
3

Authenticate and configure

OAuth flow आपसे ये कार्य करने के लिए कहेगा:
  • अपनी Dodo Payments API key दर्ज करें
  • अपना environment चुनें (test या live)
  • अपना MCP client type चुनें
अपनी API key सुरक्षित रखें। Development के दौरान test mode keys का उपयोग करें।
4

Complete setup

Connection authorize करने के लिए Login and Approve पर click करें।
Connect होने के बाद, आपका AI assistant आपकी ओर से Dodo Payments API के साथ interact कर सकता है।

NPM Package

MCP server को local रूप से install और run करें।
Local server आपके code को Deno sandbox में run करता है। Deno 2.8 या उससे पहले का version install करें और सुनिश्चित करें कि deno आपके PATH पर है; Deno 2.9 और बाद के versions पर sandbox start नहीं होता। Local code execution केवल macOS और Linux पर काम करता है। Windows पर remote server का उपयोग करें या local server को WSL2 के अंतर्गत run करें।
नवीनतम version हमेशा प्राप्त करने के लिए @latest का उपयोग करें, या stability के लिए @2.51.0 जैसे specific version पर pin करें।

Docker

MCP server को container में run करें।
Docker images GitHub Container Registry पर उपलब्ध हैं।

Client Configuration

अपने पसंदीदा AI client में Dodo Payments MCP server को configure करें।
अपने payments data तक conversational access सक्षम करने के लिए Cursor में Dodo Payments MCP server सेट अप करें।One-Click InstallMCP server को सीधे Cursor में install करने के लिए नीचे दिए गए button का उपयोग करें:[Add to Cursor](https://cursor.com/en-US/install-mcp?name=dodopayments-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRvZG9wYXltZW50cy1tY3AiXSwiZW52Ijp7IkRPRE9fUEFZTUVOVFNfQVBJX0tFWSI6IlNldCB5b3VyIERPRE9fUEFZTUVOVFNfQVBJX0tFWSBoZXJlLiIsIkRPRE9fUEFZTUVOVFNfV0VCSE9PS19LRVkiOiJTZXQgeW91ciBET0RPX1BBWU1FTlRTX1dFQkhPT0tfS0VZIGhlcmUuIn19)click करने के बाद, Cursor Settings > Tools & MCP > New MCP Server के माध्यम से Cursor की mcp.json में अपने environment variables सेट करें।Manual Configuration
1

Open Cursor settings

Cursor Settings > Tools & MCP पर जाएँ या Cmd/Ctrl + Shift + P दबाएँ और “MCP Settings” खोजें।
2

Edit configuration

mcp.json file खोलने के लिए New MCP Server पर click करें।
3

Add Dodo Payments configuration

निम्न में से कोई एक configuration चुनें:Remote Server (Recommended)
Local NPX
4

Save and restart

configuration file save करें और Cursor restart करें।
AI assistant से अपने Dodo Payments data के बारे में पूछकर connection verify करें।

Environment Variables

Environment variables का उपयोग करके MCP server के व्यवहार को configure करें।

Running Remotely

वेब-आधारित clients या agentic workflows के लिए MCP server को remote HTTP server के रूप में deploy करें।

Remote Server Configuration

Deploy करने के बाद, clients server URL का उपयोग करके connect कर सकते हैं:

Authorization Headers

Remote server निम्न headers के माध्यम से authentication स्वीकार करता है:

Security Best Practices

Code Mode sandboxed environment में code execute करके और API keys को server-side inject करके अंतर्निहित security प्रदान करता है। अपने credentials की सुरक्षा के लिए इन best practices का पालन करें।
Credentials को version control में कभी commit न करें। API keys को environment variables या secure secret management systems में store करें:
नियमित रूप से नई API keys generate करके और अपने Dodo Payments dashboard के माध्यम से पुरानी keys revoke करके उन्हें rotate करें। Production data को प्रभावित होने से बचाने के लिए development के दौरान हमेशा test mode API keys का उपयोग करें।
Remote deployment करते समय, हमेशा Authorization header या x-dodo-payments-api-key header के माध्यम से authentication आवश्यक करें।
Remote MCP servers को हमेशा HTTPS endpoints के पीछे deploy करें। MCP server और API दोनों स्तरों पर rate limits लागू करके abuse से सुरक्षा करें। यह सीमित करने के लिए firewall rules configure करें कि कौन से clients आपके MCP server से connect कर सकते हैं।

Troubleshooting

Verify करें कि आपकी API key सही तरीके से set है और उसके पास आवश्यक permissions हैं:
जाँचें कि आप Dodo Payments API endpoints तक पहुँच सकते हैं। Connection problems का निदान करने के लिए अपने MCP client में verbose logging सक्षम करें।
सुनिश्चित करें कि आप test endpoints के साथ test keys और production endpoints के साथ live keys का उपयोग कर रहे हैं। Verify करें कि DODO_PAYMENTS_ENVIRONMENT सही तरीके से set है (production के लिए live_mode)। समस्या बनी रहने पर अपने dashboard के माध्यम से नई API key generate करें।
सुनिश्चित करें कि AI assistant प्रत्येक tool के लिए सही format वाले parameters प्रदान कर रहा है। क्या गलत हुआ, इसकी विशेष जानकारी के लिए API से प्राप्त error response देखें। Verify करें कि curl या Postman के माध्यम से सीधे Dodo Payments API call करने पर operation काम करता है।

Why Code Mode

Traditional MCP implementations में “tool proliferation” की समस्या होती है, जहाँ प्रत्येक API endpoint को एक अलग tool के रूप में expose किया जाता है। Code Mode कई कारणों से बेहतर है:

LLMs Are Better at Writing Code Than Calling Tools

LLMs को वास्तविक दुनिया के code की लाखों lines पर train किया जाता है, इसलिए वे स्वाभाविक रूप से scripts अच्छी तरह लिखते हैं। Tool-calling अक्सर synthetic examples पर आधारित होता है।
“किसी LLM से tool calling के माध्यम से tasks करवाना ऐसा है जैसे Shakespeare को Mandarin की एक महीने की class में भेजकर उससे उसी भाषा में play लिखने को कहना।” — Cloudflare

Eliminates Context Window Bloat

Traditional approaches में conversation शुरू होने से पहले प्रत्येक tool definition tokens का उपयोग करती है। 50+ tools expose करने पर 55K–100K+ tokens खर्च हो सकते हैं। Anthropic ने पाया कि optimization से पहले tool definitions 134K tokens तक उपयोग कर सकती थीं। Code Mode केवल 2 tool definitions (~1K tokens) load करता है। Agent आवश्यकता के अनुसार documentation खोजता है। Anthropic के Tool Search Tool ने context window का 95% सुरक्षित रखा और overhead को 77K से घटाकर 8.7K tokens कर दिया।

Reduces Latency via Programmatic Orchestration

Traditional tool-calling में प्रत्येक operation के लिए full model inference round-trip आवश्यक होता है। यदि किसी task के लिए 20 API calls चाहिएँ, तो 20 round-trips होंगे। Code Mode में agent एक script लिखता है जो सभी calls execute करती है और केवल final result लौटाती है। Anthropic ने इस approach का उपयोग करके tokens में 37% कमी और accuracy में सुधार देखा (knowledge retrieval 25.6% से बढ़कर 28.5% हुआ)।

More Secure by Design

Code Mode अंतर्निहित security benefits प्रदान करता है:
  • Parameters में कोई API keys नहीं — API keys server-side inject की जाती हैं और LLM को भेजे गए tool parameters में कभी expose नहीं होतीं।
  • Isolated sandbox — Code एक secure environment में चलता है, जहाँ network या host filesystem तक कोई access नहीं होता।
  • Controlled SDK — Agent के लिए केवल authorized SDK methods उपलब्ध होते हैं।

Scales to Any API Size

जैसे-जैसे API बढ़ती है, traditional MCP performance घटती है क्योंकि अधिक tools load करने पड़ते हैं। API surface area चाहे जो भी हो, Code Mode 2 tools के साथ constant रहता है। Cloudflare ने 2,500 से अधिक API endpoints को 2 tools और ~1,000 tokens के context में समेट दिया।
अधिक जानकारी के लिए Anthropic और Cloudflare के engineering blogs तथा Claude के Programmatic Tool Calling documentation देखें।

Resources

API Reference

संपूर्ण Dodo Payments API documentation देखें

MCP Protocol

Model Context Protocol standard के बारे में अधिक जानें

GitHub Repository

MCP server source code देखें और योगदान करें

NPM Package

NPM से MCP server install करें
अंतिम संशोधन 28 सितंबर 2026