AstroWay/api v2.325.2 · hi
सभी सिस्टम सामान्य हैं

एमसीपी के माध्यम से अपने एआई एजेंट में ज्योतिष जोड़ें

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) एआई एजेंटों को बाहरी टूल्स को कॉल करने की अनुमति देता है। इस गाइड में - क्लॉड, चैटजीपीटी या कस्टम एजेंटों में ज्योतिष गणना जोड़ने के लिए 5 मिनट से कम समय।

अगर तू पिछले साल Claude Desktop के साथ काम कर रहा था - तो शायद MCP (Model Context Protocol) देखी होगी। यह Anthropic का खुला मानक है बाहरी टूल्स को AI मॉडल्स से जोड़ने के लिए। कुछ ही कॉन्फ़िग लाइनों से Claude फ़ाइल सिस्टम, DB या किसी भी API से बात कर सकता है।

इस पोस्ट में - कैसे MCP के ज़रिए AI एजेंट में ज्योतिषीय गणनाएँ जोड़ें। समय - 5 मिनट से कम।

MCP - प्रोटोकॉल है, जिससे AI मॉडल टूल्स को कॉल करते हैं। इसे “REST API for AI-एजेंट्स” की तरह समझ।

  • सर्वर टूल्स (गणनाएँ, क्वेरीज़, क्रियाएँ) प्रदान करता है
  • क्लाइंट (Claude Desktop, Cursor, कस्टम एजेंट) उन्हें खोजता और कॉल करता है
  • मॉडल खुद तय करता है, कब कौन सा टूल उपयोग करना है: उपयोगकर्ता के अनुरोध के आधार पर

MCP-सेवर्स लोकल (सबप्रोसेस के रूप में चलाते हैं) और रिमोट (HTTP) हो सकते हैं। अधिकांश लोकल - npm पर प्रकाशित होते हैं और npx के ज़रिए चलते हैं।

MCP-सेवर AstroWay प्रत्येक API ऑपरेशन के लिए एक टूल प्रदान करता है, npm पैकेज में 735 और होस्टेड सर्वर पर 843, नामों का फॉर्मेट astroway_<група>_<операція>:

  • astroway_western_chart और संबंधित टूल्स चार्ट्स, ट्रांज़िट्स, प्रोग्रेशन और रिटर्न्स के लिए
  • astroway_relational_* सिनैस्ट्रि, कॉम्पोजिट और ग्रुप चार्ट्स के लिए
  • astroway_ai_interpret_natal, astroway_ai_interpret_synastry: AI-इंटरप्रिटेशन
  • Human Design, वैदिक, चीनी, एलिनिस्टिक ज्योतिष, टैरो और न्यूमेरोलॉजी समूह

सूची को छोटा करने के लिए, पूरे कैटलॉग की बजाय एक डोमेन सर्वर जोड़ो, देखें MCP सेटिंग्स

Claude Desktop के लिए सेटिंग्स

Section titled “Claude Desktop के लिए सेटिंग्स”

कदम 1: API-की प्राप्त करो

Section titled “कदम 1: API-की प्राप्त करो”

astroway.info पर रजिस्टर हो और मुफ्त API-की बनाओ (10 000 क्रेडिट/माह, बिना कार्ड के)।

कदम 2: Claude Desktop की कॉन्फ़िग एडिट करो

Section titled “कदम 2: Claude Desktop की कॉन्फ़िग एडिट करो”

फ़ाइल claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

AstroWay सर्वर जोड़ो:

{
"mcpServers": {
"astroway": {
"command": "npx",
"args": ["@astroway/mcp"],
"env": {
"ASTROWAY_API_KEY": "aw_live_your_key_here"
}
}
}
}

कदम 3: Claude Desktop को रीस्टार्ट करो

Section titled “कदम 3: Claude Desktop को रीस्टार्ट करो”

रीस्टार्ट के बाद AstroWay टूल्स चैट इनपुट फ़ील्ड के टूल मेन्यू में दिखेंगे।

अब बस Claude से प्राकृतिक भाषा में बात करो:

तू: 14 जुलाई 1990 को 14:30 बजे कीव में जन्मे व्यक्ति का नेटल चार्ट बनाओ। उसका सूर्य कर्क में 10वें घर में क्या मतलब है?

Claude: natal_chart को पार्स्ड कोऑर्डिनेट्स के साथ कॉल करता है, फिर interpret_placement. यहाँ नेटल चार्ट है। सूर्य कर्क में 10वें घर में संकेत देता है…

Claude खुद:

  • प्राकृतिक भाषा को पार्स करता है (शहर → कोऑर्डिनेट्स)
  • सही टूल चुनता है
  • जवाब को फॉर्मेट करता है

अगर तू कस्टम AI एजेंट बना रहा है (Claude Desktop नहीं), तो MCP-सेवर भी इस्तेमाल कर सकता है। प्रोटोकॉल डॉक्यूमेंटेड है:

import { spawn } from 'child_process';
const mcp = spawn('npx', ['@astroway/mcp'], {
env: {
...process.env,
ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
},
stdio: ['pipe', 'pipe', 'pipe'],
});
// MCP initialize
mcp.stdin.write(JSON.stringify({
jsonrpc: '2.0',
id: 1,
method: 'initialize',
params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');
// List the tools
mcp.stdin.write(JSON.stringify({
jsonrpc: '2.0',
id: 2,
method: 'tools/list',
}) + '\n');
// Call a tool
mcp.stdin.write(JSON.stringify({
jsonrpc: '2.0',
id: 3,
method: 'tools/call',
params: {
name: 'natal_chart',
arguments: {
date: '1990-07-14',
time: '14:30:00',
timezoneOffset: 3,
latitude: 50.4501,
longitude: 30.5234,
},
},
}) + '\n');

वैकल्पिक: सीधे HTTP-API

Section titled “वैकल्पिक: सीधे HTTP-API”

अगर तू MCP की ओवरहेड नहीं चाहता - एजेंट से सीधे HTTP-API को कॉल कर:

async function callAstrowayTool(tool: string, input: object) {
const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
method: 'POST',
headers: {
'X-Api-Key': process.env.ASTROWAY_API_KEY!,
'Content-Type': 'application/json',
},
body: JSON.stringify(input),
});
return res.json();
}
// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

MCP के फायदे: टूल्स के स्ट्रक्चर्ड डिस्क्रिप्शन, ऑटो-डिटेक्ट, स्टैंडर्डाइज़्ड एरर हैंडलिंग। HTTP के फायदे: आसान, कहीं भी काम करता है, सबप्रोसेस की जरूरत नहीं।

प्रॉम्प्ट उदाहरण

Section titled “प्रॉम्प्ट उदाहरण”

जब MCP सेट हो जाए, Claude में आज़मा:

  1. मेरे दैनिक राशिफल क्या है? मैं 3 अक्टूबर 1993 को 6 बजे सुबह न्यूयॉर्क में जन्मा हूँ।
  2. मेरे Human Design टाइप की गणना करो। मैं 22 अप्रैल 1987 को 16:45 बजे लंदन में जन्मा हूँ।
  3. दो लोगों की संगतता तुलना करो: मैं (14 जुलाई 1990, कीव) और मेरी दोस्त (22 मार्च 1992, पेरिस)।
  4. आज मेरे लिए मुख्य ट्रांज़िट कौन से हैं? एक इंटरप्रिटेशन दो।
  5. मुझे जन्म का सटीक समय नहीं पता। ±30 मिनट के रेंज के लिए sensitivity-एनालिसिस क्या दिखाता है?

Claude खुद ज़रूरी टूल्स चुनता है, क्रम में कई को कॉल करता है और जवाब को मानव भाषा में फॉर्मेट करता है।

सुरक्षा और डिस्क्लेमर

Section titled “सुरक्षा और डिस्क्लेमर”

AI-इंटरप्रिटेशन टूल्स AstroWay (interpret_*, *_horoscope) में बिल्ट-इन safety-guardrails हैं:

  • कोई मेडिकल, लीगल या फाइनेंशियल सलाह नहीं
  • ऑटो-इंजेक्टेड डिस्क्लेमर
  • कंटेंट फ़िल्टरिंग

जब एजेंट उपयोगकर्ता को इंटरप्रिटेशन टेक्स्ट दिखाता है - डिस्क्लेमर रखो। यह प्रत्येक AI-रिप्लाई के disclaimer फ़ील्ड में होता है।

MCP कॉल्स वही credit सिस्टम से गुजरते हैं जो HTTP के लिए है। साधारण क्वेरीज (10 क्रेडिट) → chart (20) → सिनैस्ट्रि (50) → AI-इंटरप्रिटेशन (50).

पर्सनल उपयोग के लिए (एक यूज़र जो Claude को सवाल पूछता है) - लगभग 200–500 क्रेडिट प्रति माह। मुफ्त प्लान से भी काफी ऊपर।

सैकड़ों यूज़र्स वाले प्रोडक्शन एजेंट के लिए - एंडपॉइंट्स के मिश्रण के आधार पर गिनो। Daily-horoscope-बॉट 1 000 यूज़र्स के लिए = 1 000 × 20 × 30 = 600 000 क्रेडिट/माह → Pro प्लान।

MakSeong · AstroWay

मैं AstroWay API को बनाता हूँ: मैं आर्क-सेकंड तक सटीक ज्योतिषीय गणित को साफ़ REST में लोड करता हूँ और उसके बारे में जानकारी को लिखता हूँ जो वास्तव में महत्वपूर्ण है।

// इस पर बनाएं

आर्क-सेकंड तक सटीक पोज़िशन, बस 4 लाइनों के कोड में।

कार्ड के बिना मुफ्त कुंजी। पहले भुगतान तक 5,000 कॉल प्रति माह।

ब्लॉग से और सभी पोस्ट →

Ephemeris 2026-07-19

हम सटीकता को नियंत्रण में कैसे रखते हैं: swetest और NASA के विरुद्ध CI

किसी एस्ट्रो API की सटीकता एफ़ेमेरिस कोड के एक ही रिफ़ैक्टरिंग से आसानी से बिगड़ सकती है। हम सुरक्षा के तरीके को समझाते हैं: ऐप और API के लिए एक ही Swiss Ephemeris कोर, संदर्भ कुंडलियों पर सैकड़ों फ़्रीज़ किए गए स्नैपशॉट, और हर PR का swetest CGI, Kerykeion, Prokerala तथा NASA ग्रहण कैटलॉग के विरुद्ध ट्रायंगुलेशन।

Engineering 2026-07-15

तीन आधिकारिक SDK: TypeScript, Python, PHP कच्चे curl के बजाय

कच्चा HTTP काम करता है, लेकिन टाइप किया गया क्लाइंट घंटों की बचत करता है: पथ स्वत: पूर्णता, अनुरोध और प्रतिक्रिया प्रकार, 408/409/429/5xx के लिए बनाए गए रीट्री और स्टेनलेस-स्टाइल त्रुटि श्रेणी। हम तीन आधिकारिक SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - की जांच करते हैं और यह कैसे एक ओपनएपीआई अनुबंध से उत्पन्न होते हैं।

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.