Install · ≤ 2 minutes

Connect your agent to MCPOrbital.

One Apache-2.0 MCP server. 8 grounded tools across NASA JPL SBDB / CAD / Horizons, CelesTrak, NOAA SWPC + DSCOVR, NASA Exoplanet Archive, and arXiv. Every response carries a provenance[] chain to the primary source. Works with Claude Desktop, Cursor, Cline, the Anthropic / OpenAI / Gemini SDKs, or plain HTTP.

  1. 1

    Install

    npx -y @mcporbital/space-intelligence-mcp@latest

    No global install needed. The MCP server runs on-demand; most clients spawn it as a subprocess.

  2. 2

    Configure your client

    Pick your client below — Claude Desktop, Cursor, Cline, or any agent SDK. Paste the JSON / Python.

  3. 3

    Verify + first query

    Ask “research brief on Apophis” — MCPOrbital chains the right tools and cites every value.

Step 2 — Your client

Most common path. Edit the JSON config file once; restart Claude Desktop; the skill activates on any space-research trigger.

Config file
  • macOS · ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows · %APPDATA%\Claude\claude_desktop_config.json
JSON
{
  "mcpServers": {
    "space-intelligence": {
      "command": "npx",
      "args": ["-y", "@mcporbital/space-intelligence-mcp@latest"],
      "env": {
        "NASA_API_KEY": "DEMO_KEY"
      }
    }
  }
}

After savingQuit and reopen Claude Desktop (Cmd-Q, not just close). The Settings → Developer panel should show `space-intelligence` with 8 tools advertised.

First query

Give me a research brief on 99942 Apophis — orbit, physical properties, close approaches, latest papers.

MCPOrbital will chain search_space_object get_object_profile get_asteroid_close_approaches get_ephemeris, citing every value.

8 tools available

What your agent can ask

Same tool surface in Claude Desktop, the SDK, and the REST API. Every response includes a provenance[] envelope.

ToolSourcesWhat it returnsExample input
search_space_objectSBDB · MPCResolve free-form → canonical id{ "query": "Apophis" }
get_object_profileSBDB · arXivOrbit + physical + discovery + papers{ "primary_id": "99942 Apophis" }
get_ephemerisJPL HorizonsOBSERVER (RA/Dec/Mag) or VECTORS (state){ "primary_id": "99942", "center": "I11" }
get_asteroid_close_approachesJPL CADPast + future close approaches{ "primary_id": "99942", "dist_max_au": 0.05 }
get_space_weather_nowNOAA SWPC · DSCOVRKp / Bz / solar wind / X-ray snapshot{}
get_satellite_tleCelesTrak GPLatest TLE for any catalogued sat / debris{ "norad_id": 25544 }
get_exoplanet_dataNASA Exoplanet ArchiveADQL query against ps / pscomppars / toi / k2pandc{ "hostname": "TRAPPIST-1" }
compare_data_sourcesSBDB (v0.2: + MPC + ADS)Cross-source diff on a named scalar{ "primary_id": "99942", "field": "physical.diameter" }
Troubleshooting

Common questions

I get UNABLE_TO_GET_ISSUER_CERT_LOCALLY for JPL endpoints
The Mac you're running on has an outdated CA bundle. JPL's federal-PKI chain isn't in it. Fix one of two ways:
brew install ca-certificates export NODE_EXTRA_CA_CERTS="$(brew --prefix)/etc/ca-certificates/cert.pem"
Or run the MCP server in Docker — the Linux base image has fresh roots.
How do I get a personal NASA_API_KEY?
api.nasa.gov — free signup raises the gateway from 30/hr DEMO to 1000/hr. Set NASA_API_KEY in the env block of your MCP config.
ADS / Space-Track integration?
v0.2 — BYOK ADS bearer for richer literature; Space-Track per-user OAuth for SATCAT + CDM. See safety policy for the counsel-review status.
How do I verify the server is healthy?
The Claude Skill ships a one-shot:
~/.config/claude/skills/mcporbital-space-research/scripts/verify_mcp.sh
Expected: ✓ @mcporbital/space-intelligence-mcp reachable. 8 tools advertised.
Self-host the MCP server?
git clone the source, npm i && npm run build, then in your client config replace npx with node /path/to/space-intelligence-mcp/dist/index.js. Apache-2.0 — fork freely.
Streamable HTTP / hosted endpoint for claude.ai with managed MCP?
The hosted MCPOrbital instance speaks Streamable HTTP at mcp.mcporbital.com. JWT-auth; tool gating per plan. See Claude Skill page.

Ready to ground your agent?

Open the Apophis demo to see what your scientist will see, or jump into the GitHub source to read the safety layer line-by-line.