{
  "openapi": "3.1.0",
  "info": {
    "title": "Moonlora Moon API",
    "version": "1.0.0",
    "description": "Free moon phase data (Meeus algorithm, 1900-2100). Attribution required: link to https://moonlora.com. MCP server for AI assistants: https://moonlora.com/api/mcp",
    "contact": { "url": "https://moonlora.com/developers" }
  },
  "servers": [{ "url": "https://moonlora.com/api/v1" }],
  "paths": {
    "/phase": {
      "get": {
        "operationId": "getMoonPhase",
        "summary": "Moon phase for any date, optionally with moonrise/moonset for coordinates",
        "parameters": [
          { "name": "date", "in": "query", "required": false, "schema": { "type": "string" }, "description": "YYYY-MM-DD or ISO 8601. Omit for now." },
          { "name": "lat", "in": "query", "required": false, "schema": { "type": "number", "minimum": -90, "maximum": 90 } },
          { "name": "lon", "in": "query", "required": false, "schema": { "type": "number", "minimum": -180, "maximum": 180 } }
        ],
        "responses": {
          "200": {
            "description": "Moon data",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "date": { "type": "string", "format": "date-time" },
                    "phase": { "type": "string", "enum": ["new-moon", "waxing-crescent", "first-quarter", "waxing-gibbous", "full-moon", "waning-gibbous", "last-quarter", "waning-crescent"] },
                    "illumination": { "type": "number" },
                    "moonAgeDays": { "type": "number" },
                    "moonSign": { "type": "string" },
                    "nextFullMoon": { "type": "string", "format": "date-time" },
                    "nextNewMoon": { "type": "string", "format": "date-time" },
                    "moonrise": { "type": ["string", "null"], "format": "date-time" },
                    "moonset": { "type": ["string", "null"], "format": "date-time" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/full-moons/{year}": {
      "get": {
        "operationId": "listFullMoons",
        "summary": "Every full moon of a year with UTC times, traditional names and moon signs",
        "parameters": [{ "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1900, "maximum": 2100 } }],
        "responses": { "200": { "description": "Full moons of the year" } }
      }
    },
    "/new-moons/{year}": {
      "get": {
        "operationId": "listNewMoons",
        "summary": "Every new moon of a year with UTC times and moon signs",
        "parameters": [{ "name": "year", "in": "path", "required": true, "schema": { "type": "integer", "minimum": 1900, "maximum": 2100 } }],
        "responses": { "200": { "description": "New moons of the year" } }
      }
    }
  }
}