IO Aerospace MCP Server¶
The IO Aerospace MCP Server exposes the IO.Astrodynamics framework over the Model Context Protocol so that LLM agents and MCP clients can drive aerospace and astrodynamics calculations directly: ephemerides, orbital mechanics, frame transforms, geometry searches, mission scenarios, and time/unit conversions.
A hosted production instance is available at https://mcp.io-aerospace.org/mcp. There is no setup needed beyond pointing your MCP client at it and signing in.
What you get¶
- Celestial body ephemeris — state vectors of planets, moons, barycenters, and Lagrange points from the loaded SPICE generic kernels
- Orbital mechanics — Keplerian, equinoctial and Cartesian representations, anomaly conversions, period, mean motion, apsides, specific energy, angular momentum
- TLE — parse a NORAD Two-Line Element set and propagate it via SGP4/SDP4
- Reference frames — rotation matrix and state-rotation matrix between any two SPICE-known frames at a given epoch
- Ground stations — Deep Space Network station coordinates, state vectors, and horizon visibility
- Arbitrary surface sites — lat/lon/altitude on any body, with horizontal coordinates and frame name
- Geometry searches — find time windows where a coordinate, distance, angular separation, phase angle, elevation, or occultation/eclipse constraint is satisfied
- Observation geometry — angular separation, angular size, light time, range rate, sub-observer point, phase angle, illumination fraction
- Maneuvers — closed-form delta-V for apogee/perigee/inclination/combined plane changes, phasing, Hohmann and bi-elliptic transfers; apply an impulsive delta-V to a state
- Lambert solver — multi-revolution Lambert transfers with prograde/retrograde branches
- Mission scenarios — stateless end-to-end propagation with maneuver chaining, perturbing bodies, drag, SRP, geopotential, and constraint evaluation
- Time and units — UTC/TDB/TAI/TDT/GPS conversions, Julian/Modified Julian Date, ephemeris time, plus angular and astronomical-distance unit conversions
Powered by IO.Astrodynamics¶
Every tool delegates to the IO.Astrodynamics library and its underlying SPICE kernels. Behavior, conventions, sign of angles, reference frames, and aberration corrections are all those of IO.Astrodynamics; see its framework documentation for the physics and algorithms.
Where to go next¶
This documentation has four tabs:
- Home (you are here) — Quick Start, Authentication, Standards & Units
- Tutorials — task-driven walk-throughs of common workflows
- Tool Reference — every tool grouped by category, with parameters and a usage example
- Guides — MCP client integration and troubleshooting