Agenci AI i MCP

Budujesz agenta AI, który ma wykonywać prawdziwe obliczenia astrologiczne zamiast halucynacji? AstroWay łączy się z Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral - poprzez MCP, llms.txt lub bezpośrednie wywołania HTTP. Trzy sposoby integracji - wybierz w zależności od typu agenta:

• llms.txt: pliki discovery dla agentów czytających dokumentację (Cursor IDE, Windsurf, Claude w przeglądarce, niestandardowe potoki RAG na LangChain/LlamaIndex).
• Serwer MCP: zero-code dla Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) i każdego klienta kompatybilnego z MCP (w tym GPT z MCP poprzez OpenAI Realtime API).
• HTTP API: bezpośrednie wywołanie z własnego agenta lub frameworka (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt: discovery dla agentów AI

Strona udostępnia dwa pliki czytelne maszynowo w formacie llms.txt:

• /llms.txt: indeks wszystkich stron dokumentacji pogrupowany według sekcji (API Reference, Use Cases, Examples, Products). Niewielki, mieści się w każdym context window.
• /llms-full.txt: cała zawartość dokumentacji w jednym pliku plain-text. Nadaje się do indeksowania offline w wektorowej bazie danych lub jednorazowego wstrzyknięcia do contextu.

Kiedy używać

Scenariusz	Plik
Cursor/Windsurf “przeczytaj docs astroway i pomóż z integracją”	/llms.txt (agent sam pobierze potrzebne sekcje)
Własny potok RAG / wektorowa baza danych dla bota FAQ	/llms-full.txt (jedno pobranie - cały korpus)
Claude/ChatGPT w przeglądarce: “oto nasze API, zbuduj klienta”	Wklej /llms-full.txt do promptu
Agent produkcyjny z wykonywaniem wywołań	Serwer MCP lub HTTP API (patrz poniżej)

Przykład: pobieranie do własnego 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.`;

Notatka

Pliki są generowane automatycznie przy każdym wydaniu strony. Świeżość gwarantowana: wersja API na końcu /llms.txt jest zgodna z bieżącym wdrożeniem produkcyjnym.

Serwer MCP (zalecany dla Claude Desktop)

Model Context Protocol (MCP) - otwarty standard do podłączania narzędzi do modeli AI. Serwer MCP AstroWay udostępnia 783 narzędzia, po jednym dla każdej operacji API, a także 12 promptów i 14 zasobów.

Konfiguracja dla Claude Desktop

Dodaj do claude_desktop_config.json:

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

Po ponownym uruchomieniu Claude Desktop zobaczy wszystkie 783 narzędzia. Aby skrócić listę, ustaw ASTROWAY_TOOL_GROUPS lub podłącz serwer domenowy, zobacz konfigurację MCP.

Co potrafi serwer MCP

Narzędzie	Co robi
astroway_western_chart	Obliczenie horoskopu urodzeniowego
astroway_relational_synastry	Synastria dwóch osób
astroway_horoscope_daily	Horoskop dzienny
astroway_ai_interpret_natal	Interpretacja AI horoskopu urodzeniowego
astroway_hd_human_design	Pełna mapa HD
astroway_prognostics_transits	Bieżące tranzyty

Pełna lista: 783 narzędzia, całe API, każde z typizowanym schematem odpowiedzi.

Przykład dialogu z Claude

Użytkownik: Zbuduj horoskop urodzeniowy dla osoby urodzonej 14 lipca 1990 o 14:30 w Kijowie. Co oznacza Słońce w Raku w 10. domu?

Claude: Używa astroway_western_chart do obliczeń, a następnie astroway_ai_interpret_placement do interpretacji. Zwraca pozycje planet z rzeczywistymi danymi i sensowną interpretację.

HTTP API

Dla agentów AI bez wsparcia MCP - użyj bezpośrednio HTTP API.

Do generowania treści

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

Do obliczeń + własny 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);

Wskazówka

Jeśli potrzebujesz tylko interpretacji - użyj /interpret/* (50 kredytów, tekst gotowy). Jeśli chcesz kontrolować prompt - weź /chart (20 kredytów) i przekaż dane do swojego LLM.

Scenariusze

Osobisty asystent astrologiczny

Serwer MCP + Claude/ChatGPT. Użytkownik pyta - agent oblicza i interpretuje. Budżet: plan Free do użytku osobistego.

Bot do treści dla mediów społecznościowych

Codzienne generowanie horoskopów dla 12 znaków poprzez /horoscope/daily. 12 zapytań dziennie = 240 kredytów. Plan Free z dużym zapasem.

Platforma AI do coachingu

/interpret/natal + /interpret/transits dla każdego klienta. 100 klientów/dzień = 10 000 kredytów/dzień. Plan Pro.

Szybki start → Pierwsze zapytanie w 5 minut

Horoscope API Interpretacje AI i horoskopy

Plany cenowe Od darmowego do Enterprise