Western Moon Calendar
asterwise_get_western_moon_calendar
Returns lunar phase data for every day in a calendar month as a structured array. Each element is a complete daily phase object identical to asterwise_get_western_moon_phase.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
response_format | enum: markdown, json | no | Output format: 'markdown' (default) for a readable report, or 'json' for the raw structured payload. |
year | integer/null | no | Four-digit year, 1-3000. Defaults to the current year (UTC). |
month | integer/null | no | Month number 1-12. Defaults to the current month (UTC). |
What it covers
Month-at-a-glance lunar calendar for any year/month combination. Useful for building moon phase widgets, marking full/new moon dates with principal_phase (the day containing the exact instant), not phase_name, planning tools based on lunar cycles, and content calendars. Defaults to the current month.
Workflow
BEFORE: None — standalone.
AFTER: None.
Input
year (optional int, 1-3000) — Target year. Defaults to the current year (UTC). Example: 2026
month (optional int 1–12) — Target month. Defaults to the current month (UTC).
Example: 5 (May)
Values outside 1–12 are rejected locally with MCP INVALID_PARAMS.
Output contract
data[] — array of daily phase objects, one per calendar day in the month.
Each object is identical to asterwise_get_western_moon_phase output.
Response format
response_format=json — array of daily phase objects.
response_format=markdown — month view with day-by-day phases.
Compute class
MEDIUM_COMPUTE (~500ms for 30 days)
Errors
INVALID_PARAMS (local):
— month outside 1–12 → MCP INVALID_PARAMS immediately.
INVALID_PARAMS (upstream): year outside 1-3000 → 422 validation_error, surfaces as MCP INTERNAL_ERROR with the API message.
INTERNAL_ERROR: Any upstream API failure → MCP INTERNAL_ERROR
Do not confuse with
asterwise_get_western_moon_phase — single-day phase only.
Connect
Remote MCP endpoint: https://mcp.asterwise.com/mcp. Authenticate with Authorization: Bearer <API key> or OAuth. See the MCP setup guide.