Penyiapan agen

Hubungkan API AstroWay ke agen AI melalui MCP (Model Context Protocol). Katalog tersedia dengan dua cara, keduanya memakai kunci aw_test_* / aw_live_* milikmu:

• Hosted (HTTP): https://mcp.astroway.info/mcp, tanpa instalasi, autentikasi melalui token Bearer.
• Stdio (npx): npx @astroway/mcp, subproses lokal, autentikasi melalui variabel env, berjalan offline.

Dapatkan kunci gratis di dasbor, lalu pilih klienmu.

Satu domain, bukan seluruh katalog

783 tool dalam satu respons berarti 2.9 MB yang wajib dibaca agen sebelum memilih satu saja. Sebagian besar klien menyerah jauh sebelum itu.

https://mcp.astroway.info/mcp/<domain> mengembalikan satu bidang, bukan semuanya. Konfigurasinya sama, hanya URL yang berubah.

Domain	URL	Tool	Ukuran tools/list
Inti astrologi	/mcp/core	104	389 KB
Weda	/mcp/vedic	192	970 KB
Metafisika Tiongkok	/mcp/chinese	60	202 KB
Helenistik dan tradisional	/mcp/hellenistic	59	240 KB
Tarot	/mcp/tarot	79	209 KB
Numerologi	/mcp/numerology	64	158 KB
Human Design	/mcp/human-design	27	125 KB
Prognostik	/mcp/forecast	43	209 KB
Hubungan	/mcp/relationships	42	247 KB
Psikologis	/mcp/psychological	28	107 KB
Ramalan dan esoterika	/mcp/divination	79	185 KB
Pembacaan terapan	/mcp/applied	45	148 KB
Laporan	/mcp/reports	42	209 KB
Platform	/mcp/platform	42	119 KB

Diukur di produksi pada 2026-09-21. /mcp tetap mengembalikan seluruh katalog, jadi tidak ada konfigurasi lama yang rusak. Pemeriksaan saldo dan estimasi biaya panggilan tersedia di setiap domain, karena agen yang dibatasi pada astrologi Weda pun tetap perlu tahu berapa biaya sebuah panggilan.

GET /domains mengembalikan daftar yang sama sebagai JSON, tanpa kunci. Domain yang tidak dikenal menghasilkan 404 beserta daftar domain yang benar, bukan diam-diam mengembalikan semua 783 tool.

Dokumentasi tanpa kunci: /mcp/docs

Pertanyaan pertama agen tidak pernah “hitung bagan”. Pertanyaannya adalah “apa yang bisa dilakukan API ini, seperti apa panggilannya, dan berapa biayanya untukku”. Ketiganya bisa dijawab tanpa kunci: https://mcp.astroway.info/mcp/docs tidak memakai kredit sama sekali, jadi juga tidak meminta otorisasi.

Tool	Fungsinya
find_endpoint	Mencari di antara semua 770 operasi. Untuk masing-masing mengembalikan metode, URL, harga dalam kredit, paket, field body yang wajib, dan tautan ke referensi
search_docs	Mencari di 281 halaman panduan, dalam bahasa Ukraina dan Inggris, beserta daftar bagian tiap halaman
read_doc	Mengembalikan satu halaman sebagai markdown
list_docs	Seluruh indeks, dikelompokkan per bagian

700 dari 770 operasi memiliki harga, 37 lainnya ditandai sebagai operasi yang merespons tanpa kunci. Artinya, biaya sebuah skenario bisa dihitung sebelum akun dibuat.

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 hanya membaca halaman yang ada di indeks. Path lain apa pun ditolak, dan tidak ada permintaan keluar yang dikirim.

Minta lebih sedikit dari seluruh respons

Setiap tool menerima dua parameter di luar parameternya sendiri: fields (daftar path dipisahkan koma, relatif terhadap data) dan precision (berapa digit di belakang koma yang dipertahankan). Keduanya diteruskan ke API yang sama seperti lewat REST, dan selisih token-nya bukan retorika.

Panggilan bagan natal lewat MCP	Byte
tanpa parameter, seperti sebelum 21.09.2026	91 737
tanpa parameter, hari ini	72 484
precision: 2	61 356
fields: "planets.name,planets.longitude,houses.cusp" ditambah precision: 2	1 182

Diukur di produksi pada 2026-09-21. Kreditnya sama di keempat baris: selisihnya dibayar oleh pihak yang membaca respons.

Path yang tidak cocok dengan field mana pun dikembalikan di _fields_unmatched. Daftar yang sama sekali tidak cocok menghasilkan 400 FIELDS_UNKNOWN beserta daftarnya, bukan respons kosong. Deskripsi lengkap kedua parameter: konvensi API.

Pilih klienmu

Claude Desktop Hosted MCP melalui konfigurasi

Claude Code Satu perintah CLI

Cursor Hosted MCP melalui konfigurasi

VS Code Copilot Chat, Agent mode

Windsurf Cascade MCP

Cline Paket npx stdio

Codex CLI Paket npx stdio

CI / raw HTTP

Sama sekali tanpa klien - endpoint hosted berbicara JSON-RPC di atas HTTP. Daftar tool dengan token 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 tanpa MCP

Jika agenmu berbicara dalam function calling dari OpenAI atau Anthropic, bukan MCP, minta definisi tool siap pakai dari API dan berikan langsung ke model. Definisi ini dihasilkan dari dokumen OpenAPI, jadi skema yang diisi model adalah skema yang sama dengan yang divalidasi endpoint.

terminal

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

Respons terdiri dari dua bagian. tools persis mengikuti kontrak vendor dan tidak membawa apa pun milik kami, jadi bisa dimasukkan ke panggilan model apa adanya: kunci tambahan di dalam objek tool berarti 400 di sisi mereka. executors menjelaskan cara menjalankan setiap tool dan memakai kunci yang sama dengan yang akan dikembalikan model:

respons, disingkat

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

Setelah itu executor-mu cukup lima baris: cari nama di executors, kirim argumen model sebagai body JSON ke path tersebut dengan X-Api-Key milikmu, kembalikan respons ke model. Tidak ada tool yang memuat kredensial, jadi daftar ini aman untuk di-cache.

Kamu yang memilih apa yang dilihat model. Secara default ini adalah set awal terkurasi berisi 26 tool, bukan seluruh katalog: OpenAI membatasi satu permintaan pada 128 fungsi, dan model mulai memilih lebih buruk jauh sebelum batas itu. Persempit atau perluas dengan select=all, select=group:Vedic, select=paths:/chart,/synastry, saring di dalamnya dengan q=, batasi dengan limit= (maksimum 128). Tidak ada yang hilang diam-diam: totalMatched dan notes memberi tahu apa yang tertinggal di luar. Tambahkan format=anthropic untuk mendapatkan { name, description, input_schema }.

Panggilan ini gratis dan tidak memakai kredit.

Kunci model milikmu sendiri

Pada endpoint tempat kami menghasilkan teks, kamu bisa membayar token sendiri. Dua header, keduanya atau tidak sama sekali:

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 adalah salah satu dari openai, anthropic, google, groq, mistral, openrouter, deepseek, together; alamat untuk masing-masing ditetapkan di sisi kami dan tidak pernah diambil dari permintaan. X-Provider-Model bersifat opsional dan menggantikan model default.

Tidak ada fallback ke rantai kami. Jika kuncimu gagal, kamu menerima status dan pesan dari provider, bukan respons yang kami bayar: fallback diam-diam akan menghabiskan token kami untuk permintaan yang kamu anggap milikmu, dan hal itu mustahil disadari.

Panggilan seperti ini berbiaya 5 kredit, bukan harga endpoint. Kami tetap menghitung bagan, menyusun prompt, dan menjalankan pengaman; completion-nya kamu yang beli.

Kuncimu tidak pernah dicatat di log, disimpan, atau di-cache. Kunci dikirim lewat header, karena body permintaan di-hash menjadi dua kunci cache, sedangkan log permintaan kami sama sekali tidak mencatat header. Error provider yang mengutip kuncimu disunting sebelum masuk ke log kami atau ke responsmu. Panggilan dengan kuncimu melewati kedua cache ke dua arah: panggilan itu tidak pernah menerima respons yang kami buat, dan responsnya tidak pernah sampai ke orang lain.

Header-nya ada di spesifikasi. Setiap path yang menerimanya mendeklarasikan X-Provider, X-Provider-Key, dan X-Provider-Model di /v1/openapi.json, jadi klien yang di-generate akan memasangnya seperti parameter lain, tanpa perlu halaman ini. Header ini hanya dideklarasikan di tempat kami benar-benar memanggil model: kamu boleh mengirimnya ke /chart, tetapi tidak akan terjadi apa-apa, dan kamu membayar harga endpoint yang biasa.

Spesifikasi yang dapat dibaca mesin

Ingin menghubungkan REST API secara langsung atau memberikan spesifikasinya ke agenmu sendiri?

• AGENTS.md: /AGENTS.md, instruksi untuk agen (apa yang bisa dipanggil tanpa kunci, kontrak permintaan, envelope respons, header batas)
• OpenAPI: /v1/openapi.json
• llms.txt: /llms.txt · teks lengkap /llms-full.txt
• Postman: /postman/astroway-api.json
• SDK: TypeScript, Python, PHP