AI agenti a MCP

Stavíš AI agenta, který má dělat skutečné astrologické výpočty místo halucinací? AstroWay se připojuje k Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral – přes MCP, llms.txt nebo přímé HTTP volání. Tři způsoby integrace – vybírej podle typu agenta:

• llms.txt: discovery soubory pro agenty, kteří čtou dokumentaci (Cursor IDE, Windsurf, Claude v prohlížeči, vlastní RAG pipeline na LangChain/LlamaIndex).
• MCP server: zero-code pro Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) a jakéhokoli MCP kompatibilního klienta (včetně GPT s MCP přes OpenAI Realtime API).
• HTTP API: přímé volání z vlastního agenta nebo frameworku (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt: discovery pro AI agenty

Stránka vystavuje dva strojově čitelné soubory ve formátu llms.txt:

• /llms.txt: index všech stránek dokumentace seskupený podle sekcí (API Reference, Use Cases, Examples, Products). Malý, vejde se do jakéhokoli context window.
• /llms-full.txt: celý obsah dokumentace v jednom plain-text souboru. Vhodný pro offline indexování do vektorové DB nebo jednorázové vložení do contextu.

Kdy použít

Scénář	Soubor
Cursor/Windsurf “přečti docs astroway a pomoz s integrací”	/llms.txt (agent si sám načte potřebné sekce)
Vlastní RAG pipeline / vektorová DB pro FAQ bota	/llms-full.txt (jedno fetch - celý korpus)
Claude/ChatGPT v prohlížeči: “tady je náš API, postav klienta”	/llms-full.txt přilepit do promptu
Production agent s prováděním volání	MCP server nebo HTTP API (viz níže)

Příklad: pull do vlastního agenta

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

Poznámka

Soubory se regenerují automaticky při každém vydání stránky. Čerstvost je garantována: verze API na konci /llms.txt odpovídá aktuálnímu production deploy.

MCP server (doporučeno pro Claude Desktop)

Model Context Protocol (MCP) – otevřený standard pro připojení nástrojů k AI modelům. MCP server AstroWay poskytuje 783 nástrojů, po jednom pro každou operaci API, a také 12 promptů a 14 zdrojů.

Nastavení pro Claude Desktop

Přidej do claude_desktop_config.json:

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

Po restartu Claude Desktop uvidí všech 783 nástrojů. Pro zkrácení seznamu nastav ASTROWAY_TOOL_GROUPS nebo připoj doménový server, viz nastavení MCP.

Co může MCP server

Nástroj	Co dělá
astroway_western_chart	Výpočet natal chart
astroway_relational_synastry	Synastrie dvou lidí
astroway_horoscope_daily	Denní horoskop
astroway_ai_interpret_natal	AI interpretace natal chart
astroway_hd_human_design	Kompletní HD karta
astroway_prognostics_transits	Aktuální tranzity

Úplný seznam: 783 nástrojů, celé API, každý s typizovaným schématem odpovědi.

Příklad dialogu s Claude

Uživatel: Vytvoř natal chart pro osobu narozenou 14. července 1990 v 14:30 v Kyjevě. Co znamená Slunce v Raku v 10. domě?

Claude: Používá astroway_western_chart pro výpočet, pak astroway_ai_interpret_placement pro interpretaci. Vrací pozice planet s reálnými daty a smysluplnou interpretaci.

HTTP API

Pro AI agenty bez MCP podpory – použij HTTP API přímo.

Pro generování obsahu

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

Pro výpočty + vlastní 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);

Tip

Pokud potřebuješ jen interpretaci – použij /interpret/* (50 kreditů, text připraven). Pokud chceš kontrolovat prompt – vezmi /chart (20 kreditů) a předávej data do svého LLM.

Scénáře

Osobní astrologický asistent

MCP server + Claude/ChatGPT. Uživatel se ptá – agent počítá a interpretuje. Rozpočet: Free tarif pro osobní použití.

Content bot pro sociální sítě

Denní generování horoskopů pro 12 znamení přes /horoscope/daily. 12 požadavků denně = 240 kreditů. Free tarif s velkým pohrabáním.

AI coaching platforma

/interpret/natal + /interpret/transits pro každého klienta. 100 klientů/den = 10 000 kreditů/den. Tarif Pro.

Rychlý start → První požadavek za 5 minut

Horoscope API AI interpretace a horoskopy

Tarify Od zdarma po Enterprise