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

VS Code · News & Media

How to Use NASA media search in VS Code

Finds NASA images, videos, and audio through indexed metadata, returning matching records with descriptions and preview links. Use it to shortlist material by mission or subject before retrieving an item's files.

Prompts to try with NASA media search in VS Code

Copy an example into VS Code, or ask in your own words.

Use NASA media search to find Apollo 11 lunar surface material and add a gallery to this project showing returned titles, descriptions, and preview links.

NASA media searchVS Code
Try asking
  • Use NASA media search for James Webb Space Telescope and create a local JSON collection of returned titles, NASA IDs, creation dates, and descriptions.

  • Use NASA media search for Kennedy Space Center rocket launch and populate this project's media picker with returned records and previews.

  • Use NASA media search to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from NASA media search and tell me what changed since last week.

How to set up NASA media search in VS Code

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the hosted server

    Use Add to VS Code on the console's Agents & MCP page, or run:

    code --add-mcp '{"name":"spiral","type":"http","url":"https://api.spiral.ai/mcp"}'
  2. Sign in

    VS Code asks you to sign in when it first starts the server: sign in to Spiral and click Authorize. No API key. Run MCP: List Servers from the Command Palette to check that Spiral is running.

Use the Spiral skill

  1. Send VS Code 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 media 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": "images-nasa-gov/media/search_media",
        "input": {
          "q": "<q>"
        }
      }'

Then paste one of the prompts above: VS Code finds NASA media search on Spiral, shows the price and runs it.

NASA media search providers and prices

Spiral runs NASA media search through Alexandria. Open a card for today's price, with every fee included.

AlexandriaNews & Media
NASA Image and Video Library · Search media
images-nasa-gov/media/search_media

Settings you can ask for

Ask VS Code for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Year end1900 to 2100

year_end

Page size1 to 5010

page_size

Media typeaudio, image, video, or allaudio

Media type to return; defaults to audio.

Year start1900 to 2100

year_start

Include fileson or off

Resolve preview_url/download_url for audio and video hits (one manifest request per hit). Images always carry them.

Every API field of NASA Image and Video Library · Search media is on its tool page: open its card above.

What can you do with NASA media search in VS Code?

Build a NASA media browser that pairs searchable mission records with downloadable files. Use descriptions for selection and asset manifests for the available renditions.

Illustrate a space history lesson

Find Apollo 11 material, select records using their descriptions, and retrieve available files for a classroom presentation.

Prepare documentary research

Shortlist mission images, video, and audio, then collect download links for an editor to review alongside the source descriptions.

Build a mission anniversary exhibit

Research Space Shuttle or Apollo material and retrieve image renditions for exhibit planning, with source credits kept beside each selection.

Source illustrations for science reporting

Find media related to a mission covered in an article, review its description, and obtain the available files for editorial selection.

Create a browsable NASA media collection

Use search records to organize a subject collection and asset manifests to offer available downloads for selected items.

Refresh a museum's media shortlist

Repeat searches for Artemis or Mars exploration, identify previously unseen records, and retrieve their file manifests for curatorial review.

Questions about NASA media search in VS Code

Can VS Code use NASA media search?

Yes. Add Spiral to VS Code as an MCP server, and VS Code can find and run NASA media search like any built-in tool.

How much does NASA media search cost in VS Code?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your VS Code plan is separate.

Do I need an Alexandria account to use NASA media search in VS Code?

No. Spiral runs NASA media 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 media search in VS Code?

About two minutes: add the hosted server, then sign in.

Does VS Code wait while NASA media search runs?

NASA media search runs in the background. VS Code starts the run, checks on it and gives you the json when it's ready.

Does the library contain every NASA image, video, and recording?

No. NASA explicitly describes it as a selection of publicly available material rather than a comprehensive archive, so an absent item does not establish that NASA has no such media.

Are additions always newly created media?

No. NASA continually adds both new and archival material, so a newly added item can document a much older event.

Are downloads limited to preview images?

No. The library offers multiple download resolutions, and NASA's documented asset manifest includes an original image alongside smaller renditions.

Can schools and publishers reuse NASA media?

NASA generally permits educational and informational use under its media guidelines. Its content generally is not subject to copyright in the United States, but that statement is not a blanket clearance for every item.

Is everything in the library NASA-owned material?

No. NASA sometimes publishes third-party copyrighted material and identifies the copyright holder. Reusing those items requires permission from that holder.

Get started

Start using NASA media search in VS Code

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into VS Code:

Set up VS Code

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