{"data":{"name":"com.cyclecalcs/astronomy","title":"CycleCalcs Astronomy","description":"Read-only astronomy calculations: sun, moon, planets, eclipses, twilight and star positions.","version":"1.1.0","websiteUrl":"https://www.cyclecalcs.com/api/mcp.html","repositoryUrl":null,"remotes":[{"url":"https://www.cyclecalcs.com/mcp","type":"streamable-http","headers":[{"name":"Authorization","isSecret":true,"description":"Optional. Without a key, tools work up to 50 calls a day per network address; a key raises the daily limit. Bearer YOUR_KEY, where YOUR_KEY is a CycleCalcs API key from RapidAPI (the Basic plan is free): https://rapidapi.com/info-8KZIhinZ9/api/cyclecalcs-astronomy-api3"}]}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-10-01T00:17:16.360Z","updatedAt":"2026-10-01T00:17:16.360Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"CycleCalcs Astronomy","source":"official-registry","sourceId":"com.cyclecalcs/astronomy","updatedAt":"2026-10-01T00:17:16.360Z","confidence":100,"websiteUrl":"https://www.cyclecalcs.com/api/mcp.html","description":"Read-only astronomy calculations: sun, moon, planets, eclipses, twilight and star positions.","verification":"official","repositoryUrl":null}],"toolIndex":{"tools":[{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_dark_window","title":"Dark moonless observing window","description":"The genuinely dark, moonless observing window for a night: astronomical night intersected with the Moon being down, ranked across up to 62 nights with a trend. The right tool for \"when should I stargaze / photograph the Milky Way / observe deep-sky objects\". Location required. For plain twilight times use astro_sun; for whether tonight's clouds allow it, use observing_windows.","inputSchema":{"type":"object","properties":{"date":{"type":"string","description":"Night to start from. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"nights":{"type":"integer","minimum":1,"maximum":62,"description":"How many nights to evaluate and rank. Default 1."},"moon_illumination_max":{"type":"number","minimum":0,"maximum":1,"description":"Treat the Moon as tolerable below this illuminated fraction (0..1) even when up."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false,"anyOf":[{"required":["lat","lon"]},{"required":["place"]}]},"annotations":{"title":"Dark moonless observing window","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"9c378098aeddef5a038fad88ee0115113fd6b205142ca37b6dc05534eca5b14f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_eclipses","title":"Solar and lunar eclipses","description":"Solar and lunar eclipses: the next or previous from a date, or all in a range, with type, magnitude, obscuration, Saros series and global geometry. A solar eclipse also carries a computed hybrid flag and, when central, the duration, path width and Sun altitude at greatest eclipse. With a location it adds local circumstances, contact times, and an explicit visible-from-here answer; set visible_only to true to keep only eclipses visible there. include adds the precomputed central path or the circumstances at greatest local eclipse. NOTE: count applies per type, so count=3 with type \"both\" can return six events.","inputSchema":{"type":"object","properties":{"direction":{"type":"string","enum":["next","previous"],"description":"Search direction from the anchor date. Default \"next\"."},"type":{"type":"string","enum":["solar","lunar","both"],"description":"Which kind of eclipse to report. Default \"both\"."},"count":{"type":"integer","minimum":1,"description":"How many eclipses PER TYPE to return."},"date":{"type":"string","description":"Anchor date to search from. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"start":{"type":"string","description":"First day of an explicit window (use with end). ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"end":{"type":"string","description":"Last day of an explicit window. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"visible_only":{"type":"boolean","description":"true keeps only eclipses visible from the supplied location (requires a location)."},"include":{"type":"array","items":{"type":"string","enum":["path","greatest"]},"uniqueItems":true,"description":"Optional extras, added to the default blocks rather than replacing them. \"path\": the precomputed central path of a solar eclipse as inline GeoJSON (central line, northern and southern limits, and per-minute duration, width, phase and Sun altitude), for the central eclipses that have one; every other eclipse says why it has none. Large: about 65 to 90 KB of JSON per eclipse, returned as both text and structured content, so ask for one eclipse at a time (type \"solar\", a date just before it, count 1). \"greatest\": the circumstances at greatest eclipse from the supplied location, inside each solar eclipse's local block (requires a location)."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous result's next_cursor. Send it with the same start/end arguments as the first page."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false},"annotations":{"title":"Solar and lunar eclipses","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"78a825bd9c503c58f5269a244db5898e734d58fc9d03b6a74aec76a9224ffa10","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_find_place","title":"Place name to coordinates and timezone","description":"Resolve a place name to coordinates, region, country, IANA timezone and a stable place_id, or reverse-look-up the nearest places to a lat/lon. Results are GeoNames data (CC BY 4.0); the response carries the required credit in its attribution field, which must be preserved when results are shown. Note the other tools accept a place argument directly, so this is only needed to disambiguate a name, filter by country, or reverse-geocode.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"The place NAME to search for, one to three words, e.g. \"Springfield\" or \"Springfield,US\". Never a question or a sentence: send \"Lisbon\", not \"moon phase tonight in Lisbon\"."},"id":{"type":"string","description":"A place_id from an earlier result, to fetch that exact place."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"country":{"type":"string","description":"Two-letter ISO country code filter, e.g. \"US\"."},"limit":{"type":"integer","minimum":1,"maximum":25,"description":"Maximum matches to return. Default 5."}},"additionalProperties":false,"anyOf":[{"required":["query"]},{"required":["id"]},{"required":["lat","lon"]}]},"annotations":{"title":"Place name to coordinates and timezone","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a67504a024be7d82df31ea4baa21dc6f44d69144c68e800f01aee7865f84a2a2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_moon","title":"Moon state and appearance","description":"The Moon at an instant or as a daily series: phase name and angle, illuminated fraction, distance, apparent size, libration, bright limb, and the next quarter phases. A location adds rise/set and altitude. For a calendar of new and full moons use astro_moon_phases; for the Moon's exact coordinates use astro_positions.","inputSchema":{"type":"object","properties":{"date":{"type":"string","description":"ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"start":{"type":"string","description":"First day of a daily series. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"end":{"type":"string","description":"Last day of a daily series. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"count":{"type":"integer","minimum":1,"description":"Number of daily rows from start (alternative to end)."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous result's next_cursor. Send it with the same start/end arguments as the first page."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false},"annotations":{"title":"Moon state and appearance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c9edec9e2f6473a4075f4197c8ada60fccfa102e8b43a92568859720a2753340","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_moon_phases","title":"Lunar phase calendar","description":"Every new moon, quarter and full moon in a window (or the next few from a date): each with its exact instant, distance, apparent size, supermoon classification under both competing definitions, traditional full-moon name, and any eclipse falling on it. Use for \"when is the next full moon\" and phase calendars. For the Moon's state right now use astro_moon.","inputSchema":{"type":"object","properties":{"date":{"type":"string","description":"Anchor date; the next phases follow it. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"start":{"type":"string","description":"First day of a window (use with end). ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"end":{"type":"string","description":"Last day of a window. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"count":{"type":"integer","minimum":1,"description":"How many phase events to return from the anchor date."},"phases":{"type":"array","items":{"type":"string","enum":["new_moon","first_quarter","full_moon","last_quarter"]},"minItems":1,"description":"Optional filter of phase kinds. Omit for all four. Example: [\"full_moon\"] for full moons only."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous result's next_cursor. Send it with the same start/end arguments as the first page."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false},"annotations":{"title":"Lunar phase calendar","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"fa997553d3a609b550dc791f46f52d1049374bc71414ca0eef256cd0b612e5ff","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_planet_board","title":"All planets at a glance","description":"All eight planets in one call for a date and optional location: constellation, magnitude, apparent size, elongation from the Sun, morning or evening sky, retrograde state with the next station, rise/set, and a worth-looking-tonight assessment. The right tool for \"which planets are visible tonight\". For exact coordinates of specific bodies use astro_positions.","inputSchema":{"type":"object","properties":{"date":{"type":"string","description":"ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"bodies":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":8,"description":"Optional subset of planets: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto."},"sort":{"type":"string","enum":["distance_from_sun","magnitude","elongation","altitude"],"description":"Optional result ordering. Default is by distance from the Sun."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false},"annotations":{"title":"All planets at a glance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"ed3ccd15470670cfcc48358303d23858738f61cd1fe069084f73744e5e9347ab","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_planet_events","title":"Planet events: apparitions, oppositions, constellation entries","description":"Dated planet events. For Mercury and Venus, the apparition cycle: inferior and superior conjunctions, greatest eastern and western elongations, peak brightness (a Venus-only event: Mercury's brightness peaks behind the Sun where it cannot be seen), and the rare transits across the Sun; with no dates it also reports where each is in its cycle right now: morning star or evening star, the conjunctions bounding the current apparition, and the live elongation, phase, magnitude and apparent size. For Mars, Jupiter, Saturn, Uranus and Neptune: conjunction with the Sun, western quadrature, opposition and eastern quadrature, the instants the planet's apparent geocentric ecliptic longitude minus the Sun's reaches 0, 270, 180 and 90 deg, each with the planet's constellation, distance, magnitude and elongation. For any of the seven, constellation_entry, returned only when listed in kinds: each crossing of an IAU constellation boundary, with the two constellations and the direction of motion. The right tool for \"when does Venus become the morning star\", \"when is Mars at opposition\", or \"when does Uranus cross from Taurus into Gemini\". For tonight's visibility of all eight planets use astro_planet_board. Mercury and Venus conjunction instants use the classical heliocentric convention, named on each event.","inputSchema":{"type":"object","properties":{"bodies":{"type":"array","items":{"type":"string","enum":["mercury","venus","mars","jupiter","saturn","uranus","neptune"]},"minItems":1,"maxItems":7,"description":"Which planets to report. Default mercury and venus."},"kinds":{"type":"array","items":{"type":"string","enum":["inferior_conjunction","superior_conjunction","greatest_elongation_east","greatest_elongation_west","peak_magnitude","transit_of_mercury","transit_of_venus","conjunction_with_sun","quadrature_west","opposition","quadrature_east","constellation_entry"]},"minItems":1,"description":"Optional filter of event kinds. Omit for each planet's own family: the seven apparition kinds for mercury and venus, the four Sun-relative kinds for mars to neptune. peak_magnitude only ever fires for venus; the transit kinds are body-specific and genuinely rare. constellation_entry applies to all seven and must be listed."},"date":{"type":"string","description":"Anchor instant; with no start/end the response covers the next full synodic cycle from here. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"start":{"type":"string","description":"First day of an explicit window (use with end). ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"end":{"type":"string","description":"Last day of an explicit window, exclusive. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous result's next_cursor. Send it with the same start/end arguments as the first page."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false},"annotations":{"title":"Planet events: apparitions, oppositions, constellation entries","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"eff8289d85351fb11667177869c00f752271102a237ee79a845ffbcfd97ff5f9","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_positions","title":"Precise positions of bodies","description":"Exact positions for up to 20 bodies at an instant or over a time grid: right ascension and declination in both J2000 and of-date frames, ecliptic longitude and latitude, distance, and, with a location, altitude and azimuth with refraction stated per field. With a location the position is topocentric, but tropical_sign and constellation stay geocentric, and meta.conventions.label_origin says so. Use for \"where exactly is X\". Do not pass earth. For rise and set TIMES use astro_rise_set; for a visibility overview of all planets use astro_planet_board.","inputSchema":{"type":"object","properties":{"bodies":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":20,"description":"Bodies to report. Each entry: One of sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, or a fixed J2000 target as \"radec:RA,DEC\" with RA in hours (0-24) and DEC in degrees (-90..90), e.g. \"radec:5.6,-5.4\" for the Orion Nebula region."},"date":{"type":"string","description":"ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"start":{"type":"string","description":"Grid start (use with end and step). ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"end":{"type":"string","description":"Grid end. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"step":{"type":"string","description":"Grid stride, e.g. \"1h\", \"10min\", \"1d\"."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous result's next_cursor. Send it with the same start/end arguments as the first page."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"required":["bodies"],"additionalProperties":false},"annotations":{"title":"Precise positions of bodies","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5dd50de82a4d93b8c2c277f3397b5347f13668296d3827a2e607209ba185f77f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_rise_set","title":"Rise, transit and set times","description":"Rise, upper transit, set and lower transit for one body at one location, with an explicit status at extreme latitudes (circumpolar, never rises) instead of missing values. Accepts fixed radec targets. For the Sun specifically, astro_sun returns richer twilight structure; for positions between events use astro_positions.","inputSchema":{"type":"object","properties":{"body":{"type":"string","description":"One of sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, or a fixed J2000 target as \"radec:RA,DEC\" with RA in hours (0-24) and DEC in degrees (-90..90), e.g. \"radec:5.6,-5.4\" for the Orion Nebula region."},"date":{"type":"string","description":"ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"start":{"type":"string","description":"First day of a daily series. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"end":{"type":"string","description":"Last day of a daily series. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"search_horizon_days":{"type":"integer","minimum":1,"description":"How many days ahead to search when an event does not occur on the requested day (high latitudes)."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous result's next_cursor. Send it with the same start/end arguments as the first page."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"required":["body"],"additionalProperties":false,"anyOf":[{"required":["lat","lon"]},{"required":["place"]}]},"annotations":{"title":"Rise, transit and set times","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"1ade2e5d00f70af6ccff36fae677076c7c719fead1a36c30b99300e9f439df96","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_sky_today","title":"Sky snapshot for a place and moment","description":"One-call snapshot of the whole sky for a place and moment: moon phase and illumination, which planets are up and worth looking at, the next eclipse, and (with a location) sun times. Reach for this first when the question is broad, like \"what is in the sky tonight\". For solar-day detail use astro_sun; for choosing an observing night use astro_dark_window, and for whether tonight's clouds allow it use observing_windows; for one planet's exact position use astro_positions.","inputSchema":{"type":"object","properties":{"date":{"type":"string","description":"ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false},"annotations":{"title":"Sky snapshot for a place and moment","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"83e98bfe511128e7867d10c9edc9dd4de6e9355e7ef81200b8a3b2882276f8cd","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"astro_sun","title":"Sunrise, sunset and twilight","description":"The complete solar day for one location: sunrise, sunset, solar noon, day length, civil, nautical and astronomical twilight boundaries, and explicit polar day/night status at high latitudes. Location required. For a series, send start and end (step is whole days, e.g. \"1d\" or \"7d\"). For \"is it dark enough to observe\" prefer astro_dark_window; for a broad snapshot prefer astro_sky_today.","inputSchema":{"type":"object","properties":{"date":{"type":"string","description":"Single day to report, ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"start":{"type":"string","description":"First day of a range (use with end instead of date). ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"end":{"type":"string","description":"Last day of a range. ISO 8601 UTC date or datetime, e.g. \"2026-08-06\" or \"2026-08-06T21:00:00Z\". With a location, a bare date means that date there: its day, its evening and its night. Or jd: followed by a Julian Day on the UT scale, e.g. \"jd:2461000.5\". On astro_positions, date may list up to 24 datetimes separated by commas, answered in the order sent. Omit for the current moment. Years 1700 to 2200 only; outside that range the API refuses with DATE_OUT_OF_RANGE because the ephemeris is not reliable there."},"step":{"type":"string","description":"Range stride in whole days, e.g. \"1d\", \"7d\", \"30d\". Default \"1d\"."},"cursor":{"type":"string","description":"Opaque pagination cursor from a previous result's next_cursor. Send it with the same start/end arguments as the first page."},"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"tz":{"type":"string","description":"IANA timezone like \"Europe/Lisbon\" to render event times in local time. Optional; a resolved place supplies its own timezone."}},"additionalProperties":false,"anyOf":[{"required":["lat","lon"]},{"required":["place"]}]},"annotations":{"title":"Sunrise, sunset and twilight","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"e4e02756f18d00b44138077c0be60d37bd35632a1ce5af63d40f0e66a40e57c0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"},{"serverName":"com.cyclecalcs/astronomy","endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","name":"observing_windows","title":"Clear, dark observing windows tonight","description":"Is tonight good for observing here, and when? The clear, dark windows of tonight, and of the next nights the hourly cloud forecast covers, for one place: astronomical night with the Moon down (or up, with moon \"any\"), under the MET Norway cloud forecast. The windows are the ones the CycleCalcs Observing Planner widget draws, and the rule below decides which count; the answer is the /api/observing-windows feed's. Returns summary (tonight in one sentence on the place's clock), go_tonight (true when tonight has a window that passes the rule), next (the first window ahead that passes, with start, end, minutes and starts_in_minutes), tonight and later. Give lat, lon and tz, or a place name; lat and lon are rounded to two decimals (about 1 km), the precision of the forecast. The right tool for \"is it clear enough to stargaze tonight\" or \"when should I set up the telescope\". For the moonless dark alone, without weather, or for nights past the forecast, use astro_dark_window.","inputSchema":{"type":"object","properties":{"lat":{"type":"number","minimum":-90,"maximum":90,"description":"Latitude in decimal degrees, north positive. Send lat and lon together."},"lon":{"type":"number","minimum":-180,"maximum":180,"description":"Longitude in decimal degrees, east positive (Lisbon is about -9.14). Send lat and lon together."},"tz":{"type":"string","description":"The place's IANA timezone, such as \"America/Chicago\". Required with lat and lon: tonight and every time in the answer are on the place's clock. A resolved place supplies its own."},"place":{"type":"string","description":"The place NAME only, one to three words, instead of lat/lon: \"City\" or \"City,CC\" with an ISO country code, e.g. \"Lisbon,PT\". Never a question or a sentence. Resolved server-side; the response then carries a required GeoNames CC BY 4.0 credit in its attribution field, which must be preserved when shown."},"cloudmax":{"type":"integer","minimum":10,"maximum":50,"description":"The clear limit: an hour is clear when the forecast gives under this percent of total cloud (and under 25 percent fog, with no rain forecast). Default 30."},"min_minutes":{"type":"integer","minimum":30,"maximum":360,"description":"The shortest window worth going out for, in minutes. Default 60."},"moon":{"type":"string","enum":["down","any"],"description":"\"down\" (the default) counts only windows with the Moon below the horizon; \"any\" lets it be up."}},"additionalProperties":false,"anyOf":[{"required":["lat","lon","tz"]},{"required":["place"]}]},"annotations":{"title":"Clear, dark observing windows tonight","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"49cc6ecda0c09f878fbb1c67c83cae3544cafc4c28692a55b8422b8ba11bb27d","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-15T08:46:33.871Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"ff28d674bb4d3eab77781a2d40a327f144d724a4b3a24b15aa0f314a84a7b20c","protocol":"streamable-http","status":"indexed","toolCount":12,"observedAt":"2026-11-15T08:46:33.871Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.cyclecalcs/astronomy":{"url":"https://www.cyclecalcs.com/mcp"}}},"Cursor":{"mcpServers":{"com.cyclecalcs/astronomy":{"url":"https://www.cyclecalcs.com/mcp"}}},"VS Code":{"servers":{"com.cyclecalcs/astronomy":{"type":"http","url":"https://www.cyclecalcs.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://www.cyclecalcs.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.cyclecalcs%2Fastronomy","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.cyclecalcs%2Fastronomy","name":"com.cyclecalcs/astronomy","description":"Read-only astronomy calculations: sun, moon, planets, eclipses, twilight and star positions.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://www.cyclecalcs.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://www.cyclecalcs.com/api/mcp.html","repositoryUrl":null,"version":"1.1.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.cyclecalcs/astronomy","status":"online","lastCheckedAt":"2026-11-20T06:16:59.474Z","lastSuccessfulCheck":"2026-11-20T06:16:59.474Z","latencyMs":103,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T06:16:59.474Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T06:16:59.474Z"},"security":null,"timestamps":{"createdAt":"2026-10-01T00:17:16.360Z","updatedAt":"2026-10-01T00:17:16.360Z","observedAt":"2026-11-20T06:16:59.474Z"},"compatibility":{"serverVersion":"1.1.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}