Ρύθμιση agent

Σύνδεσε το API του AstroWay με AI agents μέσω MCP (Model Context Protocol). Ο κατάλογος είναι διαθέσιμος με δύο τρόπους, και οι δύο με τα κλειδιά σου aw_test_* / aw_live_*:

Hosted (HTTP): https://mcp.astroway.info/mcp, χωρίς εγκατάσταση, αυθεντικοποίηση μέσω Bearer token.
Stdio (npx): npx @astroway/mcp, τοπική υποδιεργασία, αυθεντικοποίηση μέσω μεταβλητής περιβάλλοντος, λειτουργεί offline.

Πάρε δωρεάν κλειδί από το dashboard και μετά επίλεξε τον client σου.

Ένας τομέας αντί για ολόκληρο τον κατάλογο

783 εργαλεία σε μία απάντηση σημαίνουν 2.9 MB, που ο agent πρέπει να διαβάσει πριν επιλέξει ένα. Οι περισσότεροι clients τα παρατάνε πολύ νωρίτερα.

Το https://mcp.astroway.info/mcp/<τομέας> επιστρέφει ένα θεματικό πεδίο αντί για όλα. Η ρύθμιση είναι η ίδια, αλλάζει μόνο το URL.

Τομέας	URL	Εργαλεία	Μέγεθος `tools/list`
Πυρήνας αστρολογίας	`/mcp/core`	104	389 KB
Βεδική	`/mcp/vedic`	192	970 KB
Κινεζική μεταφυσική	`/mcp/chinese`	60	202 KB
Ελληνιστική και παράδοση	`/mcp/hellenistic`	59	240 KB
Ταρώ	`/mcp/tarot`	79	209 KB
Αριθμολογία	`/mcp/numerology`	64	158 KB
Human Design	`/mcp/human-design`	27	125 KB
Προγνωστική	`/mcp/forecast`	43	209 KB
Σχέσεις	`/mcp/relationships`	42	247 KB
Ψυχολογική	`/mcp/psychological`	28	107 KB
Μαντεία και εσωτερισμός	`/mcp/divination`	79	185 KB
Εφαρμοσμένες αναγνώσεις	`/mcp/applied`	45	148 KB
Αναφορές	`/mcp/reports`	42	209 KB
Πλατφόρμα	`/mcp/platform`	42	119 KB

Μετρήθηκε στο production στις 2026-09-21. Το /mcp εξακολουθεί να επιστρέφει ολόκληρο τον κατάλογο, οπότε τίποτα από όσα ρυθμίστηκαν νωρίτερα δεν χάλασε. Ο έλεγχος υπολοίπου και η εκτίμηση κόστους κλήσης υπάρχουν σε κάθε τομέα, γιατί ένας agent περιορισμένος στη βεδική αστρολογία πρέπει κι αυτός να ξέρει πόσο κοστίζει μια κλήση.

Το GET /domains επιστρέφει αυτή την ίδια λίστα ως JSON, χωρίς κλειδί. Ένας άγνωστος τομέας δίνει 404 με τη λίστα των πραγματικών, όχι σιωπηλή επιστροφή και των 783.

Τεκμηρίωση χωρίς κλειδί: `/mcp/docs`

Η πρώτη ερώτηση ενός agent δεν είναι ποτέ “υπολόγισε έναν χάρτη”. Είναι “τι μπορεί να κάνει αυτό το API, πώς μοιάζει μια κλήση και πόσο θα μου κοστίσει”. Και στις τρεις μπορείς να απαντήσεις χωρίς κλειδί: το https://mcp.astroway.info/mcp/docs δεν ξοδεύει ούτε ένα credit, οπότε δεν ζητά ούτε αυθεντικοποίηση.

Εργαλείο	Τι κάνει
`find_endpoint`	Αναζητά ανάμεσα σε όλες τις 770 λειτουργίες. Για κάθε μία επιστρέφει μέθοδο, URL, τιμή σε credits, πλάνο, υποχρεωτικά πεδία του body και σύνδεσμο στην τεκμηρίωση αναφοράς
`search_docs`	Αναζητά σε 281 σελίδες οδηγών, ουκρανικές και αγγλικές, με τη λίστα ενοτήτων της καθεμιάς
`read_doc`	Επιστρέφει μία σελίδα ως markdown
`list_docs`	Ολόκληρο το ευρετήριο, ομαδοποιημένο ανά ενότητα

Τιμή έχουν 700 από τις 770 λειτουργίες, ενώ άλλες 37 επισημαίνονται ως λειτουργίες που απαντούν χωρίς κλειδί. Δηλαδή το κόστος ενός σεναρίου μπορεί να υπολογιστεί πριν καν υπάρξει λογαριασμός.

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 διαβάζει μόνο τις σελίδες που υπάρχουν στο ευρετήριο. Οποιαδήποτε άλλη διαδρομή απορρίπτεται, και κανένα αίτημα δεν φεύγει προς τα έξω.

Ζήτα λιγότερα από ολόκληρη την απάντηση

Κάθε εργαλείο δέχεται δύο παραμέτρους επιπλέον των δικών του: fields (λίστα διαδρομών χωρισμένων με κόμμα, σχετικά με το data) και precision (πόσα δεκαδικά ψηφία να κρατηθούν). Περνούν στο ίδιο API όπως και μέσω REST, και η διαφορά σε tokens δεν είναι ρητορική.

Κλήση γενέθλιου χάρτη μέσω MCP	Bytes
χωρίς παραμέτρους, όπως ήταν πριν από τις 21.09.2026	91 737
χωρίς παραμέτρους, σήμερα	72 484
`precision: 2`	61 356
`fields: "planets.name,planets.longitude,houses.cusp"` μαζί με `precision: 2`	1 182

Μετρήθηκε στο production στις 2026-09-21. Τα credits είναι ίδια και στις τέσσερις γραμμές: τη διαφορά την πληρώνει αυτός που διαβάζει την απάντηση.

Μια διαδρομή που δεν ταίριαξε με κανένα πεδίο επιστρέφεται στο _fields_unmatched. Μια λίστα όπου δεν ταίριαξε τίποτα δίνει 400 FIELDS_UNKNOWN με την αναλυτική λίστα, όχι κενή απάντηση. Πλήρης περιγραφή και των δύο παραμέτρων: συμβάσεις API.

Επίλεξε τον client σου

Claude Desktop Hosted MCP μέσω αρχείου ρυθμίσεων

Claude Code Μία εντολή CLI

Cursor Hosted MCP μέσω αρχείου ρυθμίσεων

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline Πακέτο npx stdio

Codex CLI Πακέτο npx stdio

CI / raw HTTP

Εντελώς χωρίς client - το hosted endpoint μιλά JSON-RPC πάνω από HTTP. Λίστα εργαλείων με Bearer token:

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 χωρίς MCP

Αν ο agent σου μιλά τη γλώσσα του function calling της OpenAI ή της Anthropic και όχι MCP, ζήτα από το API έτοιμους ορισμούς εργαλείων και πέρασέ τους απευθείας στο μοντέλο. Παράγονται από το έγγραφο OpenAPI, οπότε το σχήμα που συμπληρώνει το μοντέλο είναι το ίδιο σχήμα που ελέγχει το endpoint.

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

Η απάντηση έχει δύο μισά. Το tools αντιστοιχεί ακριβώς στο συμβόλαιο του vendor και δεν περιέχει τίποτα δικό μας, οπότε μπαίνει στην κλήση του μοντέλου όπως είναι: ένα περιττό κλειδί μέσα στο αντικείμενο του εργαλείου σημαίνει 400 από τη μεριά τους. Το executors λέει πώς εκτελείται κάθε εργαλείο και έχει τα ίδια κλειδιά που θα επιστρέψει το μοντέλο:

{
"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
}

Ο εκτελεστής σου μετά από αυτό είναι πέντε γραμμές: βρες το όνομα στο executors, στείλε τα ορίσματα του μοντέλου ως JSON body σε αυτή τη διαδρομή με το δικό σου X-Api-Key, επίστρεψε την απάντηση στο μοντέλο. Κανένα εργαλείο δεν περιέχει διαπιστευτήρια, οπότε αυτή η λίστα μπορεί να γίνει cache με ασφάλεια.

Εσύ επιλέγεις τι βλέπει το μοντέλο. Από προεπιλογή είναι ένα επιμελημένο αρχικό σύνολο 26 εργαλείων, όχι ολόκληρος ο κατάλογος: η OpenAI περιορίζει ένα αίτημα σε 128 συναρτήσεις, και τα μοντέλα αρχίζουν να επιλέγουν χειρότερα πολύ πριν από αυτό το όριο. Στένεψε ή διεύρυνε με select=all, select=group:Vedic, select=paths:/chart,/synastry, φίλτραρε εσωτερικά με q=, περιόρισε με limit= (μέγιστο 128). Τίποτα δεν εξαφανίζεται σιωπηλά: τα totalMatched και notes λένε τι έμεινε εκτός. Πρόσθεσε format=anthropic για να πάρεις { name, description, input_schema }.

Η κλήση είναι δωρεάν και δεν ξοδεύει credits.

Το δικό σου κλειδί για το μοντέλο

Στα endpoints όπου παράγουμε κείμενο, μπορείς να πληρώνεις ο ίδιος για τα tokens. Δύο κεφαλίδες, είτε και οι δύο είτε καμία:

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 είναι ένα από τα openai, anthropic, google, groq, mistral, openrouter, deepseek, together. Η διεύθυνση για το καθένα είναι σταθερή από τη μεριά μας και δεν λαμβάνεται ποτέ από το αίτημα. Το X-Provider-Model είναι προαιρετικό και αντικαθιστά το προεπιλεγμένο μοντέλο.

Δεν υπάρχει εναλλακτική επιστροφή στη δική μας αλυσίδα. Αν το κλειδί σου δεν λειτούργησε, θα πάρεις το status και το μήνυμα του provider, όχι μια απάντηση που πληρώσαμε εμείς: μια σιωπηλή εναλλακτική θα ξόδευε τα δικά μας tokens σε ένα αίτημα που θεωρούσες δικό σου, και θα ήταν αδύνατο να το προσέξεις.

Μια τέτοια κλήση κοστίζει 5 credits αντί για την τιμή του endpoint. Εμείς εξακολουθούμε να υπολογίζουμε τον χάρτη, να συνθέτουμε το prompt και να περνάμε τις δικλίδες ασφαλείας. Το completion το αγόρασες εσύ.

Το κλειδί σου δεν καταγράφεται πουθενά, δεν αποθηκεύεται και δεν μπαίνει σε cache. Πηγαίνει ως κεφαλίδα, γιατί το body του αιτήματος γίνεται hash σε δύο κλειδιά cache, και το αρχείο καταγραφής αιτημάτων μας δεν γράφει καθόλου κεφαλίδες. Ένα σφάλμα του provider που παρέθεσε το κλειδί σου λογοκρίνεται πριν φτάσει στα logs μας ή στην απάντησή σου. Μια κλήση με το κλειδί σου παρακάμπτει και τις δύο cache προς τις δύο κατευθύνσεις: δεν θα πάρει ποτέ απάντηση που φτιάξαμε εμείς, και η απάντησή της δεν θα φτάσει ποτέ σε κάποιον άλλο.

Οι κεφαλίδες υπάρχουν στην προδιαγραφή. Κάθε διαδρομή που τις δέχεται δηλώνει τα X-Provider, X-Provider-Key και X-Provider-Model στο /v1/openapi.json, οπότε ένας παραγόμενος client θα τα συνδέσει όπως κάθε άλλη παράμετρο και δεν θα χρειαστεί αυτή τη σελίδα. Δηλώνονται μόνο εκεί όπου πράγματι καλούμε μοντέλο: μπορείς να τις στείλεις στο /chart, αλλά δεν θα γίνει τίποτα και θα πληρώσεις την κανονική τιμή του endpoint.

Προδιαγραφές αναγνώσιμες από μηχανές

Θέλεις να συνδέσεις απευθείας το REST API ή να δώσεις την προδιαγραφή στον δικό σου agent;

AGENTS.md: /AGENTS.md, οδηγίες για τον agent (τι μπορεί να κληθεί χωρίς κλειδί, συμβόλαιο αιτήματος, φάκελος απάντησης, κεφαλίδες ορίων)
OpenAPI: /v1/openapi.json
llms.txt: /llms.txt · πλήρες κείμενο /llms-full.txt
Postman: /postman/astroway-api.json
SDK: TypeScript, Python, PHP