AI एजंट्स और MCP

तू AI एजंट बनवतो आहे ज्याला खऱ्या अॅस्ट्रॉलॉजिकल कॅल्क्युलेशन्स करायचे आहेत आणि hallucinations नव्हे? AstroWay Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral शी जोडते — MCP, llms.txt किंवा थेट HTTP कॉल्स द्वारे. तीन प्रकारचे इंटिग्रेशन — तुमच्या एजंटच्या प्रकारानुसार निवडा:

• llms.txt — एजंट्ससाठी discovery फाइल्स जे डॉक्युमेंटेशन वाचतात (Cursor IDE, Windsurf, ब्राउझरमधील Claude, LangChain/LlamaIndex वर आधारित कस्टम RAG पाइपलाइन्स).
• MCP सर्व्हर — Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) आणि कोणत्याही MCP-सुसंगत क्लायंटसाठी zero-code (OpenAI Realtime API द्वारे GPT सह देखील).
• HTTP API — तुमच्या स्वतःच्या एजंट किंवा फ्रेमवर्कमधून थेट कॉल करणे (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt — AI एजंट्ससाठी discovery

साइट llms.txt फॉरमॅटमध्ये दोन मशीन-वाचनीय फाइल्स एक्स्पोज करते:

• /llms.txt — API Reference, Use Cases, Examples, Products अशा विभागांमध्ये गटबद्ध केलेले डॉक्युमेंटेशन पेजेसचे इंडेक्स. लहान आहे, कोणत्याही context window मध्ये बसतो.
• /llms-full.txt — संपूर्ण डॉक्युमेंटेशन एक plain-text फाइलमध्ये. ऑफलाइन व्हेक्टर DB मध्ये इंडेक्स करण्यासाठी किंवा context मध्ये एकाच वेळी इंजेक्ट करण्यासाठी योग्य.

कधी वापरायचे

परिस्थिती	फाइल
Cursor/Windsurf “docs astroway वाचा आणि इंटिग्रेशनमध्ये मदत करा”	/llms.txt (एजंट स्वतः आवश्यक विभाग ओढून घेईल)
तुमचा स्वतःचा RAG पाइपलाइन / FAQ-बोटसाठी व्हेक्टर DB	/llms-full.txt (एक fetch — संपूर्ण कॉर्पस)
ब्राउझरमधील Claude/ChatGPT: “इथे आमचे API आहे, क्लायंट बनवा”	/llms-full.txt प्रमोट मध्ये जोडा
Production एजंट ज्याला API कॉल करण्याची गरज आहे	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.`;

टिप्पणी

फाइल्स प्रत्येक साइट रिलीझवर आपोआप regeneration होतात. फ्रेशनेस гаран्टेड: /llms.txt च्या शेवटी API व्हर्जन production deploy शी match करतो.

MCP सर्व्हर (Claude Desktop साठी recommended)

Model Context Protocol (MCP) AI मॉडेल्सशी टूल्स जोडण्यासाठी ओपन स्टँडर्ड आहे. AstroWay MCP सर्व्हर 25 टूल्स प्रदान करतो ज्यात कॅल्क्युलेशन्स आणि इंटरप्रिटेशन्स आहेत.

Claude Desktop साठी सेटअप

claude_desktop_config.json मध्ये जोडा:

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

Claude Desktop रीस्टार्ट केल्यानंतर, तुम्हाला 25 अॅस्ट्रॉलॉजिकल टूल्स दिसतील.

MCP सर्व्हर काय करू शकतो

टूल	काय करते
natal_chart	नेटल चार्ट कॅल्क्युलेशन
synastry	दोन लोकांची सिनॅस्ट्रि
daily_horoscope	दैनिक होरोस्कोप
interpret_natal	नेटल चार्टचे AI इंटरप्रिटेशन
human_design	पूर्ण HD चार्ट
transits	सध्याचे ट्रान्झिट्स

पूर्ण लिस्ट — 25 टूल्स ज्यात मुख्य कॅल्क्युलेशन्स आणि AI इंटरप्रिटेशन्स समाविष्ट आहेत.

Claude सोबत संवादाचा उदाहरण

युजर: 14 जुलै 1990 रोजी सकाळी 2:30 वाजता київमध्ये जन्मलेल्या व्यक्तीचा नेटल चार्ट बनवा. 10व्या घरात कर्क राशीत सूर्याचा अर्थ काय?

Claude: natal_chart वापरून कॅल्क्युलेशन करते, मग interpret_placement वापरून इंटरप्रिटेशन करते. वास्तविक डेटासह ग्रहांच्या स्थिती आणि अर्थपूर्ण इंटरप्रिटेशन परत करते.

HTTP API

MCP सपोर्ट नसलेल्या AI एजंट्ससाठी — थेट HTTP API वापरा.

कंटेंट जनरेशनसाठी

TypeScript

// AI एजंट /interpret/natal ला कॉल करतो नेटल इंटरप्रिटेशनसाठी
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 result = await r.json();
// result.text — तयार AI इंटरप्रिटेशन
// result.disclaimer — प्रदर्शनासाठी disclaimer

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()
# result['text'] — तयार AI इंटरप्रिटेशन
# result['disclaimer'] — प्रदर्शनासाठी disclaimer

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);
// $result['text']       — तयार AI इंटरप्रिटेशन
// $result['disclaimer'] — प्रदर्शनासाठी disclaimer

कॅल्क्युलेशन्स + तुमचा स्वतःचा LLM

// 1. /chart द्वारे raw डेटा मिळवा (स्वस्त — 20 credits)
const chart = await fetch('https://api.astroway.info/v1/chart', { ... });
const data = await chart.json();

// 2. डेटा तुमच्या LLM मध्ये पाठवा
const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`;
const llmResponse = await myLLM.generate(prompt);

संकेत

फक्त इंटरप्रिटेशनची गरज असेल तर /interpret/* वापरा (50 credits, टेक्स्ट तयार). तुमचा स्वतःचा प्रमोट कंट्रोल करायचा असेल तर /chart वापरा (20 credits) आणि डेटा तुमच्या LLM मध्ये पाठवा.

परिस्थिती

वैयक्तिक अॅस्ट्रॉलॉजिकल असिस्टंट

MCP सर्व्हर + Claude/ChatGPT. युजर विचारतो — एजंट कॅल्क्युलेट करतो आणि इंटरप्रिट करतो. बजेट: वैयक्तिक वापरासाठी फ्री प्लॅन.

सोशल मीडिया साठी कंटेंट-बोट

12 राशींसाठी दैनिक होरोस्कोप जनरेशन /horoscope/daily द्वारे. 12 requests/day = 240 credits. फ्री प्लॅन मोठ्या प्रमाणात पुरेसा.

AI कोचिंग प्लॅटफॉर्म

प्रत्येक क्लायंटसाठी /interpret/natal + /interpret/transits. 100 क्लायंट्स/दिवस = 10,000 credits/दिवस. Pro प्लॅन.

झटपट सुरुवात → पहिला कॉल 5 मिनिटांत

HoroScope API AI इंटरप्रिटेशन्स आणि होरोस्कोप्स

प्लॅन्स फ्री ते Enterprise पर्यंत