Back to Directory/Developer Tools

io.github.christerso/celestial-node

Real-time space data — ISS tracking, rocket launches, space news, Mars weather, and more

Developer ToolsJavaScriptv1.1.0

npm version MCP Registry License: MIT

Celestial Node MCP

An MCP server for real-time space data from Celestial Node.

Gives AI assistants access to 18 read-only tools covering ISS/Tiangong tracking, crew in space, rocket launches, space news, Mars missions, a 1M+ star catalog, near-Earth asteroids, satellites, and more.

About Celestial Node

Celestial Node is a comprehensive space data platform that aggregates real-time information from space agencies worldwide. It offers:

  • Space Station Tracking - Real-time positions of the ISS and Tiangong space station
  • Crew Information - Current astronauts, cosmonauts, and taikonauts in orbit
  • Rocket Launches - Upcoming launches from providers worldwide
  • Space News - Curated news from NASA, ESA, CNSA, JAXA, Roscosmos, and ISRO
  • Mars Missions - All 18 Mars missions with instruments and discoveries
  • Mars Weather - Surface conditions including temperature, pressure, and wind
  • Star Catalog - 1M+ stars from the ESA Gaia mission
  • Near-Earth Objects - Asteroid tracking and close approaches
  • Satellites - Search and track satellites with re-entry predictions
  • Space Encyclopedia - Comprehensive database of spacecraft, missions, and engines

Quick Start

Without API Key

Anonymous usage is limited to 25 requests per hour.

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

{
  "mcpServers": {
    "celestial-node": {
      "command": "npx",
      "args": ["-y", "celestialnode-mcp"]
    }
  }
}

Claude Code

claude mcp add celestial-node -- npx -y celestialnode-mcp

With API Key

Register at celestialnode.com/register for higher rate limits.

Claude Desktop

{
  "mcpServers": {
    "celestial-node": {
      "command": "npx",
      "args": ["-y", "celestialnode-mcp"],
      "env": {
        "CELESTIAL_NODE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add celestial-node --env CELESTIAL_NODE_API_KEY=your-api-key-here -- npx -y celestialnode-mcp

Rate Limits

TierLimitAuthentication
Anonymous25 requests/hourNone
Registered (free)100 requests/dayAPI key
Paid500 requests/dayAPI key

Register for a free API key at celestialnode.com/register.

Tools

ToolDescription
get_iss_positionReal-time ISS position (lat, lon, altitude, velocity)
get_tiangong_positionReal-time Tiangong station position
get_crew_in_spaceAstronauts/cosmonauts/taikonauts currently in orbit
get_upcoming_launchesUpcoming rocket launches worldwide
get_space_newsCurated space news from NASA, ESA, CNSA, JAXA, Roscosmos, ISRO
get_mars_missionsAll 18 Mars missions with instruments and discoveries
get_mars_roversMars rovers with instruments, discoveries, and status
get_mars_weatherMars surface weather (temperature, pressure, wind)
search_starsSearch 1M+ stars from ESA Gaia catalog
get_star_detailsFull astronomical data for a star by Gaia source ID
get_constellationsAll 88 IAU constellations
get_near_earth_objectsUpcoming asteroid close approaches
get_hazardous_asteroidsPotentially hazardous asteroids with orbital data
get_space_agenciesSpace agencies worldwide
search_encyclopediaSearch space encyclopedia (spacecraft, missions, engines)
get_satellite_categoriesSatellite categories with counts
search_satellitesSearch tracked satellites by name
get_upcoming_reentriesPredicted satellite/rocket stage re-entries

Data Sources

All data is served from celestialnode.com which aggregates from NASA, ESA, CNSA, JAXA, Roscosmos, ISRO, SpaceX, and other global space agencies. Data is updated in real-time by background workers.

Security

All 18 tools are read-only GET requests. No write operations, no user data access.

License

MIT

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y celestialnode-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-christerso-celestial-node": {
      "command": "npx",
      "args": [
        "-y",
        "celestialnode-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

celestialnode-mcpnpm

Compatible MCP Clients

io.github.christerso/celestial-node works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More