AI-агенти та MCP

Будуєш AI-агента, що має робити справжні астрологічні розрахунки замість галюцинацій? 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 у браузері, кастомні RAG-пайплайни на LangChain/LlamaIndex).
• MCP сервер: zero-code для Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) і будь-якого MCP-сумісного клієнта (включаючи GPT з MCP через OpenAI Realtime API).
• HTTP API: пряме звернення з власного агента або фреймворка (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt: discovery для AI-агентів

Сайт експонує два машиночитані файли у форматі llms.txt:

• /llms.txt: індекс усіх сторінок документації згрупований за секціями (API Reference, Use Cases, Examples, Products). Невеликий, влазить у будь-який context window.
• /llms-full.txt: увесь зміст документації одним plain-text файлом. Підходить для офлайн-індексування у векторну БД або одноразового вливання в context.

Коли використовувати

Сценарій	Файл
Cursor/Windsurf “прочитай docs astroway й допоможи з інтеграцією”	/llms.txt (агент сам підтягне потрібні розділи)
Власний RAG-пайплайн / векторна БД для FAQ-бота	/llms-full.txt (один fetch - увесь корпус)
Claude/ChatGPT у браузері: “ось наш API, побудуй клієнт”	/llms-full.txt приклеїти у промпт
Production-агент із виконанням викликів	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 збігається з поточним production deploy.

MCP сервер (рекомендований для Claude Desktop)

Model Context Protocol (MCP) - відкритий стандарт для підключення інструментів до AI-моделей. Хостований MCP-сервер AstroWay надає 843 інструментів, по одному на кожну операцію 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 побачить усі 735 інструментів npm-пакета. Щоб скоротити список, задайте 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	Поточні транзити

Повний список: 843 інструментів на хостованому сервері, увесь API, 795 з них з типізованою схемою відповіді.

Приклад діалогу з Claude

Користувач: Побудуй натальну карту для людини, народженої 14 липня 1990 о 14:30 у Києві. Що означає Сонце в Раку в 10 будинку?

Claude: Використовує astroway_western_chart для розрахунку, потім astroway_ai_interpret_placement для інтерпретації. Повертає позиції планет з реальними даними та осмислену інтерпретацію.

HTTP API

Для AI-агентів без MCP-підтримки - використовуй 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-інтерпретації та гороскопи

Тарифи Від безкоштовного до Enterprise