[Integrations](https://spiral.ai/integrations) › [Cursor](https://spiral.ai/integrations/cursor) › [NASA media search](https://spiral.ai/integrations/cursor/nasa-media-search)

# How to Use NASA media search in Cursor

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.

|  |  |
| --- | --- |
| Model | NASA media search |
| Available through | Alexandria |
| Category | News & Media |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with NASA media search in Cursor

- 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 Cursor

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

### Use Spiral's MCP server

1. **Add the hosted server**: Use Add to Cursor on the console's Agents & MCP page, or add this to `.cursor/mcp.json` (one project) or `~/.cursor/mcp.json` (every project):

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.spiral.ai/mcp" }
  }
}
```

2. **Sign in**: Open Cursor Settings › MCP, click Connect next to spiral, sign in to Spiral and click Authorize. No API key. Spiral then shows as connected, with its tools listed.

### Use the Spiral skill

1. **Send Cursor 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.

```bash
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.

```bash
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: Cursor finds NASA media search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/cursor

## NASA media search tools and prices

- [NASA Image and Video Library · Search media](https://spiral.ai/tools/alexandria/images-nasa-gov/media/search_media) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| q |  | — | Free-text search over all metadata, e.g. rocket launch, countdown, mission control. |
| url |  | — | A pasted images.nasa.gov/search or images-api.nasa.gov/search URL; its filters apply and explicit inputs override them. |
| album |  | — | Album name, e.g. SpaceX_Roman_Space_Telescope (lists an album filtered by media_type). |
| title |  | — | Terms to match in titles. |
| center |  | — | Publishing NASA center code: KSC, JSC, GSFC, JPL, HQ, MSFC, ARC, AFRC, GRC, LaRC, SSC. |
| nasa_id |  | — | Exact NASA id. |

## What can you do with NASA media search in Cursor?

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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Cursor guides](https://spiral.ai/integrations/cursor)

## NASA media search in other agents

- [Amp](https://spiral.ai/integrations/amp/nasa-media-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/nasa-media-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/nasa-media-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/nasa-media-search)
- [Cline](https://spiral.ai/integrations/cline/nasa-media-search)
- [Codex](https://spiral.ai/integrations/codex/nasa-media-search)
- [Devin](https://spiral.ai/integrations/devin/nasa-media-search)
- [dots](https://spiral.ai/integrations/dots/nasa-media-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/nasa-media-search)
- [Gemini](https://spiral.ai/integrations/gemini/nasa-media-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/nasa-media-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/nasa-media-search)
- [goose](https://spiral.ai/integrations/goose/nasa-media-search)
- [Grok](https://spiral.ai/integrations/grok/nasa-media-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/nasa-media-search)
- [Hermes](https://spiral.ai/integrations/hermes/nasa-media-search)
- [Instinct](https://spiral.ai/integrations/instinct/nasa-media-search)
- [Manus](https://spiral.ai/integrations/manus/nasa-media-search)
- [Muse](https://spiral.ai/integrations/muse/nasa-media-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/nasa-media-search)
- [n8n](https://spiral.ai/integrations/n8n/nasa-media-search)
- [Notion](https://spiral.ai/integrations/notion/nasa-media-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/nasa-media-search)
- [opencode](https://spiral.ai/integrations/opencode/nasa-media-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/nasa-media-search)
- [Raycast](https://spiral.ai/integrations/raycast/nasa-media-search)
- [VS Code](https://spiral.ai/integrations/vscode/nasa-media-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/nasa-media-search)
- [Zapier](https://spiral.ai/integrations/zapier/nasa-media-search)

## More Cursor guides

- [NASA media files](https://spiral.ai/integrations/cursor/nasa-media-files)
- [NHPR article](https://spiral.ai/integrations/cursor/nhpr-article)
- [NASA 3D model search](https://spiral.ai/integrations/cursor/nasa-3d-model-search)
- [NHPR latest stories](https://spiral.ai/integrations/cursor/nhpr-latest-stories)
- [NASA 3D model details](https://spiral.ai/integrations/cursor/nasa-3d-model-details)
- [NHPR news search](https://spiral.ai/integrations/cursor/nhpr-news-search)

## Questions about NASA media search in Cursor

**Can Cursor use NASA media search?**

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

**How much does NASA media search cost in Cursor?**

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

**Do I need an Alexandria account to use NASA media search in Cursor?**

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 Cursor?**

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

**Does Cursor wait while NASA media search runs?**

NASA media search runs in the background. Cursor 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.

