Tool tree
Explore the night sky from any place and time, from a planetarium dome to real deep-sky survey imagery.
Implementation
gradeNot graded
gradeNot graded
get_sky_contextAnswer
Get the current observer, sky view, layers, selection, and plan summary without changing the atlas.
View tool JSON
{
"name": "get_sky_context",
"kind": "answer",
"impl": "imperative",
"description": "Get the current observer, sky view, layers, selection, and plan summary without changing the atlas.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {}
},
"page": "/night-sky-atlas/"
}find_observable_targetsAnswer
Find currently observable targets matching the requested categories and sky constraints without changing the atlas.
View tool JSON
{
"name": "find_observable_targets",
"kind": "answer",
"impl": "imperative",
"description": "Find currently observable targets matching the requested categories and sky constraints without changing the atlas.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"categories": {
"type": "array",
"minItems": 1,
"maxItems": 3,
"uniqueItems": true,
"items": {
"type": "string",
"enum": [
"planet",
"bright_star",
"deep_sky"
]
}
},
"min_altitude": {
"type": "number",
"minimum": 0,
"maximum": 90
},
"max_magnitude": {
"type": "number",
"minimum": -30,
"maximum": 15
},
"at_time": {
"type": "string",
"format": "date-time"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 12
}
},
"required": [
"categories",
"min_altitude",
"limit"
]
},
"page": "/night-sky-atlas/"
}get_target_detailsAnswer
Get scientific and observing details for one target at the current or requested time without changing the atlas.
View tool JSON
{
"name": "get_target_details",
"kind": "answer",
"impl": "imperative",
"description": "Get scientific and observing details for one target at the current or requested time without changing the atlas.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"target_id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"at_time": {
"type": "string",
"format": "date-time"
}
},
"required": [
"target_id"
]
},
"page": "/night-sky-atlas/"
}set_observer_locationAction
Change the atlas observer coordinates and visibly update the sky. This does not alter a saved plan's proposed location.
View tool JSON
{
"name": "set_observer_location",
"kind": "act",
"impl": "imperative",
"description": "Change the atlas observer coordinates and visibly update the sky. This does not alter a saved plan's proposed location.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"location_name": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"latitude",
"longitude",
"location_name"
]
},
"page": "/night-sky-atlas/"
}set_observer_timeAction
Set the observer time, pause playback, and visibly update the atlas sky.
View tool JSON
{
"name": "set_observer_time",
"kind": "act",
"impl": "imperative",
"description": "Set the observer time, pause playback, and visibly update the atlas sky.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"iso_time": {
"type": "string",
"format": "date-time"
}
},
"required": [
"iso_time"
]
},
"page": "/night-sky-atlas/"
}frame_targetAction
Select and visibly center the atlas on a target, optionally using a requested field of view.
View tool JSON
{
"name": "frame_target",
"kind": "act",
"impl": "imperative",
"description": "Select and visibly center the atlas on a target, optionally using a requested field of view.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"target_id": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"field_of_view": {
"type": "number",
"minimum": 0.05,
"maximum": 180
}
},
"required": [
"target_id"
]
},
"page": "/night-sky-atlas/"
}preview_observing_planAction
Build and visibly show an observing-plan preview without changing the current observer location or time.
View tool JSON
{
"name": "preview_observing_plan",
"kind": "act",
"impl": "imperative",
"description": "Build and visibly show an observing-plan preview without changing the current observer location or time.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"title": {
"type": "string",
"minLength": 1,
"maxLength": 90
},
"audience": {
"type": "string",
"enum": [
"child",
"beginner",
"general",
"experienced"
]
},
"notes": {
"type": "string",
"maxLength": 500
},
"duration_minutes": {
"type": "integer",
"minimum": 10,
"maximum": 180
},
"target_ids": {
"type": "array",
"minItems": 1,
"maxItems": 12,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"category_requirements": {
"type": "object",
"additionalProperties": false,
"properties": {
"planet": {
"type": "integer",
"minimum": 0,
"maximum": 12
},
"bright_star": {
"type": "integer",
"minimum": 0,
"maximum": 12
},
"deep_sky": {
"type": "integer",
"minimum": 0,
"maximum": 12
}
},
"required": [
"planet",
"bright_star",
"deep_sky"
]
},
"min_altitude": {
"type": "number",
"minimum": 0,
"maximum": 90
},
"start_time": {
"type": "string",
"format": "date-time"
},
"observer": {
"type": "object",
"additionalProperties": false,
"properties": {
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180
},
"location_name": {
"type": "string",
"minLength": 1,
"maxLength": 80
}
},
"required": [
"latitude",
"longitude"
]
}
},
"required": [
"title",
"audience",
"duration_minutes",
"target_ids",
"category_requirements",
"min_altitude"
]
},
"page": "/night-sky-atlas/"
}save_observing_planAction
Save the current observing-plan preview and visibly switch it to the saved itinerary.
View tool JSON
{
"name": "save_observing_plan",
"kind": "act",
"impl": "imperative",
"description": "Save the current observing-plan preview and visibly switch it to the saved itinerary.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"preview_id": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
},
"required": [
"preview_id"
]
},
"page": "/night-sky-atlas/"
}advance_observing_tourAction
Start, move through, or jump to one target in the saved observing tour and visibly update the atlas.
View tool JSON
{
"name": "advance_observing_tour",
"kind": "act",
"impl": "imperative",
"description": "Start, move through, or jump to one target in the saved observing tour and visibly update the atlas.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"properties": {
"direction": {
"type": "string",
"enum": [
"start",
"next",
"previous"
]
},
"target_index": {
"type": "integer",
"minimum": 0,
"maximum": 11
}
},
"oneOf": [
{
"required": [
"direction"
]
},
{
"required": [
"target_index"
]
}
]
},
"page": "/night-sky-atlas/"
}configure_sky_layersAction
Change one or more visible sky layers or the survey source and immediately update the atlas.
View tool JSON
{
"name": "configure_sky_layers",
"kind": "act",
"impl": "imperative",
"description": "Change one or more visible sky layers or the survey source and immediately update the atlas.",
"inputSchema": {
"type": "object",
"additionalProperties": false,
"minProperties": 1,
"properties": {
"stars": {
"type": "boolean"
},
"objects": {
"type": "boolean"
},
"constellations": {
"type": "boolean"
},
"grid": {
"type": "boolean"
},
"labels": {
"type": "boolean"
},
"survey": {
"type": "string",
"enum": [
"auto",
"dss",
"panstarrs",
"2mass",
"off"
]
}
}
},
"page": "/night-sky-atlas/"
}