Crystals by Planet
asterwise_get_crystal_by_planet
Returns all crystals associated with a specific Vedic planet. Results are sorted with primary Navaratna gems first, then Uparatna substitutes. Only Navaratna and Uparatna Vedic assignments are returned — crystals with no Vedic planetary correspondence are excluded.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
planet | string | yes | Planet to find crystals for, e.g. 'Venus' or 'Saturn'. |
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
What it covers
Filters the crystal database by vedic_planet field. Only returns crystals where vedic_correspondence is 'navaratna' or 'uparatna' — none_classical crystals are not returned here because they have no actual Vedic planetary assignment. Useful for Jyotish practitioners recommending remedial gems. Navaratna gems appear first. Valid planets: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu.
Workflow
BEFORE: RECOMMENDED — asterwise_get_natal_chart — identify the planet needing remediation.
AFTER: asterwise_get_gemstone_recommendations — for chart-specific gem safety assessment.
Input
planet: One of Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu.
Output contract
data.total (int)
data.crystals[] — same shape as asterwise_get_crystals, sorted Navaratna first.
Response format
response_format=json — filtered crystal array. response_format=markdown — formatted list. Both return identical data.
Compute class
FAST_LOOKUP
Errors
INVALID_PARAMS (upstream): Unknown planet → 404.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_gemstone_recommendations — natal chart house-lordship gem recommendation with contraindications; use for actual gem prescription, not just listing.
asterwise_get_crystals — all 50 crystals including Western-only ones.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.