# BravoEcho

> Aviation data API for dispatch software and AI agents: GPS RAIM prediction (in production) and route checks with a departure window, the NOTAM archive with route briefs, aviation weather (METAR, TAF, SIGMET, G-AIRMET, CWA, PIREP) at airports and along a route at the aircraft's time and level, and airport and navaid reference data (NOTAMs, weather and reference data in beta, free while in beta). One flight object works for the RAIM, NOTAM and weather route checks, and for the flight briefing pack that runs all three in one call (`POST /v1/briefing`, with a compact form and etags for poor connections). The winds and temperatures aloft along a flight (`POST /v1/weather/winds/route`, beta, from the FB forecasts) give headwind components and, with a true airspeed, the time en route. The airspace a flight enters (`POST /v1/airspace/route`, beta, United States: special use airspace, Class B, C and D, TFRs) answers where, when and at what level. Mass and balance (`POST /v1/planning/mass-balance`) and a navlog (`POST /v1/planning/navlog`, with the winds aloft), beta, compute on the aircraft data you send. Alerts (`POST /v1/alerts`, beta) watch a flight and call a signed webhook when its RAIM verdict, NOTAMs or weather hazards change.

Coverage: RAIM worldwide; METAR and TAF worldwide; NOTAMs (the FAA's domestic set and the international NOTAMs the FAA distributes), route strings (named fixes, airways and procedures from the FAA CIFP) and en-route weather advisories (G-AIRMET and CWA are US products) are fullest in the United States for now.

Server-side only: call the API from a backend route or an edge function, never from a browser, and keep the key in a secret (`BRAVOECHO_KEY`). The API sends no CORS headers, so a browser on another origin cannot read its answers.

- [Full v1 reference](https://bravoecho.ai/llms-full.txt): auth, endpoints, request and response shapes, errors, limits, pricing. One file.
- [Reference as web pages](https://bravoecho.ai/docs): the same reference, one page per service (RAIM prediction, route check, NOTAMs, weather, winds aloft, airspace, mass and balance, navlog, airports, briefing pack, alerts, MCP), each linkable.
- [OpenAPI 3.1 description](https://bravoecho.ai/openapi.json): every Available and Beta endpoint, each operation marked `x-status: available | beta`.
- MCP server: `https://api.bravoecho.ai/mcp` (streamable HTTP, the same key as `Authorization: Bearer`), thirteen tools for agents: RAIM route check and prediction, the flight briefing pack, NOTAMs along a route and search, weather at airports and along a route, winds aloft along a route, the airspace a flight enters, mass and balance, a navlog, airport, route strings. Client setup under MCP in the full reference.
- [Console](https://app.bravoecho.ai): create an account, create API keys, run RAIM prediction, route check, world map, NOTAM search, NOTAMs en route, aerodrome weather and weather en route in a browser
- [RAIM world map](https://bravoecho.ai/raim-map): public, no key: minutes without RAIM in each 2 degree cell worldwide for yesterday, today and tomorrow (UTC) at 0.1 and 0.3 NM, updated at 00, 06, 12 and 18 UTC, built on `POST /v1/raim/map`. The same maps as JSON: https://bravoecho.ai/raim-map/maps.json; the current image: https://bravoecho.ai/raim-map/image/today/0.1.png
- [Landing page](https://bravoecho.ai): product overview
- [Health](https://api.bravoecho.ai/up): 200 when the API is up
- [Status](https://uptime.bravoecho.ai/status/all): uptime

## Getting a key

Create an account at https://app.bravoecho.ai/register and create a key under API keys. The organisation starts on Free: 1,000 counted requests a month across all keys, beta products not counted, no card. Beyond that, an owner or admin requests pay as you go on the console's Billing page: no cap, invoiced monthly, paid by bank transfer. Questions: hello@bravoecho.ai; help with an account or a key: support@bravoecho.ai; volume pricing: sales@bravoecho.ai.

## Planned (not callable)

Not built yet; no endpoint, no MCP tool. Do not write code against these: more weather hazard types, and winds aloft from a gridded model outside the United States. Need something else? https://bravoecho.ai/request-a-service