orbital-telemetry-agent

orbital-telemetry-agent is an open-source, high-precision autonomous satellite orbit propagator, ground station pass predictor, and Model Context Protocol (MCP) server in Python.

Architecture Overview

graph TD
    A[NORAD Two-Line Element: TLE] --> B[KeplerianPropagator with J2 Secular Drift]
    B --> C[Earth-Centered Inertial: ECI Coordinates]
    C --> D[WGS-84 Geodetic Converter: Lat / Lon / Alt]
    C --> E[GroundStation Topocentric SEZ Frame]
    E --> F[Azimuth / Elevation / Slant Range]
    E --> G[DopplerCalculator: RF Line-of-Sight Shift]
    F --> H[PassPredictor: Autonomous AOS / LOS Scheduler]
    H --> I[orbitctl CLI & Deliverables Exporter]
    H --> J[MCP Server: Claude & Cursor Tooling]

Related MCP server: Taskade MCP Server

Core Capabilities

1. Analytical Keplerian Propagator with $J_2$ Secular Oblateness:

   • Models the non-spherical gravitational harmonic perturbation of Earth ($J_2 = 1.08263 \times 10^{-3}$).

   • Predicts nodal regression rate ($\dot{\Omega}$) and argument of perigee precession ($\dot{\omega}$).

2. WGS-84 Geodetic Coordinate Transformations:

   • Converts Earth-Centered Inertial (ECI) coordinates to Earth-Centered Earth-Fixed (ECEF) via Greenwich Mean Sidereal Time (GMST).

   • Implements Bowring's closed-form algorithm for precise geodetic latitude, longitude, and ellipsoidal altitude.

3. Autonomous Ground Station Pass Scheduler:

   • Detects Acquisition of Signal (AOS), Loss of Signal (LOS), max elevation, and pass duration over any earth station.

4. RF Doppler Frequency Shift:

   • Calculates instantaneous line-of-sight range rate and RF frequency offset for satellite communications (UHF/VHF/S-Band).

5. Model Context Protocol (MCP) Server:

   • Connects AI coding assistants (Claude Desktop, Cursor, Windsurf, and Antigravity) directly to live orbit propagation tools.

Quickstart

git clone https://github.com/perfectalone375/orbital-telemetry-agent.git
cd orbital-telemetry-agent
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e ".[dev]"

CLI Tracking (orbitctl)

# Query current satellite position
orbitctl track --seconds 300

# Predict upcoming passes over Hyderabad Ground Station
orbitctl passes --lat 17.3850 --lon 78.4867 --name "Hyderabad-GS"

Model Context Protocol (MCP) Integration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "orbital-telemetry": {
      "command": "python",
      "args": ["-m", "orbital_telemetry.mcp.server"]
    }
  }
}

Automated Test Suite

pytest -v --cov=orbital_telemetry

License

MIT License. Developed by Gopi Naga Vignesh Thirupati.