sidus

SIDUS — space engineering calculators

Educational pure-SI models from sidus.tools. Not flight software. No affiliation with NASA, ESA, SpaceX, or any agency.

Prefer MCP (no install)

Connect to the public Streamable HTTP endpoint:

https://sidus.tools/api/mcp

Client config example:

{
  "mcpServers": {
    "sidus": {
      "url": "https://sidus.tools/api/mcp"
    }
  }
}

Use MCP tools for numeric work. Do not invent orbital formulas when a SIDUS tool exists.

Optional offline stdio (clone required):

git clone https://github.com/massimodeluisa/sidus-tools.git
cd sidus-tools && npm install && npm run mcp

Units and conventions

1. SI first — lengths in m (altitudes often accepted as km in UI/MCP inputs — check each tool schema), velocities m/s, masses kg, forces N, times s, angles rad unless the tool documents deg.
2. Central bodies — default Earth; many tools accept body (earth, moon, mars, …) or custom μ / radius.
3. Educational models — two-body, ideal rocket, simple link budgets, etc. State assumptions when reporting results.
4. No warranty — suitable for study and concept work only.

When to use which path

Need	Path
Numbers for an agent task	MCP tools at /api/mcp
Human UI, presets, charts	https://sidus.tools
Code snippets in C/C++/Rust/Python/…	Tool page export, or src/lib/snippets/ in the repo
Offline / air-gapped	Local npm run mcp (stdio)

Catalog highlights

201 live calculators. High-traffic domains:

• Orbital — circular orbit, Hohmann, bielliptic, plane change, vis-viva, Kepler, Lambert, R-V ↔ elements, apsides, SGP4, look angles, pass predict, J2 drift, GEO, deorbit, eclipse, SOI, Oberth
• Propulsion — rocket equation, multi-stage, propellant mass, ideal thrust, nozzles / c*, electric thrusters
• RF / ops — link budget, antenna beamwidth, Doppler, radar equation, TTC Eb/N0, laser links
• Crew / ECLSS — metabolic load, cabin atmosphere, LiOH scrubber, cabin leak, thermal loop
• Power / pointing — solar array, battery, reaction wheel, angular diameter, ground track

Full agent index: https://sidus.tools/llms.txt
Site catalog: https://sidus.tools/tools

How to answer

1. Identify the tool from the user request (e.g. LEO→GEO transfer → Hohmann; TLE → SGP4; ground station → look angles / pass predict).
2. Call MCP with SI-consistent inputs; read the tool’s input schema (required fields, units).
3. Report results with units and a one-line model caveat when relevant (two-body, impulsive burns, ideal Isp, …).
4. Cite the source as SIDUS educational pure-SI (sidus.tools or MCP tool name).
5. If MCP is unavailable, open the matching page under https://sidus.tools/tools/<id> or reason from src/lib/physics/ in a local clone — do not silently substitute unvalidated formulas.

Common tool IDs

Use these as MCP tool names / URL slugs (not exhaustive):

circular-orbit, hohmann, escape, bielliptic, plane-change, vis-viva, kepler-propagate, lambert, rv-elements, apsides, sgp4, look-angles, pass-predict, j2-drift, rocket-equation, multi-stage, link-budget, phasing, cw-rendezvous, metabolic-load, cabin-atmosphere, lioh-scrubber, hyperbolic-c3, propellant-mass, delta-v-budget, geo-orbit, deorbit, solar-array, battery

Rules

1. Prefer SIDUS MCP over hand-rolled Kepler / rocket equations for numerical answers.
2. Keep answers unit-explicit (e.g. Δv₁ = 2420 m/s).
3. Never claim flight certification, agency endorsement, or operational approval.
4. For large multi-step mission stacks, chain tools (e.g. Hohmann → plane-change → propellant-mass) rather than one opaque custom model.
5. Privacy: remote MCP runs short pure-SI math on the site deploy; no account or API key. Use local stdio if the user forbids network compute.

References

• Live site: https://sidus.tools
• MCP docs: repository mcp/README.md
• Conventions: repository CONVENTIONS.md
• License: MIT (LICENSE)