Each tool call costs the same credits as the equivalent REST endpoint. See Credits & Plans.

---

list_profiles

Returns all birth profiles saved under the API key's account.

Cost: Free

Inputs: (none)

Returns

[
  {
    "id": "683abc123def456",
    "name": "Arjun Sharma",
    "gender": "male",
    "date": "1990-06-15",
    "dateBs": "2047-02-32",
    "time": "06:30",
    "timezone": "Asia/Kathmandu",
    "location": "Kathmandu, Nepal",
    "isDefault": true
  }
]

---

get_birth_chart

Fetches the full birth chart for a profile: planets, houses, ascendant, nakshatra, and basic details.

Cost: 2 credits

Inputs

Name	Type	Required	Description
profileId	string	Yes	ID from list_profiles
locale	string	No	en · hi · ne (default: en)

---

get_basic_details

Returns key astrological details — ascendant, moon sign, sun sign, nakshatra.

Cost: 2 credits

Inputs

Name	Type	Required	Description
profileId	string	Yes	ID from list_profiles

---

get_horoscope

Returns horoscope for all 12 zodiac signs at once. No profile ID required — results are anchored to Kathmandu and shared across users.

Cost: 5 credits

Inputs

Name	Type	Required	Description
period	string	No	daily · weekly · monthly · yearly (default: daily)
calendar	string	No	ad · bs (default: ad)
locale	string	No	en · hi · ne (default: en)

---

get_rashifal

Returns the Rashifal (horoscope) forecast for a profile.

Cost: 2 credits

Inputs

Name	Type	Required	Description
profileId	string	Yes
period	string	No	daily · weekly · monthly · yearly (default: monthly)
calendar	string	No	ad · bs (default: ad)
locale	string	No	en · hi · ne

---

get_dasha

Returns the current Vimshottari dasha sequence with periods and sub-periods.

Cost: 5 credits

Inputs

Name	Type	Required	Description
profileId	string	Yes
locale	string	No	en · hi · ne

---

get_doshas

Checks for active astrological doshas (Mangal, Kaal Sarp, Pitra, etc.).

Cost: 5 credits · Requires: personal plan

Inputs

Name	Type	Required
profileId	string	Yes
locale	string	No

---

get_yogas

Identifies auspicious and inauspicious yoga combinations in the chart.

Cost: 5 credits · Requires: personal plan

Inputs

Name	Type	Required
profileId	string	Yes
locale	string	No

---

get_transits

Returns current planet positions relative to the natal chart.

Cost: 5 credits · Requires: personal plan

Inputs

Name	Type	Required
profileId	string	Yes
locale	string	No

---

get_sade_sati

Checks whether the person is in Sade Sati or Kantak Shani.

Cost: 5 credits · Requires: personal plan

Inputs

Name	Type	Required
profileId	string	Yes
locale	string	No

---

ask_guru

Sends a message to the AI Guru with optional birth chart context. The assistant automatically has access to the profile's full chart when profileId is provided.

Cost: 20 credits

Inputs

Name	Type	Required	Description
message	string	Yes	The user's question
profileId	string	No	Profile for personalized chart context
history	array	No	Prior messages [{ role, content }] for multi-turn
locale	string	No	en · hi · ne

Returns

{
  "message": "With Jupiter in the 7th house from your Moon sign...",
  "role": "assistant"
}

---

Example prompt flow

When a user asks Claude: "What does my Jupiter placement mean for marriage this year?"

Claude will automatically:

1. Call list_profiles to find the user's profile
2. Call get_birth_chart with that profile ID
3. Call ask_guru with the question and profileId for full chart context
4. Return a chart-specific answer