Skip to main content

Planet Nature

asterwise_get_planet_nature

Returns classical graha (planet) properties for all nine planets or a single planet per classical Vedic tradition.

Parameters

ParameterTypeRequiredDescription
response_formatenum: markdown, jsonno
planetstring/nullno

What it covers

Returns tattva (element), guna (Sattvic/Rajasic/Tamasic), gender, caste/varna, natural benefic/malefic nature, direction, color, presiding deity, ruling day of week, metal, body part governed, and naisargika maitri (natural friends, enemies, neutrals) for each of the nine grahas: Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Rahu and Ketu include note explaining reference-table limits for shadow nodes.

Workflow

BEFORE: None — standalone reference.
AFTER: asterwise_get_puja_suggestions — propitiation for a specific graha.

Input

planet (optional): One of Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn, Rahu, Ketu. Omit to get all nine planets.

Output contract

Single planet: data.planet, data.tattva, data.guna, data.gender, data.caste, data.nature, data.direction, data.color, data.deity, data.day, data.metal, data.body_part, data.friends[], data.enemies[], data.neutrals[]
All planets: data.planets{} — object keyed by planet name, each with above fields

Compute class

FAST_LOOKUP

Errors

INVALID_PARAMS (upstream): Unknown planet name → MCP INTERNAL_ERROR
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR

Do not confuse with

asterwise_get_puja_suggestions — ritual propitiation per planet, not properties.
asterwise_get_rudraksha — bead recommendations per planet, not natal properties.

Connect

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