# Moonlora MCP Server 🌙

Remote [MCP](https://modelcontextprotocol.io) server for moon data — phases, illumination, moon signs, full/new moon dates (1900–2100) and moonrise/moonset for any coordinates. Computed with the Meeus algorithm, not scraped. Hosted, stateless, no install, no API key.

```
https://moonlora.com/api/mcp
```

## Add to your assistant

**Claude Desktop / Claude Code / Cursor:**

```json
{
  "mcpServers": {
    "moonlora": { "url": "https://moonlora.com/api/mcp" }
  }
}
```

## Tools

| Tool | What it does |
|---|---|
| `get_moon_phase` | Phase, illumination, moon sign, next full/new moon for any date. Optional `latitude`/`longitude` adds moonrise/moonset (UTC). |
| `list_full_moons` | Every full moon of a year with exact UTC times, traditional names and moon signs. |
| `list_new_moons` | Every new moon of a year with exact UTC times and moon signs. |

## Example

```bash
curl -X POST https://moonlora.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_moon_phase","arguments":{"date":"2026-08-28"}}}'
```

There's also a plain JSON REST API and an embeddable widget — see [moonlora.com/developers](https://moonlora.com/developers) ([OpenAPI 3.1](https://moonlora.com/api/openapi.json)).

## Accuracy & license

Meeus phase algorithm (±5 min), moonrise/set ±2 min. Free for any use — attribution required: a visible link to [moonlora.com](https://moonlora.com). Please don't land a spacecraft with it.