Chart and reference

Monthly Ephemeris

get_ephemeris

Daily sidereal positions for all 9 planets across a month. Useful for transit planning.

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:

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:

POST /v1/kp/ephemeris/monthly

The engine is a private internal service. All public access flows through the MCP server, which handles auth, rate limiting, and response compaction.