Science
Data source: NASA Planetary Fact Sheet / IAU
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/astronomy/
claude_desktop_config.json
{
"mcpServers": {
"gnist-astronomy": {
"url": "https://context.gnist.ai/mcp/astronomy/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/astronomy/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_planet", "arguments": {"name": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/astronomy/
8 endpoints available:
GET /rest/astronomy/get_planetGET /rest/astronomy/list_planetsGET /rest/astronomy/get_starGET /rest/astronomy/search_starsGET /rest/astronomy/list_brightest_starsGET /rest/astronomy/list_nearest_starsGET /rest/astronomy/get_constellationsGET /rest/astronomy/report_feedback
Shell
curl "https://context.gnist.ai/rest/astronomy/get_planet?name=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/astronomy/get_planet",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"name": "example"
},
)
print(resp.json())
Command Line
Command
gc astronomy
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (8)
get_planetGet detailed information about a solar system planet.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | required | Planet name (e.g. Earth, Mars, Jupiter, Pluto). |
list_planetsList planets in the solar system.
| Parameter | Type | Required | Description |
|---|---|---|---|
planet_type | any | optional | Filter: terrestrial, gas_giant, ice_giant, dwarf. |
get_starGet detailed information about a notable star.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | required | Star name (e.g. Sirius, Betelgeuse, Polaris, Sun). |
search_starsSearch the star database by name or constellation.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search by star name, constellation, or designation. |
limit | integer | optional | (default: 10) |
list_brightest_starsList the brightest stars visible from Earth, sorted by apparent magnitude.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | optional | (default: 10) |
list_nearest_starsList the nearest stars to Earth, sorted by distance in light-years.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | optional | (default: 10) |
get_constellationsList all constellations represented in the star database.
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |