{
  "markdown": "# 🛸 uap-pulse\n\n**An MCP server (and a live map) for the Pentagon's declassified UAP files.**\n\nOn **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**.\n\n> **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.\n\n🗺️ **Live map:** https://uap-pulse.vercel.app  ·  📦 **npm:** `uap-pulse`\n\n---\n\n## Use it as an MCP server\n\nYour agent can search all 350 records by release, location, agency, era, or type — and pull the direct official source link for each.\n\n**Claude Desktop / any MCP client** — add to your config:\n\n```json\n{\n  \"mcpServers\": {\n    \"uap-pulse\": { \"command\": \"npx\", \"args\": [\"-y\", \"uap-pulse\"] }\n  }\n}\n```\n\nThat's it — no API key, no auth, no cost. The data ships with the package.\n\n## HTTP (v2 stateless)\n\nDefault is **stdio**. Optional Streamable HTTP — no session id, JSON responses, loopback only:\n\n```bash\nnpx -y uap-pulse --http\n# GET  http://127.0.0.1:3000/health\n# POST http://127.0.0.1:3000/mcp   (sessionless)\n```\n\nEnv: `UAP_PULSE_HOST`, `UAP_PULSE_PORT`, `UAP_PULSE_TRANSPORT=http`.\n\n### Tools\n\n| Tool | What it does |\n|------|--------------|\n| `search_sightings` | Search by `release` (1–4), free text, agency, type, year range, or location. |\n| `search_nearby` | Incidents within a radius (km) of a lat/lng, sorted by distance. |\n| `get_sighting` | Full record for one file id (e.g. `pursue-042`) + the `war.gov` link. |\n| `full_text_search` | Relevance-ranked search across titles, locations, and descriptions. |\n| `notable_cases` | Curated historically significant groups with source records. |\n| `hotspots` | The locations with the most declassified records. |\n| `stats` | Totals + breakdowns by release, agency, file type, and era. |\n| `timeline` | Records per decade (or year), 1944 → 2026. |\n| `timeline_data` | Per-period records with coordinates for maps and animation. |\n\n**Example** — *\"What UAP files mention the Moon?\"* → `search_sightings({ location: \"Moon\" })` → NASA Gemini/Apollo records with their war.gov links.\n\n**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.\n\n---\n\n## The live map\n\nA 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.\n\nRun it locally:\n\n```bash\ncd site && python3 -m http.server 8080   # then open http://localhost:8080\n```\n\nOr deploy the `site/` folder to Vercel (static, no build step).\n\n---\n\n## Data\n\n- **Source:** [war.gov/UFO](https://www.war.gov/UFO/) — PURSUE Releases 1–4 (2026-05-08 through 2026-07-10).\n- **License of the data:** Public domain (U.S. federal government work, 17 U.S.C. § 105).\n- **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).\n- 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).\n\nRebuild the dataset: `npm run data` (or `python3 scripts/build_data.py`).\n\n---\n\n## Develop\n\n```bash\nnpm install\nnpm run build      # tsc -> dist/\nnpm start          # run the MCP server over stdio\n```\n\n## License\n\nCode: **MIT** © David Mosiah ([@delx369](https://x.com/delx369)). Data: U.S. public domain.\n",
  "bytes": 4045,
  "sha": "389686e35054a876c2391d129d81db12317a3c78edf387f9937f027f59412a33",
  "repo_slug": "davidmosiah/uap-pulse",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_davidmosiah_uap_pulse_d0bf5c80/readme"
}