AI-ügynökök és MCP

Olyan AI-ügynököt építesz, amely valódi asztrológiai számításokat végez hallucinációk helyett? Az AstroWay a Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral rendszerekhez csatlakozik – MCP-n, llms.txt-n vagy közvetlen HTTP-hívásokon keresztül. Három integrációs mód – válassz az ügynök típusa szerint:

• llms.txt: discovery-fájlok dokumentációt olvasó ügynökökhöz (Cursor IDE, Windsurf, Claude a böngészőben, egyedi RAG-pipeline-ok LangChain/LlamaIndex alapon).
• MCP szerver: zero-code megoldás Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) és bármely MCP-kompatibilis kliens számára (beleértve a GPT-t MCP-vel az OpenAI Realtime API-n keresztül).
• HTTP API: közvetlen hívás saját ügynökből vagy frameworkből (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt: discovery AI-ügynököknek

Az oldal két géppel olvasható fájlt tesz közzé llms.txt formátumban:

• /llms.txt: az összes dokumentációs oldal indexe, szekciók szerint csoportosítva (API Reference, Use Cases, Examples, Products). Kicsi, bármely context window-ba belefér.
• /llms-full.txt: a teljes dokumentáció egyetlen plain-text fájlban. Ideális offline indexeléshez vektoros adatbázisba vagy egyszeri context-be töltéshez.

Mikor használd

Forgatókönyv	Fájl
Cursor/Windsurf “olvasd el az astroway docs-ot és segíts az integrációban”	/llms.txt (az ügynök maga tölti le a szükséges szakaszokat)
Saját RAG-pipeline / vektoros adatbázis FAQ-bothoz	/llms-full.txt (egy fetch – a teljes korpusz)
Claude/ChatGPT a böngészőben: “itt az API-nk, építs klienst”	/llms-full.txt beillesztve a promptba
Production-ügynök hívásvégrehajtással	MCP szerver vagy HTTP API (lásd lent)

Példa: letöltés saját ügynökbe

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

Megjegyzés

A fájlok minden webhely-kiadásnál automatikusan újragenerálódnak. A frissesség garantált: a /llms.txt végén szereplő API-verzió megegyezik az aktuális production deploy-val.

MCP szerver (ajánlott Claude Desktophoz)

A Model Context Protocol (MCP) nyílt szabvány eszközök AI-modellekhez csatlakoztatására. Az AstroWay MCP-szervere 783 eszközt biztosít, egyet minden API-művelethez, valamint 12 promptot és 14 erőforrást.

Beállítás Claude Desktophoz

Add hozzá a claude_desktop_config.json fájlhoz:

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

Újraindítás után a Claude Desktop mind a 783 eszközt látja. A lista csökkentéséhez állítsd be az ASTROWAY_TOOL_GROUPS változót, vagy csatlakozz domain-szerverhez, lásd MCP beállítása.

Mit tud az MCP szerver

Eszköz	Mit csinál
astroway_western_chart	Születési horoszkóp számítása
astroway_relational_synastry	Két ember szinasztriája
astroway_horoscope_daily	Napi horoszkóp
astroway_ai_interpret_natal	Születési horoszkóp AI-értelmezése
astroway_hd_human_design	Teljes HD-kártya
astroway_prognostics_transits	Aktuális tranzitok

Teljes lista: 783 eszköz, az egész API, mindegyik típusos válasz-sémával.

Példa párbeszéd Claude-dal

Felhasználó: Készíts születési horoszkópot egy 1990. július 14-én 14:30-kor Kijevben született embernek. Mit jelent a Nap a Rákban a 10. házban?

Claude: Az astroway_western_chart eszközt használja a számításhoz, majd az astroway_ai_interpret_placement eszközt az értelmezéshez. Valós adatokkal adja vissza a bolygópozíciókat és egy értelmes értelmezést.

HTTP API

MCP-támogatás nélküli AI-ügynökökhöz – használd közvetlenül a HTTP API-t.

Tartalomgeneráláshoz

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

Számításokhoz + saját 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);

Tipp

Ha csak értelmezés kell – használd a /interpret/* endpointot (50 kredit, a szöveg kész). Ha te akarod irányítani a promptot – vedd a /chart endpointot (20 kredit) és add át az adatokat a saját LLM-ednek.

Forgatókönyvek

Személyes asztrológiai asszisztens

MCP szerver + Claude/ChatGPT. A felhasználó kérdez – az ügynök számol és értelmez. Költségkeret: Free csomag személyes használatra.

Tartalom-bot közösségi médiához

Napi horoszkópok generálása 12 jegyre a /horoscope/daily endpointon keresztül. 12 kérés naponta = 240 kredit. Free csomag bőséges tartalékkal.

AI-coaching platform

/interpret/natal + /interpret/transits minden ügyfélhez. 100 ügyfél/nap = 10 000 kredit/nap. Pro csomag.

Gyors kezdés → Első kérés 5 perc alatt

Horoscope API AI-értelmezések és horoszkópok

Csomagok Ingyenestől Enterprise-ig