`get_fireballs`

Pack: meteors · Endpoint: https://gateway.pipeworx.io/meteors/mcp

Track recent meteor impacts and atmospheric explosions detected by US government sensors. Returns impact energy, radiated energy, velocity, altitude, and geographic location.

Parameters

Name	Type	Required	Description
`limit`	number	no	Maximum number of fireball events to return (default 10, max 100).

Example call

Arguments

{
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/meteors/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_fireballs","arguments":{"limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('get_fireballs', {
  "limit": 10
});

More examples

{
  "limit": 50
}

Response shape

Always returns: count, fireballs

Field	Type	Description
`count`	integer	Total number of fireball events returned
`fireballs`	array	Array of fireball event records

Full JSON Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "description": "Total number of fireball events returned"
    },
    "fireballs": {
      "type": "array",
      "description": "Array of fireball event records",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Date of the fireball event"
          },
          "energy_GJ": {
            "type": [
              "number",
              "null"
            ],
            "description": "Impact energy in gigajoules"
          },
          "radiated_energy_J": {
            "type": [
              "number",
              "null"
            ],
            "description": "Radiated energy in joules"
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Latitude of the impact location"
          },
          "latitude_dir": {
            "type": [
              "string",
              "null"
            ],
            "description": "Latitude direction (N/S)"
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Longitude of the impact location"
          },
          "longitude_dir": {
            "type": [
              "string",
              "null"
            ],
            "description": "Longitude direction (E/W)"
          },
          "altitude_km": {
            "type": [
              "number",
              "null"
            ],
            "description": "Altitude of the event in kilometers"
          },
          "velocity_km_s": {
            "type": [
              "number",
              "null"
            ],
            "description": "Velocity of the fireball in km/s"
          }
        }
      }
    }
  },
  "required": [
    "count",
    "fireballs"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "meteors": {
      "url": "https://gateway.pipeworx.io/meteors/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

get_fireballs