natural-events-intel

Real-time natural events intelligence from NASA EONET - wildfires, floods, storms, volcanoes, and more. B2A optimized for emergency response agents, news aggregators, and risk assessment.

8 Entrypoints
v1.0.0 Version
Enabled Payments

natural-events-intel-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 natural events - try before you buy

Pricing Invoke: 1

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://natural-events-intel-production.up.railway.app/entrypoints/overview/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {}
    }
  '

events-by-category

Invoke

Get active natural events by category (wildfires, floods, storms, etc)

Pricing Invoke: 1000

Network base

Invoke Endpoint POST /entrypoints/events-by-category/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "wildfires",
        "floods",
        "severeStorms",
        "volcanoes",
        "earthquakes",
        "drought",
        "dustHaze",
        "landslides",
        "snow",
        "seaLakeIce",
        "tempExtremes"
      ],
      "description": "Event category to filter"
    },
    "limit": {
      "default": 20,
      "description": "Max events to return",
      "type": "number"
    }
  },
  "required": [
    "category",
    "limit"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://natural-events-intel-production.up.railway.app/entrypoints/events-by-category/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "category": "wildfires",
        "limit": 0
      }
    }
  '

recent-events

Invoke

Get the most recent natural events across all categories

Pricing Invoke: 1000

Network base

Invoke Endpoint POST /entrypoints/recent-events/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "days": {
      "default": 7,
      "description": "Number of days to look back",
      "type": "number"
    },
    "limit": {
      "default": 25,
      "description": "Max events to return",
      "type": "number"
    }
  },
  "required": [
    "days",
    "limit"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://natural-events-intel-production.up.railway.app/entrypoints/recent-events/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "days": 0,
        "limit": 0
      }
    }
  '

event-details

Invoke

Get detailed information about a specific event by ID

Pricing Invoke: 2000

Network base

Invoke Endpoint POST /entrypoints/event-details/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "eventId": {
      "type": "string",
      "description": "NASA EONET event ID"
    }
  },
  "required": [
    "eventId"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://natural-events-intel-production.up.railway.app/entrypoints/event-details/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "eventId": "<NASA EONET event ID>"
      }
    }
  '

events-by-region

Invoke

Search for natural events within a geographic bounding box

Pricing Invoke: 2000

Network base

Invoke Endpoint POST /entrypoints/events-by-region/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "north": {
      "type": "number",
      "description": "North latitude boundary (-90 to 90)"
    },
    "south": {
      "type": "number",
      "description": "South latitude boundary (-90 to 90)"
    },
    "east": {
      "type": "number",
      "description": "East longitude boundary (-180 to 180)"
    },
    "west": {
      "type": "number",
      "description": "West longitude boundary (-180 to 180)"
    },
    "limit": {
      "default": 20,
      "type": "number"
    }
  },
  "required": [
    "north",
    "south",
    "east",
    "west",
    "limit"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://natural-events-intel-production.up.railway.app/entrypoints/events-by-region/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "north": 0,
        "south": 0,
        "east": 0,
        "west": 0,
        "limit": 0
      }
    }
  '

full-report

Invoke

Comprehensive report of current natural events with statistics and breakdown

Pricing Invoke: 3000

Network base

Invoke Endpoint POST /entrypoints/full-report/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "days": {
      "default": 7,
      "description": "Number of days to analyze",
      "type": "number"
    }
  },
  "required": [
    "days"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://natural-events-intel-production.up.railway.app/entrypoints/full-report/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "days": 0
      }
    }
  '

analytics

Invoke

Payment analytics summary

Pricing Invoke: 1

Network base

Invoke Endpoint POST /entrypoints/analytics/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "windowMs": {
      "description": "Time window in ms",
      "type": "number"
    }
  },
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://natural-events-intel-production.up.railway.app/entrypoints/analytics/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "windowMs": 0
      }
    }
  '

analytics-transactions

Invoke

Recent payment transactions

Pricing Invoke: 1

Network base

Invoke Endpoint POST /entrypoints/analytics-transactions/invoke

Invoke

Input Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "windowMs": {
      "type": "number"
    },
    "limit": {
      "default": 50,
      "type": "number"
    }
  },
  "required": [
    "limit"
  ],
  "additionalProperties": false
}

Invoke with curl

curl -s -X POST \
  'https://natural-events-intel-production.up.railway.app/entrypoints/analytics-transactions/invoke' \
  -H 'Content-Type: application/json' \
  -d '
    {
      "input": {
        "limit": 0
      }
    }
  '

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…