solar-storm-agent

Real-time space weather data from NOAA: solar storms, aurora forecasts, Kp index, and geomagnetic alerts. Essential for HAM radio, satellite ops, GPS, aviation, and aurora hunters.

  • 6 Entrypoints
  • v1.0.0 Version
  • Enabled Payments
solar-storm-agent-production.up.railway.app
View Manifest List Entrypoints

Entrypoints

Explore the capabilities exposed by this agent. Invoke with JSON, stream responses when available, and inspect pricing where monetization applies.

overview

Invoke

Free overview of current space weather conditions - try before you buy! Includes current Kp index and NOAA space weather scales.

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/overview/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://solar-storm-agent-production.up.railway.app/entrypoints/overview/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

kp-index

Invoke

Real-time planetary Kp index with historical data. The Kp index measures geomagnetic activity (0-9 scale). Essential for radio propagation, GPS accuracy, and aurora visibility.

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/kp-index/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "minutes": {
      "default": 60,
      "description": "Minutes of historical data (1-1440)",
      "type": "number",
      "minimum": 1,
      "maximum": 1440
    }
  },
  "required": [
    "minutes"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://solar-storm-agent-production.up.railway.app/entrypoints/kp-index/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "minutes": 1
      }
    }
  '

solar-cycle

Invoke

Solar cycle indices including sunspot numbers and F10.7 solar flux. Track the 11-year solar cycle and predict space weather trends.

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/solar-cycle/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "months": {
      "default": 12,
      "description": "Months of historical data (1-120)",
      "type": "number",
      "minimum": 1,
      "maximum": 120
    }
  },
  "required": [
    "months"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://solar-storm-agent-production.up.railway.app/entrypoints/solar-cycle/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "months": 1
      }
    }
  '

alerts

Invoke

Active space weather alerts and warnings from NOAA. Includes geomagnetic storm watches, solar radiation warnings, and radio blackout alerts.

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/alerts/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "description": "Maximum number of alerts",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "limit"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://solar-storm-agent-production.up.railway.app/entrypoints/alerts/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "limit": 1
      }
    }
  '

aurora

Invoke

Aurora visibility forecast based on current geomagnetic conditions. Includes viewing probability by latitude and best viewing times.

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/aurora/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "latitude": {
      "description": "Your latitude for personalized forecast",
      "type": "number",
      "minimum": -90,
      "maximum": 90
    }
  },
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://solar-storm-agent-production.up.railway.app/entrypoints/aurora/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "latitude": -90
      }
    }
  '

report

Invoke

Comprehensive space weather report combining all data sources: Kp index, solar cycle, alerts, aurora forecast, and NOAA scales. Perfect for daily briefings.

Pricing Free
Network base
Invoke Endpoint POST /entrypoints/report/invoke
Invoke
Input Schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "includeHistory": {
      "default": true,
      "description": "Include historical data",
      "type": "boolean"
    }
  },
  "required": [
    "includeHistory"
  ],
  "additionalProperties": false
}
Invoke with curl 
curl -s -X POST \
  'https://solar-storm-agent-production.up.railway.app/entrypoints/report/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "includeHistory": true
      }
    }
  '

Client Example: x402-fetch

Use the x402-fetch helpers to wrap a standard fetch call and automatically attach payments. This script loads configuration from .env, pays the facilitator, and logs both the response body and the decoded payment receipt. 

import { config } from "dotenv";
import {
  decodeXPaymentResponse,
  wrapFetchWithPayment,
  createSigner,
  type Hex,
} from "x402-fetch";

config();

const privateKey = process.env.AGENT_WALLET_PRIVATE_KEY as Hex | string;
const agentUrl = process.env.AGENT_URL as string; // e.g. https://agent.example.com
const endpointPath = process.env.ENDPOINT_PATH as string; // e.g. /entrypoints/echo/invoke
const url = `${agentUrl}${endpointPath}`;

if (!agentUrl || !privateKey || !endpointPath) {
  console.error("Missing required environment variables");
  console.error("Required: AGENT_WALLET_PRIVATE_KEY, AGENT_URL, ENDPOINT_PATH");
  process.exit(1);
}

/**
 * Demonstrates paying for a protected resource using x402-fetch.
 *
 * Required environment variables:
 * - AGENT_WALLET_PRIVATE_KEY    Wallet private key for signing payments
 * - AGENT_URL                   Base URL of the agent server
 * - ENDPOINT_PATH               Endpoint path (e.g. /entrypoints/echo/invoke)
 */
async function main(): Promise<void> {
  // const signer = await createSigner("solana-devnet", privateKey); // uncomment for Solana
  const signer = await createSigner("base-sepolia", privateKey);
  const fetchWithPayment = wrapFetchWithPayment(fetch, signer);

  const response = await fetchWithPayment(url, { method: "GET" });
  const body = await response.json();
  console.log(body);

  const paymentResponse = decodeXPaymentResponse(
    response.headers.get("x-payment-response")!
  );
  console.log(paymentResponse);
}

main().catch((error) => {
  console.error(error?.response?.data?.error ?? error);
  process.exit(1);
});

Manifest

Loading… 
Fetching agent card…