एजेंट सेटअप

Last updated 6 नव॰ 2026 Markdown के रूप में देखें एजेंट सेटअप

AstroWay API को AI एजेंट्स से MCP (Model Context Protocol) के ज़रिए जोड़ें। कैटलॉग दो तरीकों से उपलब्ध है, दोनों आपकी aw_test_* / aw_live_* कुंजियों के साथ:

Hosted (HTTP): https://mcp.astroway.info/mcp, कुछ इंस्टॉल नहीं करना, Bearer टोकन से ऑथेंटिकेशन।
Stdio (npx): npx @astroway/mcp, लोकल सबप्रोसेस, env वेरिएबल से ऑथेंटिकेशन, ऑफ़लाइन काम करता है।

डैशबोर्ड में मुफ़्त कुंजी लें, फिर अपना क्लाइंट चुनें।

पूरे कैटलॉग की जगह एक डोमेन

843 टूल एक ही रिस्पॉन्स में 3.4 MB होते हैं, जिन्हें एजेंट को एक टूल चुनने से पहले पढ़ना पड़ता है। ज़्यादातर क्लाइंट उससे बहुत पहले हार मान लेते हैं।

https://mcp.astroway.info/mcp/<डोमेन> पूरे कैटलॉग की जगह एक विषय देता है। कॉन्फ़िग वही रहता है, सिर्फ़ URL बदलता है।

डोमेन	URL	टूल	`tools/list` का आकार
ज्योतिष का कोर	`/mcp/core`	104	389 KB
वैदिक	`/mcp/vedic`	192	970 KB
चीनी मेटाफ़िज़िक्स	`/mcp/chinese`	60	202 KB
हेलेनिस्टिक और पारंपरिक	`/mcp/hellenistic`	59	240 KB
टैरो	`/mcp/tarot`	79	209 KB
अंकशास्त्र	`/mcp/numerology`	64	158 KB
Human Design	`/mcp/human-design`	27	125 KB
भविष्यवाणी	`/mcp/forecast`	43	209 KB
रिश्ते	`/mcp/relationships`	42	247 KB
मनोवैज्ञानिक	`/mcp/psychological`	28	107 KB
भविष्य-कथन और गूढ़ विद्या	`/mcp/divination`	79	185 KB
व्यावहारिक रीडिंग	`/mcp/applied`	45	148 KB
रिपोर्ट	`/mcp/reports`	42	209 KB
प्लेटफ़ॉर्म	`/mcp/platform`	42	119 KB

प्रोडक्शन पर 2026-09-21 को मापा गया। /mcp अब भी पूरा कैटलॉग देता है, इसलिए पहले से सेट किया गया कुछ भी नहीं टूटा। बैलेंस चेक और कॉल की लागत का अनुमान हर डोमेन में है, क्योंकि वैदिक ज्योतिष तक सीमित एजेंट को भी पता होना चाहिए कि कॉल कितने की है।

GET /domains यही सूची JSON के रूप में लौटाता है, बिना कुंजी के। अनजान डोमेन पर असली डोमेन की सूची के साथ 404 मिलता है, न कि चुपचाप सभी 843 टूल।

बिना कुंजी के डॉक्यूमेंटेशन: `/mcp/docs`

एजेंट का पहला सवाल कभी “चार्ट बनाओ” नहीं होता। वह होता है “यह API क्या कर सकता है, कॉल कैसी दिखती है और मुझे कितने की पड़ेगी”। तीनों का जवाब बिना कुंजी के मिल सकता है: https://mcp.astroway.info/mcp/docs एक भी क्रेडिट खर्च नहीं करता, इसलिए ऑथराइज़ेशन भी नहीं माँगता।

टूल	क्या करता है
`find_endpoint`	सभी 770 ऑपरेशन्स में खोजता है। हर एक के लिए मेथड, URL, क्रेडिट में क़ीमत, प्लान, बॉडी के अनिवार्य फ़ील्ड और रेफ़रेंस का लिंक देता है
`search_docs`	गाइड्स के 281 पेजों में खोजता है, यूक्रेनी और अंग्रेज़ी, हर पेज के सेक्शन की सूची के साथ
`read_doc`	एक पेज markdown के रूप में देता है
`list_docs`	पूरी इंडेक्स, सेक्शन के हिसाब से समूहित

770 में से 700 ऑपरेशन्स की क़ीमत दी गई है, और 37 बिना कुंजी के जवाब देने वाले के रूप में चिह्नित हैं। यानी किसी परिदृश्य की लागत अकाउंट बनने से पहले ही निकाली जा सकती है।

curl https://mcp.astroway.info/mcp/docs \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_endpoint","arguments":{"query":"solar return","limit":2}}}'

read_doc सिर्फ़ वही पेज पढ़ता है जो इंडेक्स में हैं। किसी भी दूसरे पाथ को मना कर दिया जाता है, और उस दौरान बाहर कोई अनुरोध नहीं जाता।

पूरे रिस्पॉन्स से कम माँगें

हर टूल अपने पैरामीटर्स के अलावा दो और पैरामीटर लेता है: fields (कॉमा से अलग पाथ की सूची, data के सापेक्ष) और precision (दशमलव के बाद कितने अंक रखने हैं)। ये उसी API में जाते हैं जिसमें REST से जाते हैं, और टोकन में अंतर सिर्फ़ कहने की बात नहीं है।

MCP के ज़रिए जन्म कुंडली की कॉल	बाइट
बिना पैरामीटर, जैसा 21.09.2026 से पहले था	91 737
बिना पैरामीटर, आज	72 484
`precision: 2`	61 356
`fields: "planets.name,planets.longitude,houses.cusp"` और `precision: 2`	1 182

प्रोडक्शन पर 2026-09-21 को मापा गया। चारों पंक्तियों में क्रेडिट एक जैसे हैं: अंतर की क़ीमत वह चुकाता है जो रिस्पॉन्स पढ़ता है।

जो पाथ किसी फ़ील्ड से मेल नहीं खाया, वह _fields_unmatched में वापस आता है। जिस सूची में कुछ भी मेल नहीं खाया, वह सूची के साथ 400 FIELDS_UNKNOWN है, न कि ख़ाली रिस्पॉन्स। दोनों पैरामीटर्स का पूरा विवरण: API कन्वेंशन्स।

अपना क्लाइंट चुनें

Claude Desktop कॉन्फ़िग के ज़रिए Hosted MCP

Claude Code एक CLI कमांड

Cursor कॉन्फ़िग के ज़रिए Hosted MCP

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline npx stdio पैकेज

Codex CLI npx stdio पैकेज

CI / raw HTTP

बिना किसी क्लाइंट के भी - hosted एंडपॉइंट HTTP पर JSON-RPC बोलता है। Bearer टोकन के साथ टूल्स की सूची:

curl https://mcp.astroway.info/mcp \
-H "Authorization: Bearer aw_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

MCP के बिना Function calling

अगर आपका एजेंट MCP की जगह OpenAI या Anthropic का function calling इस्तेमाल करता है, तो API से तैयार टूल डेफ़िनिशन माँगें और उन्हें सीधे मॉडल को दें। ये OpenAPI डॉक्यूमेंट से जेनरेट होती हैं, इसलिए मॉडल जो स्कीमा भरता है, वही स्कीमा एंडपॉइंट जाँचता है।

curl "https://api.astroway.info/v1/agent/tools?format=openai" \
-H "X-Api-Key: aw_live_YOUR_KEY"

रिस्पॉन्स के दो हिस्से होते हैं। tools वेंडर के कॉन्ट्रैक्ट से बिल्कुल मेल खाता है और उसमें हमारा कुछ नहीं होता, इसलिए उसे मॉडल कॉल में जैसा है वैसा रखा जा सकता है: टूल ऑब्जेक्ट के अंदर एक भी अतिरिक्त कुंजी उनकी तरफ़ 400 है। executors बताता है कि हर टूल को कैसे चलाना है, और इसमें वही कुंजियाँ होती हैं जो मॉडल लौटाएगा:

{
"tools": [
  { "type": "function", "function": { "name": "astroway_post_chart", "description": "Natal chart...",
    "parameters": { "type": "object", "required": ["date", "time", "latitude", "longitude"], "properties": { "...": {} } } } }
],
"executors": {
  "astroway_post_chart": { "method": "POST", "path": "/v1/chart", "credits": 20, "group": "Core" }
},
"count": 26, "totalMatched": 26, "totalAvailable": 751, "truncated": false
}

इसके बाद आपका एक्ज़ीक्यूटर पाँच पंक्तियों का है: executors में नाम ढूँढें, मॉडल के आर्ग्युमेंट्स को JSON बॉडी के रूप में अपनी X-Api-Key के साथ उस पाथ पर भेजें, रिस्पॉन्स मॉडल को लौटाएँ। किसी भी टूल में क्रेडेंशियल्स नहीं होते, इसलिए इस सूची को कैश करना सुरक्षित है।

मॉडल क्या देखता है, यह आप चुनते हैं। डिफ़ॉल्ट रूप से यह 26 टूल का चुना हुआ स्टार्टर सेट है, पूरा कैटलॉग नहीं: OpenAI एक अनुरोध को 128 फ़ंक्शन तक सीमित करता है, और मॉडल उस सीमा से बहुत पहले ही ख़राब चुनाव करने लगते हैं। select=all, select=group:Vedic, select=paths:/chart,/synastry से दायरा घटाएँ या बढ़ाएँ, q= से अंदर फ़िल्टर करें, limit= से सीमित करें (अधिकतम 128)। कुछ भी चुपचाप ग़ायब नहीं होता: totalMatched और notes बताते हैं कि क्या बाहर रह गया। { name, description, input_schema } पाने के लिए format=anthropic जोड़ें।

यह कॉल मुफ़्त है और क्रेडिट खर्च नहीं करती।

मॉडल के लिए अपनी कुंजी

जिन एंडपॉइंट्स पर हम टेक्स्ट जेनरेट करते हैं, वहाँ आप टोकन का भुगतान ख़ुद कर सकते हैं। दो हेडर, या तो दोनों या कोई नहीं:

curl https://api.astroway.info/v1/ai/explain-aspect \
-H "X-Api-Key: aw_live_YOUR_KEY" \
-H "X-Provider: anthropic" \
-H "X-Provider-Key: sk-ant-YOUR_PROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{"planet1":"Saturn","planet2":"Moon","aspectType":"Square"}'

X-Provider इनमें से एक है: openai, anthropic, google, groq, mistral, openrouter, deepseek, together; हर एक का पता हमारी तरफ़ तय है और कभी अनुरोध से नहीं लिया जाता। X-Provider-Model वैकल्पिक है और डिफ़ॉल्ट मॉडल को ओवरराइड करता है।

हमारी चेन पर कोई फ़ॉलबैक नहीं है। अगर आपकी कुंजी काम नहीं करती, तो आपको प्रोवाइडर का स्टेटस और संदेश मिलेगा, न कि ऐसा रिस्पॉन्स जिसका भुगतान हमने किया: चुपचाप फ़ॉलबैक हमारे टोकन उस अनुरोध पर खर्च करता जिसे आप अपना मान रहे थे, और इसे पकड़ना असंभव होता।

ऐसी कॉल की क़ीमत 5 क्रेडिट है, एंडपॉइंट की क़ीमत की जगह। हम फिर भी चार्ट की गणना करते हैं, प्रॉम्प्ट बनाते हैं और सेफ़गार्ड्स चलाते हैं; कम्प्लीशन आपने ख़रीदा है।

आपकी कुंजी कहीं लॉग, स्टोर या कैश नहीं होती। यह हेडर में जाती है, क्योंकि अनुरोध की बॉडी दो कैश कुंजियों में हैश होती है, और हमारा अनुरोध लॉग हेडर बिल्कुल नहीं लिखता। प्रोवाइडर की कोई त्रुटि जिसमें आपकी कुंजी उद्धृत हो, हमारे लॉग या आपके रिस्पॉन्स तक पहुँचने से पहले ही छिपा दी जाती है। आपकी कुंजी वाली कॉल दोनों कैश को दोनों दिशाओं में बायपास करती है: उसे कभी हमारा बनाया रिस्पॉन्स नहीं मिलेगा, और उसका रिस्पॉन्स कभी किसी और तक नहीं पहुँचेगा।

हेडर स्पेसिफ़िकेशन में हैं। हर पाथ जो इन्हें स्वीकार करता है, /v1/openapi.json में X-Provider, X-Provider-Key और X-Provider-Model घोषित करता है, इसलिए जेनरेट किया गया क्लाइंट इन्हें किसी भी दूसरे पैरामीटर की तरह जोड़ लेगा, और उसे इस पेज की ज़रूरत नहीं होगी। ये सिर्फ़ वहीं घोषित हैं जहाँ हम सच में मॉडल को कॉल करते हैं: इन्हें /chart पर भेजा जा सकता है, पर कुछ नहीं होगा, और आप एंडपॉइंट की सामान्य क़ीमत चुकाएँगे।

मशीन-पठनीय स्पेसिफ़िकेशन

REST API को सीधे जोड़ना चाहते हैं या स्पेसिफ़िकेशन अपने एजेंट को देना चाहते हैं?

AGENTS.md: /AGENTS.md, एजेंट के लिए निर्देश (बिना कुंजी के क्या कॉल किया जा सकता है, अनुरोध का कॉन्ट्रैक्ट, रिस्पॉन्स का एनवेलप, लिमिट हेडर)
OpenAPI: /v1/openapi.json
llms.txt: /llms.txt · पूरा टेक्स्ट /llms-full.txt
Postman: /postman/astroway-api.json
SDK: TypeScript, Python, PHP