Chart and reference
Monthly Ephemeris
get_ephemeris
Daily sidereal positions for all 9 KP planets across one month. No birth data required. Returns '{ year, month, days: [{ date, planets: { Sun..Ketu: { siderealLongitude, sign, isRetrograde, dailyMotion } } }] }'. Use for: external transit-planning workflows or generating ephemeris tables.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| year | number | Yes | Year (e.g., 2026) |
| month | number | Yes | Month (1-12) |
Example call
Send the request as a standard MCP tools/call:
http
POST https://mcp.lumin.guru/mcp
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_ephemeris",
"arguments": {
"year": 2026,
"month": 6
}
}
}Engine endpoint
This tool delegates to the kp-engine endpoint:
http
POST /v1/kp/ephemeris/monthlyThe engine is a private internal service. All public access flows through the MCP server, which handles auth, rate limiting, and response compaction.