Moon & Star Map MCP
Moon & Star Map provides astronomical data including moon phases, illumination, and star maps for any date and city. It allows users to generate printable vector PDFs and SVGs of night skies, check lunar compatibility between dates, and view moon-phase calendars. The server computes exact moon ages and times using Jean Meeus algorithms.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://sky-keepsake.zovo.one/mcpWhat you can do with it
- Get moon phase, illumination, and age for a specific date
- Generate a star map of the sky above a city at a chosen time
- Check if two moon phases complete each other
- Download printable moon posters as PDF or SVG
Source and maintenance
Protocol and capabilities
- Server
- sky-keepsake 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 3 advertised
- Resources
- 1 advertised
- Resource templates
- 1 advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
},
"resources": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
3 advertised
generate_star_map — Generate star map
Use this when the user wants a star map or night sky poster for a date and place: the sky over a city on a birthday, wedding, anniversary or the night they met, or the sky tonight. Computes the real positions of about 2,900 stars, constellation lines and the Moon for the city's local time (time zones and DST handled) and returns a preview plus vector poster PDFs (12x18 in, 18x24 in, A3, Letter, A4) and SVG. Takes a city name, not coordinates. Does not draw planets and is not for navigation or telescope pointing.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"city",
"date"
],
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "City the sky is seen from, with state or country if ambiguous, e.g. \"Austin, Texas\", \"Paris, France\", \"Kraków\". Not coordinates."
},
"date": {
"type": "string",
"maxLength": 40,
"description": "Local date YYYY-MM-DD, e.g. 2019-06-21, or \"tonight\" for the sky tonight."
},
"time": {
"type": "string",
"maxLength": 16,
"description": "Local clock time HH:MM (24 h) or 9:30 pm, e.g. 22:15. Default 21:00."
},
"theme": {
"enum": [
"midnight",
"black",
"paper",
"ink"
],
"type": "string",
"description": "Colour style: midnight (navy and gold, default), black, paper (cream with a navy sky disc), ink (white, printer-friendly)."
},
"title": {
"type": "string",
"maxLength": 80,
"description": "Poster headline, e.g. \"The night we met\"."
},
"labels": {
"type": "boolean",
"description": "Label the brightest stars and constellations, e.g. false (default, cleaner keepsake look)."
},
"message": {
"type": "string",
"maxLength": 160,
"description": "Short line under the title, e.g. \"Under these stars, forever began\"."
},
"show_moon": {
"type": "boolean",
"description": "Draw the Moon in its real position and phase when it is above the horizon, e.g. true (default)."
},
"constellations": {
"type": "boolean",
"description": "Draw constellation lines, e.g. true (default)."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"place",
"coordinates",
"local_time",
"utc_time",
"time_zone",
"notes",
"stars_drawn",
"brightest_visible",
"constellations_visible",
"moon",
"downloads",
"request"
],
"properties": {
"moon": {},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"place": {
"type": "string"
},
"request": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"utc_time": {
"type": "string"
},
"downloads": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"time_zone": {
"type": "string"
},
"local_time": {
"type": "string"
},
"coordinates": {
"type": "string"
},
"stars_drawn": {
"type": "number"
},
"brightest_visible": {
"type": "array",
"items": {}
},
"constellations_visible": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"title": "Generate star map",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_moon_phase — Find moon phase
Use this when the user asks what the moon looked like on a date (birthday, wedding, first date), the moon phase today or tonight, whether two people's birthday moons complete each other ("our moons make a full moon"), or wants a moon phase calendar for a month. Returns phase name, illumination %, moon age, waxing/waning, exact phase times and the next full and new moon, computed with astronomical algorithms. Does not give astrology readings, tides or moonrise times. Do not use for planets or eclipses.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"description": "City (with state or country if ambiguous) that sets the time zone and hemisphere, e.g. \"Austin, Texas\" or \"Sydney, Australia\". Without it, dates are read in UTC."
},
"dates": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 12,
"description": "Dates to look up as YYYY-MM-DD, optionally with a local time YYYY-MM-DDTHH:MM, e.g. [\"1998-07-14\"] for a birthday or [\"1996-05-02\", \"1997-11-20\"] for a couple. Omit for the Moon right now."
},
"month": {
"type": "string",
"maxLength": 24,
"description": "A month YYYY-MM for a moon-phase calendar of every day plus the exact new, quarter and full moon times, e.g. 2026-01."
},
"labels": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 12,
"description": "Optional names for the dates in the same order, e.g. [\"Anna\", \"Ben\"]."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"place",
"time_zone",
"hemisphere",
"note",
"moons",
"pair",
"calendar"
],
"properties": {
"note": {
"type": "string"
},
"pair": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"moons": {
"type": "array",
"items": {}
},
"place": {
"type": [
"string",
"null"
]
},
"calendar": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"time_zone": {
"type": "string"
},
"hemisphere": {
"type": "string"
}
},
"additionalProperties": false
}{
"title": "Find moon phase",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}generate_moon_poster — Generate moon poster
Use this when the user wants a printable moon phase poster: the moon on one special date, two dates side by side ("our moons" couple print), or a lunar calendar of a whole year. Computes the real phases and returns a preview plus vector PDFs (12x18 in, 18x24 in, A3, Letter, A4) and SVG. Does not sell or ship prints. Do not use for a quick phase answer without a poster; that is find_moon_phase.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind"
],
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"description": "City for the time zone and hemisphere (southern hemisphere moons are drawn mirrored), e.g. \"Melbourne, Australia\". Default UTC."
},
"kind": {
"enum": [
"moon",
"pair",
"year"
],
"type": "string",
"description": "moon: one date's moon as a large print; pair: two dates side by side (e.g. two birthdays) with whether they complete each other; year: a lunar calendar of all 365 days. Example: pair."
},
"year": {
"type": "integer",
"maximum": 2200,
"minimum": 1800,
"description": "For year: the calendar year, e.g. 2027."
},
"dates": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 2,
"description": "For moon: one date; for pair: two dates. YYYY-MM-DD, optionally with a local time YYYY-MM-DDTHH:MM, e.g. [\"1995-03-14\", \"1996-09-02\"]."
},
"theme": {
"enum": [
"midnight",
"black",
"paper",
"ink"
],
"type": "string",
"description": "midnight (default), black, paper, or ink."
},
"title": {
"type": "string",
"maxLength": 80,
"description": "Poster headline, e.g. \"The moon on the day you were born\"."
},
"labels": {
"type": "array",
"items": {
"type": "string",
"maxLength": 40
},
"maxItems": 2,
"description": "Optional names under each moon for pair, e.g. [\"Mia\", \"Leo\"]."
},
"message": {
"type": "string",
"maxLength": 160,
"description": "Short line under the title, e.g. \"Mia, 14 March 1995\"."
}
}
}{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"summary",
"moons",
"pair",
"downloads",
"request"
],
"properties": {
"kind": {
"type": "string"
},
"pair": {
"anyOf": [
{},
{
"type": "null"
}
]
},
"moons": {
"type": "array",
"items": {}
},
"request": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"summary": {
"type": "string"
},
"downloads": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
}
},
"additionalProperties": false
}{
"title": "Generate moon poster",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
1 advertised
sky-keepsake-widget — Moon & Star Map view
Interactive view for Moon & Star Map.
ui://widget/sky-keepsake-v2-1.0.0-15f79fb8b4a515c3ceca8db7be23f0ef2becd8cdbcf8d190aec5d96e06180036.htmlsky-keepsake-widget-legacy — Moon & Star Map view (previous versions)
ui://widget/sky-keepsake-{version}.html30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 818 ms
- 95th percentile latency
- 818 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 818 ms · metadata changed · 3 tool(s), 1 resource(s), 1 resource template(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http moon-star-map-mcp https://sky-keepsake.zovo.one/mcpCodex
codex mcp add moon-star-map-mcp --url https://sky-keepsake.zovo.one/mcpCursor
{
"mcpServers": {
"moon-star-map-mcp": {
"url": "https://sky-keepsake.zovo.one/mcp"
}
}
}Cline
{
"mcpServers": {
"moon-star-map-mcp": {
"type": "streamableHttp",
"url": "https://sky-keepsake.zovo.one/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"moon-star-map-mcp": {
"type": "http",
"url": "https://sky-keepsake.zovo.one/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http moon-star-map-mcp https://sky-keepsake.zovo.one/mcpClaude Desktop
{
"mcpServers": {
"moon-star-map-mcp": {
"url": "https://sky-keepsake.zovo.one/mcp"
}
}
}Windsurf
{
"mcpServers": {
"moon-star-map-mcp": {
"serverUrl": "https://sky-keepsake.zovo.one/mcp"
}
}
}Let your agent find its tools
Find servers like Moon & Star Map MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.