How to Use NASA media search in Codex
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 Codex
Copy an example into Codex, 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.
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 Codex
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
codex mcp add spiral --url https://api.spiral.ai/mcp
- Sign in
Codex opens the browser: sign in to Spiral and click Authorize. No API key. codex mcp list then shows Spiral.
codex mcp login spiral
Use the Spiral skill
- Send Codex 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 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: Codex 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.
Settings you can ask for
Ask Codex for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Year end | 1900 to 2100 | year_end | |
| Page size | 1 to 50 | 10 | page_size |
| Media type | audio, image, video, or all | audio | Media type to return; defaults to audio. |
| Year start | 1900 to 2100 | year_start | |
| Include files | on 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 Codex?
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.
More on NASA media search and Codex
Overview
NASA media search in other agents
Questions about NASA media search in Codex
Can Codex use NASA media search?
Yes. Add Spiral to Codex as an MCP server, and Codex can find and run NASA media search like any built-in tool.
How much does NASA media search cost in Codex?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Codex plan is separate.
Do I need an Alexandria account to use NASA media search in Codex?
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 Codex?
About two minutes: add the hosted server, then sign in.
Does Codex wait while NASA media search runs?
NASA media search runs in the background. Codex 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.
Start using NASA media search in Codex
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Codex:
set up https://spiral.ai/SKILL.md


