How to Use NASA Exoplanet Archive planet search in opencode
Returns exoplanets matching physical, distance, host-star, or discovery-method criteria. Use it to build a comparison sample or find nearby worlds when you have properties in mind instead of a planet name.
Prompts to try with NASA Exoplanet Archive planet search in opencode
Copy an example into opencode, or ask in your own words.
Use NASA Exoplanet Archive planet search to find 20 planets within 10 parsecs, nearest first, and add a distance comparison chart to this project.
Use NASA Exoplanet Archive planet search to find 20 planets with radii between 0.8 and 1.2 Earth radii, smallest first, and create a comparison table in this project.
Use NASA Exoplanet Archive planet search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from NASA Exoplanet Archive planet search and tell me what changed since last week.
Check NASA Exoplanet Archive planet search and summarize what you find in three bullet points.
How to set up NASA Exoplanet Archive planet search in opencode
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the server
Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
- Sign in
Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.
opencode mcp auth spiral
- Check it
Spiral shows as connected.
opencode mcp list
Use the Spiral skill
- Send opencode this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run NASA Exoplanet Archive planet search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "exoplanetarchive-ipac-caltech-edu/exoplanets/search_planets", "input": { "sort": "newest" } }'
Then paste one of the prompts above: opencode finds NASA Exoplanet Archive planet search on Spiral, shows the price and runs it.
NASA Exoplanet Archive planet search providers and prices
Spiral runs NASA Exoplanet Archive planet search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask opencode for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Sort | newest, oldest, nearest, smallest_radius, largest_radius, shortest_period, longest_period, or name | newest | Order: newest or oldest discovery publication, nearest system, radius or orbital period ascending/descending, or name. Numeric sorts leave out planets without that value. |
| Limit | 1 to 100 | 25 | Planets to return (1 to 100). |
| Mass earth max | a number from 0 | Highest mass in Earth masses (planets with no mass value are excluded when set) (inclusive). | |
| Mass earth min | a number from 0 | Lowest mass in Earth masses (planets with no mass value are excluded when set) (inclusive). | |
| Distance pc max | a number from 0 | Highest system distance in parsecs (1 pc = 3.26 light years) (inclusive). | |
| Distance pc min | a number from 0 | Lowest system distance in parsecs (1 pc = 3.26 light years) (inclusive). | |
| Discovery method | Astrometry, Disk Kinematics, Eclipse Timing Variations, Imaging, Microlensing, Orbital Brightness Modulation, Pulsar Timing, Pulsation Timing Variations and 3 more | Only planets found by this method. | |
| Radius earth max | a number from 0 | Highest radius in Earth radii (inclusive). | |
| Radius earth min | a number from 0 | Lowest radius in Earth radii (inclusive). | |
| Discovery year max | 1980 to 2100 | Highest discovery year (inclusive). | |
| Discovery year min | 1980 to 2100 | Lowest discovery year (inclusive). | |
| Orbital period days max | a number from 0 | Highest orbital period in days (inclusive). | |
| Orbital period days min | a number from 0 | Lowest orbital period in days (inclusive). | |
| Equilibrium temperature k max | a number from 0 | Highest equilibrium temperature in kelvin (inclusive). | |
| Equilibrium temperature k min | a number from 0 | Lowest equilibrium temperature in kelvin (inclusive). |
Every API field of NASA Exoplanet Archive · Search planets is on its tool page: open its card above.
What can you do with NASA Exoplanet Archive planet search in opencode?
Build an exoplanet comparison table in your project using archive masses, radii, and orbital data. A coding agent can turn planet lookups, system records, or search results into labeled views and calculations.
Check an astronomy article
Check a named planet's reported properties, compare it with the other planets around its host star, and find a comparison sample before describing it as unusually small or massive.
Build a classroom comparison
Prepare a lesson around Kepler-186 f, the Kepler-186 system, or a sample of similarly sized planets. Compare returned radii and orbital periods in a table students can read.
Refresh a planetarium script
Replace old planet measurements in a script with current archive values. Check a featured world, review its host system, or choose examples from a nearby-planet search.
Maintain an exoplanet reference app
Populate planet detail views, system comparison tables, and filtered browsing results. Keep Earth-radius units visible and distinguish minimum masses wherever the returned data identifies them.
Find comparisons for a featured planet
Start with a world such as Kepler-186 f, then search for planets in a similar radius range. Use the returned measurements to explain what the examples share.
Compare planetary system layouts
Build orbital-period and radius tables for TRAPPIST-1 and Kepler-90, or search each host separately for a narrower comparison. Use the results to choose examples for a system architecture lesson.
More on NASA Exoplanet Archive planet search and opencode
Overview
NASA Exoplanet Archive planet search in other agents
Questions about NASA Exoplanet Archive planet search in opencode
Can opencode use NASA Exoplanet Archive planet search?
Yes. Add Spiral to opencode as an MCP server, and opencode can find and run NASA Exoplanet Archive planet search like any built-in tool.
How much does NASA Exoplanet Archive planet search cost in opencode?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.
Do I need an Alexandria account to use NASA Exoplanet Archive planet search in opencode?
No. Spiral runs NASA Exoplanet Archive planet search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up NASA Exoplanet Archive planet search in opencode?
About two minutes: add the server, then sign in, then check it.
Does opencode wait while NASA Exoplanet Archive planet search runs?
NASA Exoplanet Archive planet search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.
How fresh are the planet and star measurements?
The archive generally adds new planets and updated planetary and stellar data weekly. It sometimes skips a week, so updates do not follow a guaranteed seven-day schedule.
What mass range does the archive classify as planetary?
Its inclusion criteria require a mass, or minimum mass, of no more than 30 Jupiter masses. That boundary helps explain why an object described as a planet elsewhere might be absent.
Where do the measurements come from?
The archive collects parameter sets for planets, their orbits, and their host systems from refereed literature. These are published scientific results rather than a continuous stream of telescope measurements.
Can all values in a planet record be used together in a physical model?
Use caution with composite data: the archive combines values from different references to fill gaps, and the resulting parameter set may not be internally consistent. Its documentation recommends the Planetary Systems table when a self-consistent published solution is needed.
Does a reported planet mass always mean its true mass?
No. The archive distinguishes true mass from the minimum mass measured through radial velocity, expressed as mass times the sine of orbital inclination. Keep that distinction when comparing planets by mass.
Start using NASA Exoplanet Archive planet search in opencode
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into opencode:
set up https://spiral.ai/SKILL.md


