Spiral gives your agent every tool with one account. Browse the tools →

opencode · Public Records

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.

NASA Exoplanet Archive planet searchopencode
Try asking
  • 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

  1. 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
  2. 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
  3. Check it

    Spiral shows as connected.

    opencode mcp list

Use the Spiral skill

  1. Send opencode this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. 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

  1. Create an API key

    In the console, under API keys.

  2. 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.

AlexandriaPublic Records
NASA Exoplanet Archive · Search planets
exoplanetarchive-ipac-caltech-edu/exoplanets/search_planets

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Sortnewest, oldest, nearest, smallest_radius, largest_radius, shortest_period, longest_period, or namenewest

Order: newest or oldest discovery publication, nearest system, radius or orbital period ascending/descending, or name. Numeric sorts leave out planets without that value.

Limit1 to 10025

Planets to return (1 to 100).

Mass earth maxa number from 0

Highest mass in Earth masses (planets with no mass value are excluded when set) (inclusive).

Mass earth mina number from 0

Lowest mass in Earth masses (planets with no mass value are excluded when set) (inclusive).

Distance pc maxa number from 0

Highest system distance in parsecs (1 pc = 3.26 light years) (inclusive).

Distance pc mina number from 0

Lowest system distance in parsecs (1 pc = 3.26 light years) (inclusive).

Discovery methodAstrometry, 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 maxa number from 0

Highest radius in Earth radii (inclusive).

Radius earth mina number from 0

Lowest radius in Earth radii (inclusive).

Discovery year max1980 to 2100

Highest discovery year (inclusive).

Discovery year min1980 to 2100

Lowest discovery year (inclusive).

Orbital period days maxa number from 0

Highest orbital period in days (inclusive).

Orbital period days mina number from 0

Lowest orbital period in days (inclusive).

Equilibrium temperature k maxa number from 0

Highest equilibrium temperature in kelvin (inclusive).

Equilibrium temperature k mina 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.

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.

Get started

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 opencode

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options