Konfiguracja agenta

Podłącz API AstroWay do agentów AI przez MCP (Model Context Protocol). Katalog jest dostępny na dwa sposoby, oba z Twoimi kluczami aw_test_* / aw_live_*:

• Hosted (HTTP): https://mcp.astroway.info/mcp, bez instalacji, uwierzytelnianie tokenem Bearer.
• Stdio (npx): npx @astroway/mcp, lokalny podproces, uwierzytelnianie przez zmienną środowiskową, działa offline.

Odbierz darmowy klucz w panelu, a następnie wybierz swojego klienta.

Jedna domena zamiast całego katalogu

843 narzędzi w jednej odpowiedzi to 3.4 MB, które agent musi przeczytać, zanim wybierze jedno. Większość klientów poddaje się dużo wcześniej.

https://mcp.astroway.info/mcp/<domena> zwraca jeden obszar zamiast wszystkiego. Konfiguracja jest ta sama, zmienia się tylko URL.

Domena	URL	Narzędzi	Rozmiar tools/list
Rdzeń astrologii	/mcp/core	104	389 KB
Wedyjska	/mcp/vedic	192	970 KB
Metafizyka chińska	/mcp/chinese	60	202 KB
Hellenizm i tradycja	/mcp/hellenistic	59	240 KB
Tarot	/mcp/tarot	79	209 KB
Numerologia	/mcp/numerology	64	158 KB
Human Design	/mcp/human-design	27	125 KB
Prognostyka	/mcp/forecast	43	209 KB
Relacje	/mcp/relationships	42	247 KB
Psychologiczna	/mcp/psychological	28	107 KB
Wróżenie i ezoteryka	/mcp/divination	79	185 KB
Odczyty praktyczne	/mcp/applied	45	148 KB
Raporty	/mcp/reports	42	209 KB
Platforma	/mcp/platform	42	119 KB

Zmierzone na produkcji 2026-09-21. /mcp nadal zwraca cały katalog, więc nic, co skonfigurowano wcześniej, się nie zepsuło. Sprawdzenie salda i wycena kosztu wywołania są w każdej domenie, bo agent ograniczony do astrologii wedyjskiej i tak musi wiedzieć, ile kosztuje wywołanie.

GET /domains zwraca tę samą listę jako JSON, bez klucza. Nieznana domena to 404 z listą prawdziwych, a nie ciche zwrócenie wszystkich 843.

Dokumentacja bez klucza: /mcp/docs

Pierwsze pytanie agenta nigdy nie brzmi “policz horoskop”. Brzmi raczej “co potrafi to API, jak wygląda wywołanie i ile mnie to będzie kosztować”. Na wszystkie trzy można odpowiedzieć bez klucza: https://mcp.astroway.info/mcp/docs nie zużywa ani jednego kredytu, więc nie prosi też o autoryzację.

Narzędzie	Co robi
find_endpoint	Szuka wśród wszystkich 770 operacji. Dla każdej zwraca metodę, URL, cenę w kredytach, plan, wymagane pola body i link do dokumentacji
search_docs	Szuka w 281 stronach przewodników, ukraińskich i angielskich, z listą sekcji każdej z nich
read_doc	Zwraca jedną stronę jako markdown
list_docs	Cały indeks, pogrupowany według sekcji

Cenę ma 700 z 770 operacji, kolejne 37 jest oznaczonych jako odpowiadające bez klucza. Czyli koszt scenariusza można policzyć, zanim powstanie konto.

terminal

curl https://mcp.astroway.info/mcp/docs \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_endpoint","arguments":{"query":"solar return","limit":2}}}'

read_doc czyta tylko strony, które są w indeksie. Każda inna ścieżka dostaje odmowę, a żadne żądanie na zewnątrz przy tym nie wychodzi.

Proś o mniej niż całą odpowiedź

Każde narzędzie przyjmuje dwa parametry ponad własne: fields (lista ścieżek rozdzielonych przecinkami, względem data) i precision (ile miejsc po przecinku zostawić). Trafiają do tego samego API co przez REST, a różnica w tokenach nie jest retoryczna.

Wywołanie kosmogramu urodzeniowego przez MCP	Bajtów
bez parametrów, jak było przed 21.09.2026	91 737
bez parametrów, dziś	72 484
precision: 2	61 356
fields: "planets.name,planets.longitude,houses.cusp" plus precision: 2	1 182

Zmierzone na produkcji 2026-09-21. Kredyty są takie same we wszystkich czterech wierszach: za różnicę płaci ten, kto czyta odpowiedź.

Ścieżka, która nie pasowała do żadnego pola, wraca w _fields_unmatched. Lista, w której nic nie pasowało, to 400 FIELDS_UNKNOWN z wyliczeniem, a nie pusta odpowiedź. Pełny opis obu parametrów: konwencje API.

Wybierz swojego klienta

Claude Desktop Hosted MCP przez plik konfiguracyjny

Claude Code Jedno polecenie CLI

Cursor Hosted MCP przez plik konfiguracyjny

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline Pakiet stdio przez npx

Codex CLI Pakiet stdio przez npx

CI / raw HTTP

Całkiem bez klienta - hostowany endpoint mówi JSON-RPC po HTTP. Lista narzędzi z tokenem Bearer:

terminal

curl https://mcp.astroway.info/mcp \
-H "Authorization: Bearer aw_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Function calling bez MCP

Jeśli Twój agent mówi językiem function calling od OpenAI lub Anthropic, a nie MCP, poproś API o gotowe definicje narzędzi i przekaż je modelowi bezpośrednio. Są generowane z dokumentu OpenAPI, więc schemat, który wypełnia model, to ten sam schemat, który waliduje endpoint.

terminal

curl "https://api.astroway.info/v1/agent/tools?format=openai" \
-H "X-Api-Key: aw_live_YOUR_KEY"

Odpowiedź ma dwie połowy. tools dokładnie odpowiada kontraktowi dostawcy i nie niesie niczego naszego, więc można go wkładać do wywołania modelu bez zmian: nadmiarowy klucz wewnątrz obiektu narzędzia to 400 po ich stronie. executors mówi, jak wykonać każde narzędzie, i ma te same klucze, które zwróci model:

odpowiedź, skrócona

{
"tools": [
  { "type": "function", "function": { "name": "astroway_post_chart", "description": "Natal chart...",
    "parameters": { "type": "object", "required": ["date", "time", "latitude", "longitude"], "properties": { "...": {} } } } }
],
"executors": {
  "astroway_post_chart": { "method": "POST", "path": "/v1/chart", "credits": 20, "group": "Core" }
},
"count": 26, "totalMatched": 26, "totalAvailable": 751, "truncated": false
}

Twój wykonawca to potem pięć linii: znaleźć nazwę w executors, wysłać argumenty modelu jako body JSON na tę ścieżkę z własnym X-Api-Key, zwrócić odpowiedź modelowi. Żadne narzędzie nie zawiera danych uwierzytelniających, więc tę listę można bezpiecznie cache’ować.

To Ty wybierasz, co widzi model. Domyślnie jest to wyselekcjonowany zestaw startowy 26 narzędzi, a nie cały katalog: OpenAI ogranicza żądanie do 128 funkcji, a modele zaczynają gorzej wybierać długo przed tą granicą. Zawężaj lub rozszerzaj przez select=all, select=group:Vedic, select=paths:/chart,/synastry, filtruj wewnątrz przez q=, ograniczaj przez limit= (maksymalnie 128). Nic nie znika po cichu: totalMatched i notes mówią, co zostało poza zakresem. Dodaj format=anthropic, aby dostać { name, description, input_schema }.

Wywołanie jest darmowe i nie zużywa kredytów.

Własny klucz do modelu

Na endpointach, gdzie generujemy tekst, możesz sam płacić za tokeny. Dwa nagłówki, albo oba, albo żaden:

terminal

curl https://api.astroway.info/v1/ai/explain-aspect \
-H "X-Api-Key: aw_live_YOUR_KEY" \
-H "X-Provider: anthropic" \
-H "X-Provider-Key: sk-ant-YOUR_PROVIDER_KEY" \
-H "Content-Type: application/json" \
-d '{"planet1":"Saturn","planet2":"Moon","aspectType":"Square"}'

X-Provider to jeden z openai, anthropic, google, groq, mistral, openrouter, deepseek, together; adres dla każdego jest ustalony po naszej stronie i nigdy nie jest brany z żądania. X-Provider-Model jest opcjonalny i nadpisuje model domyślny.

Nie ma powrotu do naszego łańcucha. Jeśli Twój klucz nie zadziałał, dostaniesz status i komunikat dostawcy, a nie odpowiedź, za którą zapłaciliśmy my: cichy fallback zużywałby nasze tokeny na żądanie, które uważałeś za swoje, i nie dałoby się tego zauważyć.

Takie wywołanie kosztuje 5 kredytów zamiast ceny endpointu. I tak liczymy horoskop, składamy prompt i przepuszczamy zabezpieczenia; completion kupiłeś Ty.

Twój klucz nigdzie nie jest logowany, przechowywany ani cache’owany. Idzie nagłówkiem, bo body żądania jest hashowane do dwóch kluczy cache, a nasz dziennik żądań w ogóle nie zapisuje nagłówków. Błąd dostawcy, który zacytował Twój klucz, jest redagowany, zanim trafi do naszych logów lub Twojej odpowiedzi. Wywołanie z Twoim kluczem omija oba cache w obie strony: nigdy nie dostanie odpowiedzi, którą wygenerowaliśmy my, a jego odpowiedź nigdy nie trafi do nikogo innego.

Nagłówki są w specyfikacji. Każda ścieżka, która je przyjmuje, deklaruje X-Provider, X-Provider-Key i X-Provider-Model w /v1/openapi.json, więc wygenerowany klient podłączy je jak każdy inny parametr i ta strona nie będzie mu potrzebna. Są zadeklarowane tylko tam, gdzie naprawdę wywołujemy model: wysłać je na /chart można, ale nic się nie stanie i zapłacisz zwykłą cenę endpointu.

Specyfikacje do odczytu maszynowego

Chcesz podłączyć REST API bezpośrednio albo dać specyfikację własnemu agentowi?

• AGENTS.md: /AGENTS.md, instrukcje dla agenta (co można wywołać bez klucza, kontrakt żądania, koperta odpowiedzi, nagłówki limitów)
• OpenAPI: /v1/openapi.json
• llms.txt: /llms.txt · pełny tekst /llms-full.txt
• Postman: /postman/astroway-api.json
• SDK: TypeScript, Python, PHP