Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to NASA

Scalekit connector
Open markdown

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.

Tools
18
What they doRead · write · destructive
18 · 0 · 018 read0 write0 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

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

  4. Authorize a user and make your first call

    quickstart.mts
    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)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their NASA credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • nasa_apod_getGet NASA's Astronomy Picture of the Day for a date, a date range or a random selection.Read-only

    Get Astronomy Picture of the Day

    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.

    Inputs

    countinteger
    Return this many randomly chosen APODs, up to 25. Do not combine with date or a range. Example: 5.
    datestring
    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_datestring
    End of the date range (YYYY-MM-DD), used with start_date. Defaults to today. Example: 2026-09-07.
    start_datestring
    Start of a date range (YYYY-MM-DD). Do not combine with date or count. Example: 2026-09-01.
  • nasa_donki_cme_analysis_listList coronal mass ejection analyses from NASA's DONKI space weather database for a date range.Read-only

    List CME Analyses

    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.

    Inputs

    catalogstring
    Catalog to search. Defaults to ALL. Example: ALL.one of ALLSWRC_CATALOGJANG_ET_AL_CATALOG
    complete_entry_onlyboolean
    Only complete entries. Defaults to true. Example: true.
    end_datestring
    End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
    half_angleinteger
    Minimum half angle in degrees. Defaults to 0. Example: 30.
    keywordstring
    Keyword to filter by, for example swpc_annex. Defaults to none. Example: swpc_annex.
    most_accurate_onlyboolean
    Only the most accurate analysis of each CME. Defaults to true. Example: true.
    speedinteger
    Minimum CME speed in km/s. Defaults to 0. Example: 500.
    start_datestring
    Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.
  • nasa_donki_cme_listList coronal mass ejections (CMEs) from NASA's DONKI space weather database for a date range.Read-only

    List Coronal Mass Ejections

    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.

    Inputs

    end_datestring
    End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
    start_datestring
    Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.
  • nasa_donki_flr_listList solar flares from NASA's DONKI space weather database for a date range.Read-only

    List Solar Flares

    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.

    Inputs

    end_datestring
    End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
    start_datestring
    Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.
  • nasa_donki_gst_listList geomagnetic storms from NASA's DONKI space weather database for a date range.Read-only

    List Geomagnetic Storms

    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.

    Inputs

    end_datestring
    End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
    start_datestring
    Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.
  • nasa_donki_hss_listList high speed solar wind streams from NASA's DONKI space weather database for a date range.Read-only

    List High Speed Streams

    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.

    Inputs

    end_datestring
    End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
    start_datestring
    Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.
  • nasa_donki_ips_listList interplanetary shocks from NASA's DONKI space weather database for a date range.Read-only

    List Interplanetary Shocks

    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.

    Inputs

    catalogstring
    Catalog to search. Defaults to all. Example: SWRC_CATALOG.one of SWRC_CATALOGWINSLOW_MESSENGER_ICME_CATALOG
    end_datestring
    End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
    locationstring
    Where the shock was observed. Defaults to all locations. Example: Earth.one of EarthMESSENGERSTEREO ASTEREO B
    start_datestring
    Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.
  • nasa_donki_mpc_listList magnetopause crossings from NASA's DONKI space weather database for a date range.Read-only

    List Magnetopause Crossings

    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.

    Inputs

    end_datestring
    End date (YYYY-MM-DD, UTC). Defaults to today. Example: 2026-10-31.
    start_datestring
    Start date (YYYY-MM-DD, UTC). Defaults to 30 days before today. Example: 2026-10-01.