Build Vedic astrology into your product
The same Swiss-Ephemeris engine behind Soul Yatri — kundali, Gun Milan, panchang, numerology, tarot and more — as a clean, metered REST API. API-key auth, transparent credit pricing, and a balance header on every call.
From zero to first call in minutes
Create your key
Sign in and generate an API key in the Developer Console. Every new key starts with 1,000 free credits — no card required.
Call the API
Send your key as a Bearer token to https://mcp.soulyatri.com/v1. Each response returns X-Credits-Remaining so you always know your balance.
Top up with packs
When you need more, buy a credit pack via Razorpay (India) or Stripe (international) — credits land on your key instantly. Packs never expire.
Credit packs
Pay only for what you compute. Every new key gets 1,000 free credits. Paid packs never expire.
Per-call credit cost
Costs scale with compute weight. A Cosmic Blueprint is 500 credits; a horoscope is 2.
| Endpoint | Credits |
|---|---|
| POST /v1/kundali | 20 |
| POST /v1/kundli-matching | 25 |
| GET /v1/panchang | 5 |
| GET /v1/horoscope | 2 |
| POST /v1/numerology | 3 |
| POST /v1/tarot | 3 |
| GET /v1/namakshar | 2 |
| GET /v1/compatibility | 3 |
Quickstart
Authenticate with your key, then call any endpoint. The response includes your remaining balance.
curl -X POST https://mcp.soulyatri.com/v1/kundali \
-H "Authorization: Bearer sk_live_your_key" \
-H "Content-Type: application/json" \
-d '{"dateOfBirth":"1995-08-15","timeOfBirth":"14:30","placeOfBirth":"Mumbai, India"}'401 → invalid key · 402 → out of credits (top up a pack). Full reference at /docs.
Start building today
Create a key, get 1,000 free credits, and make your first call in minutes.
