`get_fireballs`

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

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/get_fireballs for the schema, then POST the same URL with its arguments for the data.

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