> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to NASA

The NASA connector lets your AI agent act in each user's NASA account. Each user connects their own NASA API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 18 tools.

**Authentication:** API Key
**Categories:** Search
**Tools:** 18: 18 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=NASA)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the NASA connection

   In **AgentKit > Connections**, create a NASA connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'nasa'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize NASA:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'nasa_apod_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "nasa"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize NASA:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="nasa_apod_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their NASA credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'nasa_apod_get',
  toolInput: {},
  connector: 'nasa',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="nasa_apod_get",
    tool_input={},
    connection_name="nasa",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `nasa_apod_get`

Get Astronomy Picture of the Day · Read-only

Get NASA's Astronomy Picture of the Day for a date, a date range or a random selection.
Returns the APOD (or an array) with date, title, explanation, media_type, url, hdurl, credit and copyright.
Use nasa_apod_get for the daily astronomy image and its explanation. Set only one of date, start_date/end_date or count.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `count` (`integer`, optional): Return this many randomly chosen APODs, up to 25. Do not combine with date or a range. Example: 5.
- `date` (`string`, optional): Date of the APOD to get (YYYY-MM-DD). Defaults to today. Do not combine with start_date or count. Example: 2026-09-11.
- `end_date` (`string`, optional): End of the date range (YYYY-MM-DD), used with start_date. Defaults to today. Example: 2026-09-07.
- `start_date` (`string`, optional): Start of a date range (YYYY-MM-DD). Do not combine with date or count. Example: 2026-09-01.

Example input: `{}`

### `nasa_donki_cme_analysis_list`

List CME Analyses · Read-only

List coronal mass ejection analyses from NASA's DONKI space weather database for a date range.
Returns an array of CME analyses with time21_5, latitude, longitude, halfAngle, speed, type and catalog.
Use nasa_donki_cme_analysis_list for coronal mass ejection analyses history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `catalog` (`string`, optional): Catalog to search. Defaults to ALL. Example: ALL. One of: `ALL`, `SWRC_CATALOG`, `JANG_ET_AL_CATALOG`.
- `complete_entry_only` (`boolean`, optional): Only complete entries. Defaults to true. Example: true.
- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `half_angle` (`integer`, optional): Minimum half angle in degrees. Defaults to 0. Example: 30.
- `keyword` (`string`, optional): Keyword to filter by, for example swpc_annex. Defaults to none. Example: swpc_annex.
- `most_accurate_only` (`boolean`, optional): Only the most accurate analysis of each CME. Defaults to true. Example: true.
- `speed` (`integer`, optional): Minimum CME speed in km/s. Defaults to 0. Example: 500.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_cme_list`

List Coronal Mass Ejections · Read-only

List coronal mass ejections (CMEs) from NASA's DONKI space weather database for a date range.
Returns an array of CMEs with activityID, startTime, sourceLocation, instruments, cmeAnalyses and linkedEvents.
Use nasa_donki_cme_list for coronal mass ejections (CMEs) history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_flr_list`

List Solar Flares · Read-only

List solar flares from NASA's DONKI space weather database for a date range.
Returns an array of flares with flrID, beginTime, peakTime, endTime, classType (for example X1.2), sourceLocation and activeRegionNum.
Use nasa_donki_flr_list for solar flares history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_gst_list`

List Geomagnetic Storms · Read-only

List geomagnetic storms from NASA's DONKI space weather database for a date range.
Returns an array of storms with gstID, startTime, allKpIndex (Kp values and sources) and linkedEvents.
Use nasa_donki_gst_list for geomagnetic storms history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_hss_list`

List High Speed Streams · Read-only

List high speed solar wind streams from NASA's DONKI space weather database for a date range.
Returns an array of streams with hssID, eventTime, instruments and linkedEvents.
Use nasa_donki_hss_list for high speed solar wind streams history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_ips_list`

List Interplanetary Shocks · Read-only

List interplanetary shocks from NASA's DONKI space weather database for a date range.
Returns an array of shocks with activityID, catalog, location, eventTime, instruments and linkedEvents.
Use nasa_donki_ips_list for interplanetary shocks history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `catalog` (`string`, optional): Catalog to search. Defaults to all. Example: SWRC_CATALOG. One of: `SWRC_CATALOG`, `WINSLOW_MESSENGER_ICME_CATALOG`.
- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `location` (`string`, optional): Where the shock was observed. Defaults to all locations. Example: Earth. One of: `Earth`, `MESSENGER`, `STEREO A`, `STEREO B`.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_mpc_list`

List Magnetopause Crossings · Read-only

List magnetopause crossings from NASA's DONKI space weather database for a date range.
Returns an array of crossings with mpcID, eventTime, instruments and linkedEvents.
Use nasa_donki_mpc_list for magnetopause crossings history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_notifications_list`

List Space Weather Notifications · Read-only

List space weather notifications and reports issued by NASA's Space Weather Research Center, for a range of up to 30 days.
Returns an array of notifications with messageType, messageID, messageURL, messageIssueTime and messageBody.
Use nasa_donki_notifications_list for forecaster alerts; use the other nasa_donki_*_list tools for event data.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 7 days before today. Example: 2026-10-01.
- `type` (`string`, optional): Notification type. Defaults to all. Example: all. One of: `all`, `FLR`, `SEP`, `CME`, `IPS`, `MPC`, `GST`, `RBE`, `report`.

Example input: `{}`

### `nasa_donki_rbe_list`

List Radiation Belt Enhancements · Read-only

List radiation belt enhancements from NASA's DONKI space weather database for a date range.
Returns an array of enhancements with rbeID, eventTime, instruments and linkedEvents.
Use nasa_donki_rbe_list for radiation belt enhancements history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_sep_list`

List Solar Energetic Particle Events · Read-only

List solar energetic particle (SEP) events from NASA's DONKI space weather database for a date range.
Returns an array of SEP events with sepID, eventTime, instruments and linkedEvents.
Use nasa_donki_sep_list for solar energetic particle (SEP) events history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_donki_wsa_enlil_simulations_list`

List WSA-Enlil Simulations · Read-only

List WSA-Enlil solar wind model simulations from NASA's DONKI space weather database for a date range.
Returns an array of simulations with simulationID, modelCompletionTime, cmeInputs, estimatedShockArrivalTime and impactList.
Use nasa_donki_wsa_enlil_simulations_list for WSA-Enlil solar wind model simulations history; use nasa_donki_notifications_list for forecaster alerts across all event types.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, optional): End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
- `start_date` (`string`, optional): Start date (YYYY-MM-DD, UTC). Defaults to 7 days before today. Example: 2026-10-01.

Example input: `{}`

### `nasa_epic_dates_list`

List EPIC Image Dates · Read-only

List every date with EPIC images in a collection.
Returns an array of {date}.
Use nasa_epic_dates_list before nasa_epic_images_by_date_get.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection` (`string`, required): EPIC image collection: natural (true color), enhanced (color-corrected), aerosol or cloud. Example: natural. One of: `natural`, `enhanced`, `aerosol`, `cloud`.

Example input: `{"collection":"natural"}`

### `nasa_epic_images_by_date_get`

Get EPIC Images by Date · Read-only

Get metadata for the full-disc Earth images taken by the DSCOVR EPIC camera on a date.
Returns an array of images with identifier, image name, caption, date and centroid_coordinates.
Use nasa_epic_images_by_date_get for a past date; check available dates with nasa_epic_dates_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection` (`string`, required): EPIC image collection: natural (true color), enhanced (color-corrected), aerosol or cloud. Example: natural. One of: `natural`, `enhanced`, `aerosol`, `cloud`.
- `date` (`string`, required): Date of the images (YYYY-MM-DD). Example: 2026-10-30.

Example input: `{"collection":"natural","date":"<date>"}`

### `nasa_epic_images_latest_get`

Get Latest EPIC Images · Read-only

Get metadata for the most recent day of full-disc Earth images from the DSCOVR EPIC camera.
Returns an array of images with identifier, image name, caption, date, centroid_coordinates and spacecraft, moon and sun positions.
Use nasa_epic_images_latest_get for today's Earth images. Build the image URL from the date and image name as https://api.nasa.gov/EPIC/archive/<collection>/<YYYY>/<MM>/<DD>/png/<image>.png.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `collection` (`string`, required): EPIC image collection: natural (true color), enhanced (color-corrected), aerosol or cloud. Example: natural. One of: `natural`, `enhanced`, `aerosol`, `cloud`.

Example input: `{"collection":"natural"}`

### `nasa_neo_browse_list`

Browse Near-Earth Objects · Read-only

Page through the full near-Earth object dataset.
Returns page info and near_earth_objects with id, name, diameter, hazard flag and orbital data.
Use nasa_neo_browse_list to scan the catalogue. Use nasa_neo_feed_get for upcoming approaches.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page` (`integer`, optional): Page number, starting at 0. Example: 0.
- `size` (`integer`, optional): Objects per page, up to 20. Example: 20.

Example input: `{}`

### `nasa_neo_feed_get`

Get Near-Earth Object Feed · Read-only

List near-Earth asteroids by their closest approach date to Earth, for a range of up to 7 days.
Returns element_count and near_earth_objects keyed by date, each with id, name, estimated diameter, is_potentially_hazardous_asteroid and close_approach_data.
Use nasa_neo_feed_get for asteroids passing Earth in a week. Use nasa_neo_lookup_get for one asteroid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `start_date` (`string`, required): First date of the range (YYYY-MM-DD). Example: 2026-11-16.
- `end_date` (`string`, optional): Last date of the range (YYYY-MM-DD), at most 7 days after start_date. Defaults to 7 days after start_date. Example: 2026-11-20.

Example input: `{"start_date":"<start_date>"}`

### `nasa_neo_lookup_get`

Look Up Asteroid · Read-only

Get one asteroid by its NASA JPL small-body ID (SPK-ID).
Returns the asteroid with name, absolute magnitude, estimated diameter, hazard flag, orbital_data and every close approach.
Use nasa_neo_lookup_get after nasa_neo_feed_get or nasa_neo_browse_list for details on one asteroid.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `asteroid_id` (`string`, required): NASA JPL small-body SPK-ID of the asteroid. Example: 3542519.

Example input: `{"asteroid_id":"<asteroid_id>"}`

## Related

Other Search connectors ([all 89](/agentkit/connectors/?category=search)):

- [Supadata](/agentkit/connectors/supadata/): Scalekit connector, API key, 21 tools
- [Exa](/agentkit/connectors/exa/): Scalekit connector, API key, 21 tools
- [Brave Search](/agentkit/connectors/brave/): Scalekit connector, API key, 18 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
