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 देता है:- Docs Search Tool — उपलब्ध operations और parameters को समझने के लिए Dodo Payments API और SDK के documentation को query करता है।
- Code Execution Tool — SDK के विरुद्ध TypeScript code लिखता है, जो secure sandbox में execute होता है।
त्वरित सेटअप
अपने AI क्लाइंट में Dodo Payments MCP सर्वर से कनेक्ट करें:- Agent Plugin (recommended)
- Cursor
- Claude Desktop
- Windsurf
- Claude Code
Dodo Agent Plugin Claude Code, Codex CLI, Cursor, VS Code / GitHub Copilot, Kiro और OpenCode के लिए दोनों MCP servers और सभी seventeen skills को एक ही step में install करता है (OpenCode को एक अतिरिक्त
skills.paths setting की आवश्यकता होती है)। Gemini CLI को केवल दो MCP servers मिलते हैं, क्योंकि उसमें agent-skill primitive नहीं है। प्रत्येक agent के install commands के लिए AI Coding Agents guide देखें।यदि आपका एजेंट उस सूची में नहीं है, तो नीचे दिए गए टैब का उपयोग करके 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
- Claude Desktop
- Windsurf
- Claude Code
~/.cursor/mcp.json में जोड़ें:Node.js 18 या उसके बाद का version आवश्यक है।
mcp-remote package remote MCP server से connection संभालता है।दोनों MCP Servers का साथ में उपयोग
AI-assisted development के सर्वोत्तम अनुभव के लिए, दोनों MCP servers का उपयोग करें: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 चुनें।Remote MCP Server (Recommended)
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 चुनें
4
Complete setup
Connection authorize करने के लिए Login and Approve पर click करें।
Connect होने के बाद, आपका AI assistant आपकी ओर से Dodo Payments API के साथ interact कर सकता है।
NPM Package
MCP server को local रूप से install और run करें।- NPX (No Installation)
- MCP Client Configuration
Docker
MCP server को container में run करें।Docker images GitHub Container Registry पर उपलब्ध हैं।
Client Configuration
अपने पसंदीदा AI client में Dodo Payments MCP server को configure करें।- Cursor
- Claude Desktop
- Claude Code
- VS Code
- Cline (VS Code)
- Zed
- Other Clients
अपने payments data तक conversational access सक्षम करने के लिए Cursor में Dodo Payments MCP server सेट अप करें।One-Click InstallMCP server को सीधे Cursor में install करने के लिए नीचे दिए गए button का उपयोग करें:[
](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 Configuration1
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 का पालन करें।API Key Management
API Key Management
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 का उपयोग करें।
Access Control
Access Control
Remote deployment करते समय, हमेशा
Authorization header या x-dodo-payments-api-key header के माध्यम से authentication आवश्यक करें।Network Security
Network Security
Remote MCP servers को हमेशा HTTPS endpoints के पीछे deploy करें। MCP server और API दोनों स्तरों पर rate limits लागू करके abuse से सुरक्षा करें। यह सीमित करने के लिए firewall rules configure करें कि कौन से clients आपके MCP server से connect कर सकते हैं।
Troubleshooting
Connection issues
Connection issues
Verify करें कि आपकी API key सही तरीके से set है और उसके पास आवश्यक permissions हैं:जाँचें कि आप Dodo Payments API endpoints तक पहुँच सकते हैं। Connection problems का निदान करने के लिए अपने MCP client में verbose logging सक्षम करें।
Authentication errors
Authentication errors
सुनिश्चित करें कि आप test endpoints के साथ test keys और production endpoints के साथ live keys का उपयोग कर रहे हैं। Verify करें कि
DODO_PAYMENTS_ENVIRONMENT सही तरीके से set है (production के लिए live_mode)। समस्या बनी रहने पर अपने dashboard के माध्यम से नई API key generate करें।Tool execution failures
Tool execution failures
सुनिश्चित करें कि 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 करें