Skip to main content

Yogas

asterwise_get_yogas

Evaluates the natal chart for named classical yogas and returns category, formation text, classical results, modern summaries, and keywords per hit.

Parameters​

ParameterTypeRequiredDescription
birthobjectyesBirth data for a single person. Fields: date, time, lat, lon*, person_name, timezone, ayanamsa
response_formatenum: markdown, jsonno

What it covers​

Detects an open-ended set of named yogas and emits the data.yogas[] list; categories include raja_yogas, dhana_yogas, pancha_mahapurusha, chandra_yogas, surya_yogas, kartari_yogas, or unknown while metadata is pending. It does not return the Graha Drishti matrix (see asterwise_get_natal_chart data.graha_drishti), Shadbala scores, or divisional charts. New yogas may appear without API versioning.

Workflow​

BEFORE: RECOMMENDED — asterwise_get_natal_chart — same birth tuple should be understood before interpreting yoga names.
AFTER: asterwise_get_doshas — complementary affliction scan on the same chart.

Input​

BirthData follows the global contract. time='00:00' is accepted without flag; yoga house logic may be wrong if true birth time is unknown.

Output contract​

data.yogas[] — each object:
yoga_name (string)
category (string — 'raja_yogas', 'dhana_yogas', 'pancha_mahapurusha', 'chandra_yogas', 'surya_yogas', 'kartari_yogas', or 'unknown' while metadata is pending)
formation (string — empty when yoga has no JSON entry yet)
modern_summary (string)
keywords[] (string array)
data.birth_time_provided (bool)

Response format​

response_format=json serialises the complete response as indented JSON — use this for programmatic parsing, typed clients, and downstream tool chaining. response_format=markdown renders the same data as a human-readable report. Both modes return identical underlying data — no fields are added, removed, or filtered by either mode.

Compute class​

MEDIUM_COMPUTE

Errors​

INVALID_PARAMS (local — caught before upstream call):
None — all validation is upstream.

INVALID_PARAMS (upstream):
— Dates before 1800 or after 2100 → MCP INTERNAL_ERROR at the tool layer.

INTERNAL_ERROR:
— Any upstream API failure or timeout → MCP INTERNAL_ERROR

Edge cases:
— Graha Drishti lives only on asterwise_get_natal_chart, not in data.yogas[].

Do not confuse with​

asterwise_get_natal_chart — supplies graha_drishti and base chart rows, not the yoga catalogue.
asterwise_get_panchanga — Panchanga yoga (Sun+Moon sum) is unrelated to these natal yogas.

Connect​

Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.