uap-pulse is a read-only retrieval tool built around declassified U.S. Department of Defense UAP/UFO archives, including an MCP server and a 3D map. Its goal is to provide MCP-enabled AI clients (such as Claude, Cursor, and ChatGPT) with the ability to search official declassified records, along with an official source link for each record.
Purpose The tool is used to search and browse declassified UAP/UFO records from the U.S. federal government. According to the materials, on July 10, 2026, the U.S. Department of War published PURSUE Release 04 at war.gov/UFO. uap-pulse now packages all four release batches: 334 U.S. records, plus 16 curated official government cases from 12 countries, for a total of 350 records, spanning 1944 to 2026.
Main capabilities As an MCP server, it allows AI agents to search all 350 records by release batch, location, agency, decade, or type, and to obtain the official source link for each record. Examples include: querying "Which UAP files mention the Moon?" invokes search_sightings({ location: "Moon" }), returning NASA Gemini/Apollo records and their war.gov links; querying the latest release can invoke search_sightings({ release: 4, limit: 100 }), returning all 40 files published on July 10, 2026, including the 1949 Los Alamos meeting records, Project Sign records, new sensor videos, and STS-80 imagery.
The 3D map provides a 3D Earth view of all geolocatable records, with hotspots pulsing where sightings are concentrated, colored by agency, and filterable by decade (from World War II Foo Fighters to the Navy era). Clicking a hotspot lets you read the document and open it on war.gov. Off-world records (Moon, orbit) have a separate panel.
How to use To use it as an MCP server, add it to the configuration of Claude Desktop or any MCP client. No API key, authentication, or fees are required; the data is included with the package. The default transport is stdio, with optional Streamable HTTP (no session ID, JSON responses, loopback address only), and the relevant environment variables are UAP_PULSE_HOST, UAP_PULSE_PORT, UAP_PULSE_TRANSPORT=http.
How to run locally: the site/ folder can be deployed to Vercel (static, no build step required). To rebuild the dataset, run npm run data or python3 scripts/build_data.py.
Use cases Suitable for researchers, developers, or AI agent workflows that need to search, browse, or cite official declassified U.S. UAP/UFO archives. Through MCP integration, records can be queried directly in conversation and official source links obtained; through the 3D map, geographic distribution and decade clustering can be viewed intuitively.
Limitations and notes The data comes only from official sources. U.S. PURSUE records are in the public domain under 17 U.S.C. § 105; the international layer links to the official national archives of various countries, and rights remain with the original sources. It does not include scraped civilian databases. This project is not affiliated with or endorsed by any government. Coverage: 350 records, of which 275 are geolocated, 20 are off-world records, spanning 1944 to 2026. U.S. records by agency are distributed as: 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 to support reproducible builds; coordinates are representative center points for named locations, maintained in scripts/build_data.py. The code is under the MIT License, and the data is U.S. public domain.
