meteor-mcp
Provides access to recent fireball data from NASA's CNEOS API, allowing users to query fireball events.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@meteor-mcp Can we work the Perseids from FN42 to EM10 tonight?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
meteor-mcp
Meteor scatter planning for amateur radio: can these two stations work each other on this shower, and when.
That is the whole shape of it. Meteor scatter is a point-to-point mode, so a radiant elevation on its own tells an operator nothing they can act on—the question is always about a path between two stations.
Part of the qso-graph project.
What decides a meteor-scatter contact
Three things, and radiant elevation is only one of them.
1. Path length. Trails burn at about 85–120 km, so a single-hop reflection off something that low works from roughly 400 km to about 2300 km. Shorter and the reflection point would have to be nearly overhead, where there is very little qualifying sky; longer and it sits below both horizons. 800–2000 km is where the geometry is best, and it is what hams actually run.
2. Radiant elevation at the path midpoint—not at either station. The reflection happens near the middle, so that is the sky that matters. Below the horizon there are no trails to reflect from. Very high is also poor, because trails then run down the path rather than across it.
3. The angle between the radiant and the path. This is the one usually left out, and it is the one that decides whether a reflection is geometrically possible at all. A trail reflects specularly only where it is tangent to the ellipsoid with both stations at its foci. Trails running along the path can never be tangent to it; trails running across it can. So a radiant broadside to the path is good and a radiant up- or down-path is poor—at the very same elevation.
All three are reported, and the verdict says which one decided it.
Why there is no score out of a hundred
Because the physics above is a tangency condition, and what a station actually hears also
depends on its power, its antenna and the sporadic background. A figure like "73" would
imply a precision none of that supports. So the answer is no / marginal / good /
best, each with the reason beside it.
Related MCP server: NOAA Space Weather MCP Server
Where the numbers come from
Shower radiants, numbers and names are the IAU Meteor Data Center's—the body that
names and numbers meteor showers. The package carries the facts read from the MDC's
Established showers file with its URL and SHA-256 recorded, so the exact edition served
is identifiable. The MDC is maintained on an unpaid voluntary basis and asks to be cited;
its requested references are returned by meteor_source_info, printed in
NOTICE, and travel inside every answer that uses a radiant.
The MDC lists several published solutions per shower, each from a different study.
All of them are kept and none is blended—the average of two published radiants is a
third that nobody published and no paper stands behind. Tools return the first-listed
solution, labelled, and meteor_shower_info gives them all.
Peaks are stored as solar longitude, not as dates, because that is how the catalog publishes them and it is the right way round: solar longitude names the same point in the stream every year, while a date drifts. This server converts it to the date it falls on in the year you ask about.
Two tools read the network, because only those two report what is happening right now:
Source | Used for | License |
Confirmed meteor counts today, by shower | CC BY 4.0—attribution is a license condition, and is returned in the answer | |
Recent fireballs | US government work |
Everything else is computed locally and needs no network at all.
Your own end comes from your station profile
meteor_window needs both ends of the path, but you should not have to retype your own.
Your end is optional, and a host that knows the operator's station supplies it—in QG
Desktop that is the Station component.
The fields are ADIF's, not invented here:
ADIF field | Used for |
| The default grid. ADIF permits 2, 4, 6 or 8 characters |
| Characters 9–12 of a 10- or 12-character locator |
| An exact position, when the station has one |
A grid is what hams actually use, so a locator is the normal input here, not a degraded one. It may carry 4, 6 or 8 characters. Operators often state 6 or 8 for their own station, while a structured on-air exchange may carry only 4. Which modes constrain it is not asserted here: ADIF enumerates every mode and submode but says nothing about payload length, so there is no authority to infer precision from mode—4 is the safe floor for all of them.
A grid square is a rectangle, though, and its center is all a locator gives. Nothing here assumes a precision: the slack is computed from the characters each locator actually carried. At 4 characters that is about ±100 km per end, so a path length carries about ±200 km of slack; at 6 it falls to a few km. That is immaterial on a 1100 km path and decisive against a threshold—a path reported as 2250 km could be 2050 to 2450, which straddles the 2300 km single-hop limit. When a limit falls inside that slack the answer says the call cannot be decided at on-air precision, and what would settle it. The slack is reported either way.
So MY_LAT/MY_LON are used when a station has them, and the answer always says which it
used and how precisely each end was located.
A 2-character MY_GRIDSQUARE is a legitimate ADIF value but is refused for a path: a
Maidenhead field is 10 by 20 degrees, around 1100 km across, which is wider than the
entire usable meteor-scatter range. The refusal explains the precision rather than calling
the locator invalid, because it isn't.
Home, portable, and remote all work the same way
ADIF's location fields describe the transmitting station, not where the operator is
sitting—MY_LAT is "the logging station's latitude." That is what makes a remote
operation come out right without a special case: the reflection geometry depends on where
the antenna is. ADIF separates the three callsigns for exactly this reason —
STATION_CALLSIGN (used over the air), OPERATOR (the person), and OWNER_CALLSIGN
("the callsign of the OPERATOR's host").
So operating a remote station in FN42 from a chair in DN13 gives the FN42 path, and the operator's own location never enters the calculation.
Install
uvx meteor-mcp # run it; nothing to installNo credentials, no accounts, no configuration.
Tools
Tool | Description |
| Start here. Two grid squares in, and the path, the shower, and the hour-by-hour geometry out |
| Which showers are near their peak now, closest first, with the peak date |
| Every published solution for one shower, unaveraged |
| How many meteors the Global Meteor Network has confirmed today, by shower (reads the network) |
| Recent fireballs from NASA CNEOS (reads the network) |
| Where every number comes from, the edition checksum, and how to cite it |
| Service version and the catalog edition carried |
A count is not a flux
meteor_activity returns the number of confirmed trajectories the Global Meteor
Network has recorded today, broken down by IAU shower code. That is not a flux density—meteoroids per square kilometer per hour, corrected for camera coverage and limiting
magnitude—which is a different quantity GMN computes separately. The tool is named and
documented for what it actually returns. GMN writes the file during the day, so an early
read covers a partial day; the generation time comes back with the answer.
Quick Start
Configure your MCP client
meteor-mcp works with any MCP-compatible client. Add the server config and restart.
Claude Desktop
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS,
%APPDATA%\Claude\ on Windows):
{
"mcpServers": {
"meteor": {
"command": "uvx",
"args": ["meteor-mcp"]
}
}
}Claude Code
Add to .claude/settings.json:
{
"mcpServers": {
"meteor": {
"command": "uvx",
"args": ["meteor-mcp"]
}
}
}ChatGPT Desktop
Configure via Settings > Apps & Connectors, or in your agent definition:
{
"mcpServers": {
"meteor": {
"command": "uvx",
"args": ["meteor-mcp"]
}
}
}Questions it answers
"Can I work EM12 from DN13 on the Perseids tonight, and when?"
"Which meteor showers are near their peak this week?"
"Is the radiant going to be broadside to my path or up it?"
"Is 2100 km too far for single-hop meteor scatter?"
"How many meteors has the Global Meteor Network actually seen today?"
"Show me every published radiant for the Geminids, not an average."
"Were there any fireballs this week?"
Pointing
Point both antennas near the path bearing, not at the radiant. The reflection happens near the path midpoint; the radiant's position decides whether a trail there can be tangent to your path, not where to aim.
License
GPL-3.0-or-later. See LICENSE.
Available Tools
7 toolsget_version_infoGet Version InfoBRead-onlyIdempotent
This server's version and the edition of the shower list it carries.
Inputs: no named parameters. Returns: object
meteor_activityMeteor ActivityARead-onlyIdempotent
How many meteors the Global Meteor Network has actually confirmed today.
A count of observed trajectories broken down by shower — not a flux density, which is a different quantity GMN computes separately. The file is written during the day, so an early read covers a partial day; the generation time is in the answer.
This reads the network. Attribution is a condition of GMN's CC BY 4.0 licence and is carried in the result.
Inputs: no named parameters. Returns: object
meteor_fireballsMeteor FireballsARead-onlyIdempotent
Recent fireballs recorded by NASA CNEOS.
Bolides bright enough to be detected from orbit — the "did anyone else see that" events, not a meteor rate. Reads the network.
Inputs: limit. Returns: object
meteor_shower_infoMeteor Shower InfoARead-onlyIdempotent
Every published solution for one shower, unaveraged.
The MDC carries several solutions per shower, each from a different study, with slightly different radiants and speeds. All of them are returned. None is blended, because the average of two published radiants is a third that nobody published and no paper stands behind.
Inputs: shower (required). Returns: object
meteor_showersMeteor ShowersARead-onlyIdempotent
Which showers are near their peak, closest first.
The IAU MDC publishes each maximum as a solar longitude rather than a date, because solar longitude names the same point in the stream every year while a date drifts. The longitude is converted here to the date it falls on in the year asked about.
Inputs: when, limit. Returns: object
meteor_source_infoMeteor Source InfoARead-onlyIdempotent
Where every number in this server comes from, and how to cite it.
The shower list is the IAU Meteor Data Center's, carried in the package with its checksum so the exact edition served is identifiable. The live sources are named with their licences. Nothing here is this project's own measurement, and the citations are the owners' own.
Inputs: no named parameters. Returns: object
meteor_windowMeteor WindowARead-onlyIdempotent
When two stations can work each other by meteor scatter, and why.
Give both grid squares. The answer covers the path itself (is it even a meteor-scatter distance), which shower is in play, and then hour by hour whether the geometry can reflect — reported as no / marginal / good / best with the reason that decided it.
Three things decide it, and radiant elevation is only one: the path length, the radiant's elevation at the path midpoint (where the reflection happens, not at either station), and the angle between the radiant and the path. That last one is the one usually left out and the one that makes a reflection geometrically possible at all — a trail reflects only where it is tangent to the ellipsoid with both stations at its foci, so a radiant broadside to the path works and one up- or down-path does not, at the very same elevation.
Your own end can be left out when the host supplies it from the operator's
station profile — ADIF's MY_GRIDSQUARE, or MY_LAT and MY_LON when the
exact position is known. Those fields describe the transmitting station,
not where the operator is sitting, which is what makes a remote operation
come out right: the reflection geometry depends on where the antenna is.
Inputs: when, hours, my_lat, my_lon, +6 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools occupy clearly distinct slots: geometry forecast (meteor_window), shower list (meteor_showers), per-shower details (meteor_shower_info), live counts (meteor_activity), and fireballs (meteor_fireballs). The only real fuzziness is between meteor_source_info and get_version_info, since both speak to provenance and the shower-list edition, and meteor_showers vs meteor_shower_info require reading singular/plural carefully.
Six of seven tools follow a consistent meteor_<noun> namespacing scheme that reads predictably. get_version_info breaks the pattern by switching to verb_noun form, a minor but visible deviation.
Seven tools is well within the sweet spot and each maps to a distinct information need in the meteor-scatter domain. Nothing appears padded or redundant.
The surface covers forecast geometry, shower catalogs and details, live observed activity, fireballs, citations, and versioning — a full lifecycle for a meteor-scatter planning workflow. Minor gaps remain, such as looking up showers by date range or solar longitude beyond what meteor_showers returns, but agents can work around these via meteor_shower_info.
Maintenance
Related MCP Connectors
Amateur radio MCP server with band plans, EIRP, cable loss, antenna gains, and more
Meteors MCP — NASA fireball, near-Earth asteroid, and close approach data
Live stargazing forecasts: per-night sky scores, dark-sky sites, aurora & light pollution anywhere.
Offline observational astronomy: positions, rise/set, moon phases, eclipses, and seasons.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables satellite orbital mechanics calculations including visibility predictions, access window analysis, and TLE generation from natural language descriptions. Supports 200+ world cities and multiple orbit types (LEO, MEO, GEO, SSO, Molniya, Polar).-
- AlicenseNot gradedqualityDmaintenanceProvides real-time NOAA space weather data (solar flares, Kp index, solar wind) and analyzes HF radio propagation conditions for amateur radio operators to determine optimal frequency bands.MIT
- AlicenseAqualityAmaintenanceMCP server for space weather and HF propagation conditions — live solar flux, Kp index, DSCOVR solar wind, X-ray flux, alerts, 27-day forecast, and band-by-band outlook through any MCP-compatible AI assistant.776 PyPI4GPL 3.0
- AlicenseAqualityCmaintenanceMCP server that exposes NOAA/SWPC HF band-condition and space-weather tools, providing real-time solar indices, band conditions, forecasts, alerts, solar wind, and X-ray flux for ham radio operators.69 npmMIT