AI एजंट्स और MCP

क्या तू एक AI‑एजेंट बना रहा है जो वास्तविक ज्योतिषीय गणनाएँ करेगा, न कि भ्रम? AstroWay Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral से जुड़ता है - MCP, llms.txt या सीधे HTTP‑कॉल्स के माध्यम से। इंटीग्रेशन के तीन तरीके – एजेंट के प्रकार के अनुसार चुन:

• llms.txt: एजेंटों के लिए डिस्कवरी‑फ़ाइलें जो डॉक्यूमेंटेशन पढ़ते हैं (Cursor IDE, Windsurf, ब्राउज़र में Claude, LangChain/LlamaIndex पर कस्टम RAG‑पाइपलाइन)।
• MCP сервер: Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) और किसी भी MCP‑कम्पैटिबल क्लाइंट के लिए ज़ीरो‑कोड (GPT को MCP के जरिए OpenAI Realtime API से भी शामिल)।
• HTTP API: अपने एजेंट या फ्रेमवर्क (LangChain, LlamaIndex, AutoGen, CrewAI) से सीधे कॉल।

llms.txt: AI‑एजेंटों के लिए डिस्कवरी

साइट दो मशीन‑रीडेबल फ़ाइलें फ़ॉर्मेट में एक्सपोज़ करता है: llms.txt:

• /llms.txt: सभी डॉक्यूमेंटेशन पेजों का इंडेक्स, सेक्शन (API Reference, Use Cases, Examples, Products) के अनुसार समूहित। छोटा, किसी भी context window में फिट हो जाता है।
• /llms-full.txt: पूरी डॉक्यूमेंटेशन की सामग्री एक plain‑text फ़ाइल में। ऑफ़लाइन इंडेक्सिंग के लिए वेक्टर DB या एक बार के context इन्जेक्शन के लिए उपयुक्त।

कब उपयोग करें

परिदृश्य	फ़ाइल
Cursor/Windsurf “डॉक्यूमेंटेशन पढ़ो astroway और इंटीग्रेशन में मदद करो”	/llms.txt (एजेंट खुद ज़रूरी सेक्शन लाएगा)
अपना RAG‑पाइपलाइन / वेक्टर DB FAQ‑बॉट के लिए	/llms-full.txt (एक fetch - पूरा कॉर्पस)
Claude/ChatGPT ब्राउज़र में: “ये हमारा API है, क्लाइंट बनाओ”	/llms-full.txt प्रॉम्प्ट में चिपकाओ
प्रोडक्शन‑एजेंट कॉल्स के साथ	MCP сервер या HTTP API (नीचे देखें)

उदाहरण: अपने एजेंट में pull

const docs = await fetch('https://api.astroway.info/llms-full.txt').then(r => r.text());

const systemPrompt = `You are an integration assistant for AstroWay API.
Documentation:
${docs}

When the user asks how to do X, return a working code snippet using their API key.`;

टिप्पणी

फ़ाइलें हर साइट रिलीज़ पर ऑटोमैटिकली रीजनरेट होती हैं। ताज़गी गारंटीड: संस्करण API /llms.txt के अंत में वर्तमान प्रोडक्शन डिप्लॉय से मेल खाता है।

MCP сервер (Claude Desktop के लिए अनुशंसित)

Model Context Protocol (MCP) - AI‑मॉडलों से टूल्स को कनेक्ट करने का ओपन स्टैंडर्ड है। AstroWay का MCP‑सर्वर 783 टूल्स देता है, प्रत्येक API ऑपरेशन के लिए एक, साथ ही 12 प्रॉम्प्ट और 14 रिसोर्स।

Claude Desktop के लिए सेटअप

claude_desktop_config.json में जोड़:

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

Claude Desktop को रीस्टार्ट करने के बाद वह सभी 783 टूल्स देखेगा। सूची को छोटा करने के लिए ASTROWAY_TOOL_GROUPS सेट करो या डोमेन सर्वर कनेक्ट करो, देखें MCP सेटिंग्स।

MCP сервер क्या कर सकता है

टूल	क्या करता है
astroway_western_chart	जन्म कुंडली की गणना
astroway_relational_synastry	दो लोगों की सिनैस्ट्रि
astroway_horoscope_daily	दैनिक राशिफल
astroway_ai_interpret_natal	जन्म कुंडली की AI व्याख्या
astroway_hd_human_design	पूरी HD मानवीय डिज़ाइन
astroway_prognostics_transits	वर्तमान ट्रांज़िट्स

पूरा सूची: 783 टूल्स, पूरा API, प्रत्येक की टाइप्ड स्कीमा उत्तर के साथ।

Claude के साथ संवाद का उदाहरण

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

Claude: गणना के लिए astroway_western_chart का उपयोग करता है, फिर व्याख्या के लिए astroway_ai_interpret_placement। ग्रहों की स्थितियों को वास्तविक डेटा के साथ और समझदार व्याख्या लौटाता है।

HTTP API

MCP सपोर्ट के बिना AI‑एजेंट्स के लिए - सीधे HTTP API इस्तेमाल करो।

कंटेंट जनरेशन के लिए

TypeScript

// The AI agent calls /interpret/natal for an interpretation
const r = await fetch('https://api.astroway.info/v1/interpret/natal', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});

const { data: result } = await r.json();
// result.interpretation - ready AI interpretation
// result.disclaimer - disclaimer to display

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/interpret/natal',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
result = r.json()['data']
# result['interpretation'] - ready AI interpretation
# result['disclaimer']     - disclaimer to display

cURL

curl -X POST https://api.astroway.info/v1/interpret/natal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('interpret/natal', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
    ],
]);

$result = json_decode($r->getBody(), true)['data'];
// $result['interpretation'] - ready AI interpretation
// $result['disclaimer']     - disclaimer to display

गणनाओं के लिए + अपना LLM

// 1. Get raw data from /chart (cheaper - 20 credits)
const chart = await fetch('https://api.astroway.info/v1/chart', { ... });
const { data } = await chart.json();

// 2. Pass the data to your own LLM
const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`;
const llmResponse = await myLLM.generate(prompt);

संकेत

अगर तुम्हें सिर्फ व्याख्या चाहिए - /interpret/* इस्तेमाल करो (50 क्रेडिट, टेक्स्ट तैयार)। अगर प्रॉम्प्ट को कंट्रोल करना चाहते हो - /chart लो (20 क्रेडिट) और डेटा अपने LLM को भेजो।

परिदृश्य

व्यक्तिगत ज्योतिष सहायक

MCP сервер + Claude/ChatGPT। उपयोगकर्ता पूछता है - एजेंट गणना और व्याख्या करता है। बजट: व्यक्तिगत उपयोग के लिए Free टैरिफ।

सोशल मीडिया के लिए कंटेंट बॉट

12 राशियों के लिए दैनिक राशिफल जनरेशन /horoscope/daily के माध्यम से। 12 अनुरोध/दिन = 240 क्रेडिट। Free टैरिफ बड़ी सीमा के साथ।

AI‑कोचिंग प्लेटफ़ॉर्म

/interpret/natal + /interpret/transits हर क्लाइंट के लिए। 100 क्लाइंट/दिन = 10 000 क्रेडिट/दिन। Pro टैरिफ।

तेज़ शुरुआत → पहला अनुरोध 5 मिनट में

Horoscope API AI व्याख्याएँ और राशिफल

टैरिफ़ फ्री से एंटरप्राइज़ तक