Meteors

What Meteors MCP server does

The Meteors MCP server gives AI agents structured access to three types of space-object data: recent fireballs and atmospheric explosions, near-Earth asteroid close approaches, and near-Earth objects observed during a specified date range. The returned fields support basic event review and risk-oriented filtering, including energy, speed, altitude, location, miss distance, diameter, size, and hazard status where available.

Its data scope is aimed at questions such as which meteor events were recently detected, which asteroids will pass within a selected threshold, and which near-Earth objects are recorded between two dates. The listing identifies the fireball observations as detections from US government sensors and describes the asteroid information as NASA data.

Tools and capabilities

The Meteors MCP server exposes these tools:

• get_fireballs retrieves recent meteor impacts and atmospheric explosions. Results include impact energy, radiated energy, velocity, altitude, and geographic location.
• get_close_approaches finds near-Earth asteroids making approaches within 0.05 AU. Results can include the object name, approach date, miss distance, velocity, and diameter.
• get_neo_feed returns near-Earth objects passing Earth during a supplied date range, such as 2024-01-01 through 2024-12-31. Results include asteroid names, sizes, velocities, miss distances, and hazard status.

These tools are suitable for agent workflows that need to compare objects, summarize observations, or answer date- and distance-based questions. They do not imply prediction beyond the fields returned by the underlying data.

How it works

The hosted endpoint is https://gateway.pipeworx.io/meteors/mcp. An MCP client connects to that URL and discovers the available tools. A scoped gateway connection lists the three Meteors tools plus shared Pipeworx meta-tools, including routing and discovery functions. The exact tool scope is reported by the connection's initialize response and may be treated as authoritative for that session.

The same gateway also has a full endpoint at https://gateway.pipeworx.io/mcp. The hosted Meteors endpoint and the full endpoint reach the same gateway and data sources; the difference is which pack tools are listed directly. The gateway's ask_pipeworx function can route a natural-language request to tools across the catalog from either endpoint.

Meteors MCP server tools can also be called without an MCP client through the gateway's HTTP tool interface. For example, POST https://gateway.pipeworx.io/v1/tools/get_fireballs accepts JSON input.

Setup and configuration

For a hosted connection, add the gateway URL to an MCP client's server configuration:

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

The README names Claude Desktop, Cursor, and Windsurf as compatible client examples. It states that initial gateway calls do not require an account.

For local use, run the package as a stdio server with npx:

{
  "mcpServers": {
    "meteors": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-meteors"]
    }
  }
}

Running npx -y @pipeworx/mcp-meteors directly starts the process for a basic launch check. The local process communicates over stdin and stdout and exposes only the three pack tools, without gateway meta-tools or ask_pipeworx routing.

Limitations and notes

The gateway and local modes differ in their discovered tool sets. Gateway connections add shared Pipeworx schemas, which can increase context usage; the local package avoids those additional tools but does not provide cross-catalog routing. The documentation does not specify authentication settings, custom environment variables, rate limits, or data refresh intervals.

The close-approach query is explicitly limited to objects within 0.05 AU, while the NEO feed requires a date range. Consumers should handle the returned measurements as source data rather than treating the tool as an independent hazard assessment system.

The Meteors MCP server is released under the MIT license.