io.github.davidmosiah/uap-pulse
Search and map the Pentagon UAP/UFO releases plus curated official archives from 12 nations.
Open source Open in the app JSON README (API)
About
Search and map the Pentagon UAP/UFO releases plus curated official archives from 12 nations.
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- davidmosiah
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.4.0
- Last push
- 2026-08-29T10:43:23Z
- Repository state
- ativo
- Language
- HTML
- License
- MIT
- Added
- 2026-08-29 03:02:41
- Updated
- 2026-08-29 03:02:41
- Origin id
io.github.davidmosiah/uap-pulse
README
# 🛸 uap-pulse
**An MCP server (and a live map) for the Pentagon's declassified UAP files.**
On **July 10, 2026**, the U.S. Department of War published **PURSUE Release 04** on [war.gov/UFO](https://www.war.gov/UFO/). `uap-pulse` now bundles all four releases: **334 U.S. records**, plus 16 curated official-government cases from 12 nations — **350 records total**, spanning **1944–2026**.
> **Official sources only.** U.S. PURSUE records are public domain under 17 U.S.C. § 105. The international layer links to official national archives; rights remain with each originating source. No scraped civilian databases. Not affiliated with or endorsed by any government.
🗺️ **Live map:** https://uap-pulse.vercel.app · 📦 **npm:** `uap-pulse`
---
## Use it as an MCP server
Your agent can search all 350 records by release, location, agency, era, or type — and pull the direct official source link for each.
**Claude Desktop / any MCP client** — add to your config:
```json
{
"mcpServers": {
"uap-pulse": { "command": "npx", "args": ["-y", "uap-pulse"] }
}
}
```
That's it — no API key, no auth, no cost. The data ships with the package.
## HTTP (v2 stateless)
Default is **stdio**. Optional Streamable HTTP — no session id, JSON responses, loopback only:
```bash
npx -y uap-pulse --http
# GET http://127.0.0.1:3000/health
# POST http://127.0.0.1:3000/mcp (sessionless)
```
Env: `UAP_PULSE_HOST`, `UAP_PULSE_PORT`, `UAP_PULSE_TRANSPORT=http`.
### Tools
| Tool | What it does |
|------|--------------|
| `search_sightings` | Search by `release` (1–4), free text, agency, type, year range, or location. |
| `search_nearby` | Incidents within a radius (km) of a lat/lng, sorted by distance. |
| `get_sighting` | Full record for one file id (e.g. `pursue-042`) + the `war.gov` link. |
| `full_text_search` | Relevance-ranked search across titles, locations, and descriptions. |
| `notable_cases` | Curated historically significant groups with source records. |
| `hotspots` | The locations with the most declassified records. |
| `stats` | Totals + breakdowns by release, agency, file type, and era. |
| `timeline` | Records per decade (or year), 1944 → 2026. |
| `timeline_data` | Per-period records with coordinates for maps and animation. |
**Example** — *"What UAP files mention the Moon?"* → `search_sightings({ location: "Moon" })` → NASA Gemini/Apollo records with their war.gov links.
**Latest release** — `search_sightings({ release: 4, limit: 100 })` → all 40 files released on July 10, including the 1949 Los Alamos conference transcript, Project Sign records, new sensor videos, and STS-80 images.
---
## The live map
A 3D globe of every geolocatable record — points pulse where the sightings cluster, colored by agency, filterable by era (WWII Foo Fighters → the Navy Era). Click a hotspot to read the files and open them on `war.gov`. Off-world records (Moon, orbit) get their own panel.
Run it locally:
```bash
cd site && python3 -m http.server 8080 # then open http://localhost:8080
```
Or deploy the `site/` folder to Vercel (static, no build step).
---
## Data
- **Source:** [war.gov/UFO](https://www.war.gov/UFO/) — PURSUE Releases 1–4 (2026-05-08 through 2026-07-10).
- **License of the data:** Public domain (U.S. federal government work, 17 U.S.C. § 105).
- **Coverage:** 350 records · 275 geolocated · 20 off-world · 1944–2026. U.S. records by agency: War (171), FBI (87), NASA (40), CIA (21), State (7), DOE (5), ODNI (1), Intelligence Community Agency (1), U.S. Government (1).
- The official `war.gov` CSV is mirrored locally for reproducible builds; coordinates are representative centroids for named locations, maintained in [`scripts/build_data.py`](scripts/build_data.py).
Rebuild the dataset: `npm run data` (or `python3 scripts/build_data.py`).
---
## Develop
```bash
npm install
npm run build # tsc -> dist/
npm start # run the MCP server over stdio
```
## License
Code: **MIT** © David Mosiah ([@delx369](https://x.com/delx369)). Data: U.S. public domain.