Moon Phase Software MCP server
Commit Nov 12, 2026Provides lunar data including moon phases, moonrise/moonset times, eclipses, zodiac signs, and distances for any location worldwide.
Also known as pyxlino/moonphasesoftware-mcp, moonphasesoftware-com
- Stars
- 0
- Tools
- 7
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Nov 12, 2026
- License
- —
What is Moon Phase Software MCP?
Moon Phase Software provides lunar data including moon phases, moonrise/moonset times, eclipses, zodiac signs, and distances for any location worldwide. It exposes 7 tools, such as get_moon_phase, get_moonrise_moonset, find_full_moons.
Summary generated from the project's README
About Moon Phase Software MCP server
Accessing lunar data and astronomical cycles from inside AI clients like Claude or ChatGPT is what this server enables. It provides detailed information about moon phases, moonrise and moonset times, eclipses, zodiac signs, and distances for any location on Earth. Users can query specific dates, cities, or coordinates to receive precise calculations including lunar age, percent lit, and traditional names for full moons.
This remote server uses streamable HTTP transport and requires no authentication, meaning you do not need an account, sign-in, or an API key to use it. Developers can connect it by adding the provided endpoint to their custom connector settings. The toolset is entirely read-only and includes specialized functions like get_moon_phase, find_full_moons, list_eclipses, and get_moon_sign to retrieve data ranging from supermoon status to specific zodiac degrees.
What you can do with it
- 1Identify lunar phases for specific datesAsk the AI to determine the moon's phase and illumination percentage for a specific day in a particular city.
- 2Track upcoming full moons and their namesRequest a list of all full moons in a calendar year including their traditional names and distance from Earth.
- 3Plan for solar and lunar eclipsesFind out which eclipses are occurring within a specific year and where they will be most visible.
- 4Determine zodiac positionsCheck which zodiac sign the moon occupies at a specific time and location.
Written from the project's README. Every use case is checked against a quote from it.
How to install Moon Phase Software MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Moon Phase Software MCP in Claude Code
$ claude mcp add --transport http moonphasesoftware-com https://moonphasesoftware.com/api/mcpInstall Moon Phase Software MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"moonphasesoftware-com": {
"url": "https://moonphasesoftware.com/api/mcp"
}
}
}Install Moon Phase Software MCP in VS Code
.vscode/mcp.json
{
"servers": {
"moonphasesoftware-com": {
"type": "http",
"url": "https://moonphasesoftware.com/api/mcp"
}
}
}Install Moon Phase Software MCP in VS Code CLI
$ code --add-mcp '{"name":"moonphasesoftware-com","type":"http","url":"https://moonphasesoftware.com/api/mcp"}'Install Moon Phase Software MCP in Codex
$ codex mcp add moonphasesoftware-com --url https://moonphasesoftware.com/api/mcpInstall Moon Phase Software MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.moonphasesoftware-com] url = "https://moonphasesoftware.com/api/mcp"
Install Moon Phase Software MCP in Gemini CLI
$ gemini mcp add -s user --transport http moonphasesoftware-com https://moonphasesoftware.com/api/mcpInstall Moon Phase Software MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"moonphasesoftware-com": {
"url": "https://moonphasesoftware.com/api/mcp",
"type": "http"
}
}
}Moon Phase Software MCP tools 7
Detected from the READMEget_moon_phaseget_moonrise_moonsetfind_full_moonsget_moon_calendarlist_eclipsesget_moon_signget_moon_distance
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablepyxlino/moonphasesoftware-mcp is public and reachablegithub.com/pyxlino/moonphasesoftware-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-12github.com/pyxlino/moonphasesoftware-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 434 msPass
README
View on GitHubMoon Phase Software MCP app
See the Moon wherever you are.
Ask what the Moon looks like tonight or on any date, when the next full Moon is and what it is called, when the Moon rises where you are, which eclipses happen this year, or what sign the Moon is in. The app answers with the same calculations as moonphasesoftware.com, in your city or time zone, with a picture of the Moon.
- Website: https://moonphasesoftware.com
- Documentation: https://moonphasesoftware.com/app
- Privacy: https://moonphasesoftware.com/privacy
- Terms: https://moonphasesoftware.com/terms
This repository documents the hosted connector. It does not contain the website or its code.
Connect
- Endpoint:
https://moonphasesoftware.com/api/mcp - Transport: Streamable HTTP
- Authentication: none (no account, sign-in or API key)
{ "mcpServers": { "moon-phase-software": { "url": "https://moonphasesoftware.com/api/mcp" } } }
In ChatGPT, add it as a custom MCP server with no authentication. In Claude, open Customize, then Connectors, choose Add custom connector and enter the URL.
Tools
All tools are read-only.
| Tool | What it does |
|---|---|
get_moon_phase |
Returns the Moon's phase, percent lit, lunar age and waxing or waning direction right now, at 12:00 on a date, or at a clock time on a date, in a time zone or city. |
get_moonrise_moonset |
Returns moonrise, moonset and the Moon's highest point on a local date for a city from the website's list of world cities, or for any latitude and longitude, with compass directions and the Moon's phase that day. |
find_full_moons |
Returns every full Moon of a calendar year with its date and time in a time zone, its traditional name such as Wolf Moon or Harvest Moon, its distance from Earth and whether it is a supermoon or a Blue Moon. |
get_moon_calendar |
Returns every day of a month with the Moon's phase and percent lit at 12:00 local time, and the exact times of that month's new Moon, first quarter, full Moon and last quarter in a time zone. |
list_eclipses |
Returns the lunar and solar eclipses of a calendar year with their type, the time of greatest eclipse in a time zone, the contact times of lunar eclipses, where solar eclipses are greatest and which of 16 major world cities see each one. |
get_moon_sign |
Returns the zodiac sign the Moon is in at a date and local time, in a time zone or city, with its degree in the sign and the next sign change. |
get_moon_distance |
Returns the Moon's distance from Earth in kilometres and miles at a date and time, its apparent width, the previous and next perigee and apogee, and the next full Moon's distance with whether that full Moon is a supermoon. |
Try asking
- "What phase is the Moon on 25 December 2026 in Tokyo?"
- "When does the Moon rise and set in Chicago on 14 November 2026?"
- "List every full Moon of 2027 with its name."
Report an issue
Open an issue in this repository or email support@moonphasesoftware.com.
License
The documentation files in this repository are MIT licensed (see LICENSE). The Moon Phase Software website, its content, data and brand are not covered by this license.
Moon Phase Software MCP questions
How do I add Moon Phase Software MCP to Claude Code?
Run claude mcp add --transport http moonphasesoftware-com https://moonphasesoftware.com/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Moon Phase Software MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Moon Phase Software MCP provide?
It exposes 7 tools, including get_moon_phase, get_moonrise_moonset, find_full_moons, get_moon_calendar, list_eclipses.
What kind of lunar information can I retrieve?
You can get the moon's phase, moonrise and moonset times, full moon names, eclipse schedules, zodiac signs, and the moon's distance from Earth.
Do I need an API key to use this server?
No, the server requires no account, sign-in, or API key.
Can I get moon phase information for a specific city?
Yes, you can request moon phases, moonrise/moonset times, and moon signs for specific cities or time zones.