Twelve Data

Twelve Data MCP सर्वर

Claude, ChatGPT और अन्य AI सहायकों को Twelve Data वित्तीय API से जोड़ें — रीयल-टाइम और ऐतिहासिक मूल्य, 60+ तकनीकी संकेतक, मौलिक डेटा, आय, लाभांश, ETF, कंपनी समाचार, बाजार चालक, और बहुत कुछ।

आपको Twelve Data खाते की आवश्यकता है। twelvedata.com पर साइन अप करें।

इसे उपयोग करने के दो तरीके हैं। अधिकांश लोगों को क्लाउड सर्वर (विकल्प 1) का उपयोग करना चाहिए — इसमें कुछ भी इंस्टॉल करने की आवश्यकता नहीं है।

---

विकल्प 1 — हमारे क्लाउड सर्वर का उपयोग करें (अनुशंसित)

अपने AI सहायक को हमारे होस्टेड सर्वर से जोड़ें:

https://mcp.twelvedata.com/mcp

बस इतना ही। कोई इंस्टॉलेशन नहीं, कॉपी-पेस्ट करने के लिए कोई API कुंजी नहीं। जब आप कनेक्ट करते हैं, तो एक ब्राउज़र विंडो खुलती है और आप अपने Twelve Data खाते से लॉग इन करते हैं — आपकी व्यक्तिगत API कुंजी स्वचालित रूप से लिंक हो जाती है और आपके खाते से जुड़ी रहती है।

इसे कैसे जोड़ें

Claude (डेस्कटॉप / वेब) और ChatGPT कस्टम कनेक्टर / MCP सर्वर का समर्थन करते हैं:

1. अपने सहायक की Connectors (या Integrations / MCP servers) सेटिंग्स खोलें।
2. URL https://mcp.twelvedata.com/mcp के साथ एक नया कनेक्टर जोड़ें।
3. संकेत मिलने पर, Connect / Log in पर क्लिक करें — आपके ब्राउज़र में Twelve Data लॉगिन पेज खुलता है।
4. अधिकृत करें, और आपका काम हो गया। ऐसे प्रश्न पूछें जैसे "AAPL के लिए RSI क्या है?" या "मुझे TSLA की नवीनतम आय दिखाएं।"

ऐप्स और संस्करणों के बीच सटीक मेनू नाम अलग-अलग होते हैं, लेकिन प्रवाह हमेशा समान होता है: URL जोड़ें, फिर ब्राउज़र पॉपअप के माध्यम से लॉग इन करें।

MCP होस्ट टोकन जारी नहीं करता है। कनेक्टर URL https://mcp.twelvedata.com/mcp है। क्लाइंट को उस URL के संरक्षित-संसाधन मेटाडेटा का पालन करके वहां नामित प्राधिकरण सर्वर तक जाना चाहिए। कनेक्टर को होस्ट रूट पर इंगित न करें (यह 404 देता है), या इस होस्ट के /register या /.well-known/oauth-authorization-server पर न करें।

Perplexity (कस्टम रिमोट कनेक्टर)

Perplexity Pro, Max और Enterprise उपयोगकर्ता होस्टेड सर्वर को कस्टम रिमोट कनेक्टर के रूप में जोड़ सकते हैं। यह प्रति-खाता सेटअप है, Perplexity की सार्वजनिक क्यूरेटेड निर्देशिका में सूचीबद्ध नहीं है।

1. Perplexity में, Account settings → Connectors → + Custom connector खोलें और Remote चुनें। Enterprise पर, व्यवस्थापक को पहले कस्टम कनेक्टर की अनुमति देनी पड़ सकती है।
2. Name को Twelve Data और MCP Server URL को https://mcp.twelvedata.com/mcp पर सेट करें।
3. प्रमाणीकरण के लिए OAuth और परिवहन के लिए Streamable HTTP चुनें। Client ID और Client Secret को खाली छोड़ दें ताकि Perplexity सर्वर के संरक्षित-संसाधन मेटाडेटा में नामित प्राधिकरण सर्वर पर डायनामिक क्लाइंट पंजीकरण का उपयोग कर सके।
4. Perplexity की कस्टम कनेक्टर स्वीकृति स्वीकार करें और Add पर क्लिक करें। फिर प्रमाणीकरण शुरू करने के लिए Twelve Data कनेक्टर कार्ड पर क्लिक करें, अपने Twelve Data खाते में साइन इन करें और पहुंच अधिकृत करें।
5. कनेक्टर सक्षम होने के बाद, इन प्रॉम्प्ट को आज़माएं:
   • "AAPL प्रतीक खोजने के लिए Twelve Data का उपयोग करें।"
   • "AAPL के लिए नवीनतम कोट प्राप्त करने के लिए Twelve Data का उपयोग करें, जिसमें मूल्य और वॉल्यूम शामिल है।"
   • "AAPL के लिए पिछले पांच दैनिक समापन मूल्य दिखाने के लिए Twelve Data का उपयोग करें।"
   • "AAPL RSI दिखाने के लिए Twelve Data का उपयोग करें।"

प्रत्येक व्यक्ति अपने स्वयं के Twelve Data खाते से साइन इन करता है। यदि कोई Enterprise व्यवस्थापक कनेक्टर साझा करता है, तो प्रत्येक सदस्य के लिए व्यक्तिगत प्रमाणीकरण की आवश्यकता होती है। कनेक्टर के API Key प्रमाणीकरण फ़ील्ड में Twelve Data API कुंजी न पेस्ट करें।

यदि OAuth विंडो अवरुद्ध है, लॉगिन विफल हो जाता है, या निष्क्रिय समय के बाद उपकरण बंद हो जाते हैं, तो Twelve Data कनेक्टर खोलें, इसे अक्षम करें, फिर से सक्षम करें और साइन इन करें। इस तरह पुनः कनेक्ट करें, कनेक्टर को API Key प्रमाणीकरण पर स्विच करने के बजाय। पुष्टि करें कि URL बिल्कुल https://mcp.twelvedata.com/mcp है जिसमें कोई ट्रेलिंग स्लैश नहीं है, और Twelve Data योजना में अनुरोधित डेटा शामिल है। वर्तमान सेटिंग्स स्क्रीन के लिए Perplexity का कस्टम रिमोट कनेक्टर गाइड देखें।

Codex (CLI, डेस्कटॉप और IDE)

इस रिपॉजिटरी को इंस्टॉल किए बिना या API कुंजी कॉपी किए बिना होस्टेड MCP सर्वर को Codex में जोड़ें:

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

add कमांड OAuth शुरू करता है: अपने ब्राउज़र में Twelve Data साइन-इन पूरा करें। यदि आपको बाद में फिर से अधिकृत करने की आवश्यकता है, तो codex mcp login twelvedata चलाएं। Codex में, कनेक्शन जांचने के लिए /mcp का उपयोग करें, फिर पूछें: "AAPL के लिए नवीनतम कोट प्राप्त करने के लिए Twelve Data का उपयोग करें।" और "AAPL RSI दिखाने के लिए Twelve Data का उपयोग करें।" डिस्कनेक्ट करने के लिए, codex mcp remove twelvedata चलाएं।

सार्वजनिक प्लगइन रिपॉजिटरी https://github.com/MazeBraker/twelvedata-skills. है। यह कौशल और समान होस्टेड MCP स्थापित करता है:

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

विकल्प 2 — API कुंजी के साथ इसे स्वयं चलाएं

सर्वर को अपनी मशीन पर चलाना पसंद करते हैं? आपको केवल अपनी Twelve Data API कुंजी चाहिए — कोई OAuth सेटअप नहीं। इसे twelvedata.com → अपना डैशबोर्ड → API Keys पर प्राप्त करें।

1. इंस्टॉल करें

Python 3.10+ आवश्यक है (3.12 अनुशंसित; macOS पर brew install python@3.12 या make python-install)।

make install

2. अपनी API कुंजी जोड़ें

प्रोजेक्ट रूट में अपनी कुंजी के साथ एक .env फ़ाइल बनाएं, जो केवल आपके लिए पठनीय हो:

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

सर्वर कुंजी को .env से पढ़ता है और हर अनुरोध इसे उपयोग करता है। कोई लॉगिन चरण आवश्यक नहीं है।

3. stdio पर कनेक्ट करें

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json में जोड़ें:

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

.venv/bin/python पथ का उपयोग करें (सिस्टम Python नहीं — macOS 3.9 भेजता है, और इस सर्वर को 3.10+ चाहिए)। कॉन्फ़िग संपादित करने के बाद Claude Desktop को पुनरारंभ करें।

Claude Code:

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. HTTP पर कनेक्ट करें

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. इसे Docker में चलाएं

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file आपकी कुंजी को शेल इतिहास से बाहर रखता है। चरण 4 की तरह http://localhost:8000/mcp से कनेक्ट करें। Docker में OAuth लॉगिन समर्थित नहीं है।

6. सुरक्षा

• make run और Docker /mcp को बिना प्रमाणीकरण के, डिफ़ॉल्ट रूप से 0.0.0.0 पर परोसते हैं।
• हर कॉल आपकी साख के तहत परोसी जाती है।
• पोर्ट तक पहुंचने वाला कोई भी व्यक्ति auth_status और oauth_configure को कॉल कर सकता है। इसमें आपके द्वारा खोला गया एक वेब पेज भी शामिल है, DNS रिबाइंडिंग के माध्यम से, क्योंकि डिफ़ॉल्ट बाइंड न तो Host और न ही Origin हेडर की जांच करता है।
• MCP_HOST=127.0.0.1 make run सर्वर को स्थानीय रखता है और MCP SDK की Host और Origin जांच चालू करता है।
• MCP_HOST=127.0.0.1 के साथ, ngrok केवल --host-header=rewrite के साथ शुरू होने पर काम करता है।

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

पहले अपने क्लाइंट से auth_status को कॉल करें। यह दिखाता है कि API कुंजी कॉन्फ़िगर है या नहीं, संग्रहीत टोकन, पता लगाया गया होस्ट और रीडायरेक्ट URI — आमतौर पर यह देखने के लिए पर्याप्त है कि क्या गायब है।

---

आप क्या पूछ सकते हैं

• मूल्य — स्टॉक, ETF, विदेशी मुद्रा, क्रिप्टो, कमोडिटी (रीयल-टाइम और ऐतिहासिक)
• तकनीकी संकेतक — RSI, MACD, SMA, BBANDS, ATR, और 60+ अधिक
• मौलिक डेटा — वित्तीय विवरण, आय, लाभांश, विभाजन, कंपनी प्रोफाइल, बाजार पूंजीकरण, प्रमुख आँकड़े, IPO कैलेंडर
• फंड — ETF और म्यूचुअल फंड प्रोफाइल, प्रदर्शन, होल्डिंग्स, जोखिम
• समाचार — कंपनी समाचार और प्रेस विज्ञप्तियां
• बाजार खुफिया — चालक, विनिमय दरें, विश्लेषक रेटिंग, मूल्य लक्ष्य
• विनियामक — SEC/EDGAR फाइलिंग, इनसाइडर लेनदेन, संस्थागत होल्डिंग्स

प्रतीक प्रारूप: स्टॉक AAPL, क्रिप्टो BTC/USD, विदेशी मुद्रा EUR/USD।

---

साझेदार

अपना स्वयं का सार्वजनिक इंस्टेंस चला रहे हैं या समर्पित OAuth लॉगिन स्थापित कर रहे हैं? यह एक साझेदार व्यवस्था है — twelvedata.com पर हमसे संपर्क करें और हम सेटअप गाइड और OAuth क्रेडेंशियल प्रदान करेंगे।