# 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](https://llmstxt.org/) फॉरमॅटमध्ये दोन मशीन-वाचनीय फाइल्स एक्स्पोज करते:

- **[`/llms.txt`](https://api.astroway.info/llms.txt)** — API Reference, Use Cases, Examples, Products अशा विभागांमध्ये गटबद्ध केलेले डॉक्युमेंटेशन पेजेसचे इंडेक्स. लहान आहे, कोणत्याही context window मध्ये बसतो.
- **[`/llms-full.txt`](https://api.astroway.info/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 करणे

```ts
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.`;
```

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

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

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

### Claude Desktop साठी सेटअप

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

```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 वापरा.

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

<Tabs syncKey="lang">
  <TabItem label="TypeScript">
    ```ts
    // 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
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    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
    ```
  </TabItem>
  <TabItem label="cURL">
    ```bash frame="terminal"
    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
      }'
    ```
  </TabItem>
  <TabItem label="PHP">
    ```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
    ```
  </TabItem>
</Tabs>

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

```ts
// 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);
```

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

## परिस्थिती

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

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

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

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

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

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

<CardGrid>
  <LinkCard title="झटपट सुरुवात →" href="/getting-started/" description="पहिला कॉल 5 मिनिटांत" />
  <LinkCard title="HoroScope API" href="/products/horoscope-api/" description="AI इंटरप्रिटेशन्स आणि होरोस्कोप्स" />
  <LinkCard title="प्लॅन्स" href="/pricing/" description="फ्री ते Enterprise पर्यंत" />
</CardGrid>