Skip to main content
The server at https://events.aero/mcp/events has five tools. All of them are read-only and idempotent, so calling one twice gives the same answer and changes nothing. Each answers with readable text and the same facts as structured JSON (structuredContent). The examples on this page show the structured JSON, with illustrative values. When an argument is wrong, the tool returns an error result (isError: true) whose text says what to fix, for example “Use a supported country code from list-countries, such as GB.”

search-events

Searches upcoming public events. Results are ordered by start date, or by distance when you give latitude and longitude, one page at a time. It returns events (a list of event summaries, described below), page, per_page, total and next_page (null on the last page). When you searched near a point, each event also has distance_nm, rounded to one decimal place.
Example: search-events with type and per_page 1

Event summary fields

search-events and featured-events describe each event with these fields. get-event returns them too, with more.

get-event

Returns the full public details of one event by its ID or slug, from a search-events or featured-events result. It also answers for events that have finished or been cancelled, while their page is public. A reference that matches no public event returns an error result. It returns event, with every summary field above plus: The airfield’s phone number and email for prior permission are on the event page only.
Example: get-event with event (fields shared with the summary left out)
Returns the events Events.Aero is featuring now, the same selection as the lead row of the home page: up to five upcoming events, soonest first, with organiser-run listings leading. It returns events, a list of event summaries. The list is empty when nothing is featured.

list-event-types

Lists the kinds of event on Events.Aero, with the value to pass to search-events and the page that lists each type in a country. It returns country and event_types, each with value, label and url.
Example: list-event-types (first entry)

list-countries

Lists the countries Events.Aero lists events in. It takes no parameters. It returns countries, each with code, name, url (the country’s home page) and events_url (its events page).
Example: list-countries (first entry)