Ajan kurulumu

AstroWay API’yi AI ajanlarına MCP (Model Context Protocol) üzerinden bağlayın. Katalog iki yolla kullanılabilir, ikisi de aw_test_* / aw_live_* anahtarlarınızla çalışır:

Hosted (HTTP): https://mcp.astroway.info/mcp, kurulum gerektirmez, kimlik doğrulama Bearer token ile yapılır.
Stdio (npx): npx @astroway/mcp, yerel bir alt süreçtir, kimlik doğrulama bir ortam değişkeniyle yapılır, çevrim dışı çalışır.

Panelden ücretsiz bir anahtar alın, ardından istemcinizi seçin.

Tüm katalog yerine tek bir alan

Tek bir yanıttaki 783 araç 2.9 MB eder ve ajan birini seçmeden önce bunların hepsini okumak zorundadır. Çoğu istemci bu noktaya gelmeden çok önce pes eder.

https://mcp.astroway.info/mcp/<alan> her şey yerine tek bir konu döndürür. Yapılandırma aynıdır, yalnızca URL değişir.

Alan	URL	Araç sayısı	`tools/list` boyutu
Astroloji çekirdeği	`/mcp/core`	104	389 KB
Vedik	`/mcp/vedic`	192	970 KB
Çin metafiziği	`/mcp/chinese`	60	202 KB
Helenistik ve gelenek	`/mcp/hellenistic`	59	240 KB
Tarot	`/mcp/tarot`	79	209 KB
Numeroloji	`/mcp/numerology`	64	158 KB
Human Design	`/mcp/human-design`	27	125 KB
Öngörü	`/mcp/forecast`	43	209 KB
İlişkiler	`/mcp/relationships`	42	247 KB
Psikolojik	`/mcp/psychological`	28	107 KB
Kehanet ve ezoterizm	`/mcp/divination`	79	185 KB
Uygulamalı okumalar	`/mcp/applied`	45	148 KB
Raporlar	`/mcp/reports`	42	209 KB
Platform	`/mcp/platform`	42	119 KB

Üretim ortamında 2026-09-21 tarihinde ölçülmüştür. /mcp tüm kataloğu döndürmeye devam eder, yani daha önce yapılandırılmış hiçbir şey bozulmadı. Bakiye kontrolü ve çağrı maliyeti tahmini her alanda bulunur, çünkü Vedik astrolojiyle sınırlanmış bir ajanın da bir çağrının ne kadara mal olduğunu bilmesi gerekir.

GET /domains aynı listeyi anahtar gerektirmeden JSON olarak döndürür. Bilinmeyen bir alan, sessizce 783 aracın tamamını döndürmek yerine gerçek alanların listesiyle birlikte 404 verir.

Anahtarsız dokümantasyon: `/mcp/docs`

Bir ajanın ilk sorusu hiçbir zaman “haritayı hesapla” olmaz. Soru şöyledir: “bu API ne yapabiliyor, bir çağrı nasıl görünüyor ve bana kaça mal olacak”. Üçü de anahtarsız yanıtlanabilir: https://mcp.astroway.info/mcp/docs tek bir kredi harcamaz, bu yüzden yetkilendirme de istemez.

Araç	Ne yapar
`find_endpoint`	770 işlemin tamamında arama yapar. Her biri için metodu, URL’yi, kredi cinsinden fiyatı, planı, gövdenin zorunlu alanlarını ve başvuru sayfasının bağlantısını döndürür
`search_docs`	Ukraynaca ve İngilizce 281 kılavuz sayfasında, her sayfanın bölüm listesiyle birlikte arama yapar
`read_doc`	Tek bir sayfayı markdown olarak döndürür
`list_docs`	Bölümlere göre gruplanmış dizinin tamamı

770 işlemden 700’ünün fiyatı vardır, 37 tanesi daha anahtarsız yanıt veren işlemler olarak işaretlenmiştir. Yani bir senaryonun maliyeti, henüz bir hesap açılmadan hesaplanabilir.

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 yalnızca dizinde bulunan sayfaları okur. Başka herhangi bir yol reddedilir ve bu sırada dışarıya hiçbir istek gitmez.

Yanıtın tamamından azını isteyin

Her araç kendi parametrelerinin üzerine iki parametre daha kabul eder: fields (data’ya göre, virgülle ayrılmış yol listesi) ve precision (virgülden sonra kaç basamak kalacağı). Bunlar REST üzerinden gidenlerle aynı API’ye gider ve token farkı laf olsun diye söylenmiş değildir.

MCP üzerinden doğum haritası çağrısı	Bayt
parametresiz, 21.09.2026 öncesindeki gibi	91 737
parametresiz, bugün	72 484
`precision: 2`	61 356
`fields: "planets.name,planets.longitude,houses.cusp"` artı `precision: 2`	1 182

Üretim ortamında 2026-09-21 tarihinde ölçülmüştür. Krediler dört satırın hepsinde aynıdır: farkın bedelini yanıtı okuyan öder.

Hiçbir alanla eşleşmeyen bir yol _fields_unmatched içinde geri döner. Hiçbir şeyin eşleşmediği bir liste boş bir yanıt değil, listeyle birlikte 400 FIELDS_UNKNOWN verir. İki parametrenin tam açıklaması: API kuralları.

İstemcinizi seçin

Claude Desktop Yapılandırma ile hosted MCP

Claude Code Tek bir CLI komutu

Cursor Yapılandırma ile hosted MCP

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline npx stdio paketi

Codex CLI npx stdio paketi

CI / raw HTTP

Hiç istemci olmadan da olur: hosted endpoint HTTP üzerinden JSON-RPC konuşur. Bearer token ile araç listesi:

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

MCP olmadan function calling

Ajanınız MCP yerine OpenAI veya Anthropic’in function calling dilini konuşuyorsa, API’den hazır araç tanımlarını isteyin ve bunları doğrudan modele verin. Tanımlar OpenAPI belgesinden üretilir, yani modelin doldurduğu şema, endpoint’in doğruladığı şemanın ta kendisidir.

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

Yanıtın iki yarısı vardır. tools sağlayıcının sözleşmesine birebir uyar ve bize ait hiçbir şey taşımaz, bu yüzden model çağrısına olduğu gibi konabilir: araç nesnesinin içindeki fazladan bir anahtar onların tarafında 400 demektir. executors her aracın nasıl çalıştırılacağını söyler ve modelin döndüreceği anahtarların aynısını taşır:

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

Bundan sonra yürütücünüz beş satırdan ibarettir: adı executors içinde bulun, modelin argümanlarını kendi X-Api-Key’inizle bu yola JSON gövdesi olarak gönderin, yanıtı modele geri verin. Hiçbir araç kimlik bilgisi içermez, bu yüzden bu listeyi önbelleğe almak güvenlidir.

Modelin ne göreceğini siz seçersiniz. Varsayılan olarak bu, kataloğun tamamı değil, 26 araçlık seçilmiş bir başlangıç setidir: OpenAI bir isteği 128 fonksiyonla sınırlar ve modeller bu sınırdan çok önce daha kötü seçim yapmaya başlar. select=all, select=group:Vedic, select=paths:/chart,/synastry ile daraltın ya da genişletin, içeride q= ile filtreleyin, limit= ile sınırlayın (en fazla 128). Hiçbir şey sessizce kaybolmaz: totalMatched ve notes neyin dışarıda kaldığını söyler. { name, description, input_schema } almak için format=anthropic ekleyin.

Bu çağrı ücretsizdir ve kredi harcamaz.

Modele kendi anahtarınız

Metin ürettiğimiz endpoint’lerde token bedelini kendiniz ödeyebilirsiniz. İki başlık: ya ikisi birden ya da hiçbiri:

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 şunlardan biridir: openai, anthropic, google, groq, mistral, openrouter, deepseek, together; her birinin adresi bizim tarafımızda sabittir ve asla istekten alınmaz. X-Provider-Model isteğe bağlıdır ve varsayılan modeli geçersiz kılar.

Bizim zincirimize geri dönüş yoktur. Anahtarınız çalışmazsa, bedelini bizim ödediğimiz bir yanıt değil, sağlayıcının durum kodunu ve mesajını alırsınız: sessiz bir geri dönüş, sizin kendinize ait saydığınız bir istek için bizim token’larımızı harcardı ve bunu fark etmek imkânsız olurdu.

Böyle bir çağrı endpoint’in fiyatı yerine 5 kredi tutar. Haritayı yine biz hesaplarız, prompt’u yine biz oluştururuz ve güvenlik önlemlerini yine biz çalıştırırız; tamamlamayı siz satın aldınız.

Anahtarınız hiçbir yerde loglanmaz, saklanmaz ve önbelleğe alınmaz. Başlık olarak gider, çünkü istek gövdesi iki önbellek anahtarına hash’lenir ve istek günlüğümüz başlıkları hiç yazmaz. Anahtarınızı alıntılayan bir sağlayıcı hatası, loglarımıza veya yanıtınıza ulaşmadan önce temizlenir. Kendi anahtarınızla yapılan bir çağrı her iki önbelleği her iki yönde de atlar: bizim ürettiğimiz bir yanıtı asla almaz ve onun yanıtı asla başka birine ulaşmaz.

Başlıklar spesifikasyonda yer alır. Bunları kabul eden her yol, /v1/openapi.json içinde X-Provider, X-Provider-Key ve X-Provider-Model’i bildirir, böylece üretilmiş bir istemci bunları diğer parametreler gibi bağlar ve bu sayfaya ihtiyaç duymaz. Yalnızca modeli gerçekten çağırdığımız yerlerde bildirilmişlerdir: bunları /chart’a gönderebilirsiniz, ama hiçbir şey olmaz ve endpoint’in normal fiyatını ödersiniz.

Makine tarafından okunabilir spesifikasyonlar

REST API’yi doğrudan bağlamak ya da spesifikasyonu kendi ajanınıza vermek mi istiyorsunuz?

AGENTS.md: /AGENTS.md, ajan için talimatlar (anahtarsız neler çağrılabilir, istek sözleşmesi, yanıt zarfı, limit başlıkları)
OpenAPI: /v1/openapi.json
llms.txt: /llms.txt · tam metin /llms-full.txt
Postman: /postman/astroway-api.json
SDK: TypeScript, Python, PHP