> ## Documentation Index
> Fetch the complete documentation index at: https://docs.volanti.aero/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> Every tool on the Events.Aero MCP server: its parameters and what it returns.

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.

| Parameter | Type | Required | Description |
| - | - | - | - |
| `query` | string | No | Words matched against the event name, venue name, town and location. Every word must appear, matched from the start of a word, so `dux` finds Duxford. Up to 100 characters. |
| `type` | string | No | An event type value from `list-event-types`, such as `airshow` or `fly_in`. |
| `country` | string | No | Two-letter country code from `list-countries`, such as `GB`, in either case. Without it, every listed country is searched. |
| `from` | string | No | Earliest start date, `YYYY-MM-DD`, matched against each event's own local start date. |
| `to` | string | No | Latest start date, `YYYY-MM-DD`, inclusive. Must be on or after `from`. |
| `latitude` | number | With `longitude` | Search near this point, from -90 to 90. Results are ordered nearest first. |
| `longitude` | number | With `latitude` | Search near this point, from -180 to 180. |
| `radius_nm` | integer | No | Radius around the point in nautical miles, from 1 to 500. Default 50. |
| `free` | boolean | No | Only events with free entry. |
| `online` | boolean | No | Only online events. |
| `page` | integer | No | Page of results, from 1 to 500. Default 1. |
| `per_page` | integer | No | Results a page, from 1 to 50. Default 20. |

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.

```json Example: search-events with type "fly_in" and per_page 1 theme={null}
{
  "events": [
    {
      "id": "aB3dE9",
      "slug": "example-flying-club-breakfast-fly-in",
      "url": "https://events.aero/gb/events/example-flying-club-breakfast-fly-in",
      "name": "Example Flying Club breakfast fly-in",
      "type": "Fly-in",
      "status": "Published",
      "starts_at": "2026-12-06T09:00:00",
      "ends_at": "2026-12-06T13:00:00",
      "timezone": "Europe/London",
      "when": "Sun 6 Dec 2026 · 09:00",
      "provisional": false,
      "online": false,
      "venue": {
        "name": "Example Airfield",
        "town": "Exampleton",
        "kind": "Airfield or airport",
        "icao_code": "EGXX",
        "radio_frequency": "123.450"
      },
      "country": { "code": "GB", "name": "United Kingdom" },
      "is_free": false,
      "price_from": "£8.00",
      "rsvp_available": true,
      "image_url": null
    }
  ],
  "page": 1,
  "per_page": 1,
  "total": 42,
  "next_page": 2
}
```

### Event summary fields

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

| Field | Type | Description |
| - | - | - |
| `id` | string | The event's ID. Pass it to `get-event`. |
| `slug` | string | The event's slug, which `get-event` also accepts. |
| `url` | string | The event's public page. Send people here to book, RSVP or contact the organiser. |
| `name` | string | The event's name, as the organiser wrote it. |
| `type` | string or null | The event type's label, such as `Fly-in`. |
| `status` | string | `Published`, or for `get-event` also `Completed` or `Cancelled`. |
| `starts_at`, `ends_at` | string | Local date and time in the event's timezone, `YYYY-MM-DDTHH:MM:SS`, with no offset. `ends_at` can be `null`. |
| `timezone` | string | The event's IANA timezone, such as `Europe/London`. |
| `when` | string | The date line the website shows. A series of dates shows its next date and how many follow. |
| `provisional` | boolean | `true` when the event is expected to take place but its organiser has not published how to attend yet. |
| `online` | boolean | `true` for an online event. |
| `venue` | object or null | `name`, `town`, `kind`, and for an airfield its `icao_code` and `radio_frequency`. An event with a free-text location has only `name`. |
| `country` | object | `code` and `name`. |
| `is_free` | boolean | `true` when entry is free. |
| `price_from` | string or null | The lowest price, formatted with its currency, such as `£8.00`. `null` when free or not given. |
| `rsvp_available` | boolean | `true` when people can RSVP free on the event page now. |
| `image_url` | string or null | The event's header image, when it has one. |

## 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.

| Parameter | Type | Required | Description |
| - | - | - | - |
| `event` | string | Yes | The event's ID or slug. Up to 200 characters. |

It returns `event`, with every summary field above plus:

| Field | Type | Description |
| - | - | - |
| `description` | string or null | The event's description as plain text. |
| `schedule` | list | The running order: `time` and `item` for each row, and `date` (`YYYY-MM-DD`) on events that run over several days. |
| `booking_url` | string or null | The organiser's booking page. `null` once the event is cancelled or over. |
| `organiser` | string or null | The organiser's name, when the page shows one. |
| `contact_url` | string or null | The organiser's website. |
| `contact_email` | string or null | The organiser's public contact email. |
| `unverified_notice` | string or null | A note naming the details Events.Aero has not checked yet. |
| `fly_in` | object or null | For events that welcome aircraft and have not ended: `rsvp_available` (pilots can RSVP to fly in now), `spaces_full`, `ppr_required`, `runway`, `landing_fees` (each with `mtow_band`, `engines` and `amount`), `landing_fee_note` and `fees` (how fees are paid). |

The airfield's phone number and email for prior permission are on the event page only.

```json Example: get-event with event "aB3dE9" (fields shared with the summary left out) theme={null}
{
  "event": {
    "id": "aB3dE9",
    "url": "https://events.aero/gb/events/example-flying-club-breakfast-fly-in",
    "name": "Example Flying Club breakfast fly-in",
    "description": "Bacon rolls and tea in the clubhouse. Visiting pilots welcome.",
    "schedule": [
      { "time": "09:00", "item": "Clubhouse opens" },
      { "time": "12:30", "item": "Last orders" }
    ],
    "booking_url": null,
    "organiser": "Example Flying Club",
    "contact_url": "https://example.org",
    "contact_email": "events@example.org",
    "unverified_notice": null,
    "fly_in": {
      "rsvp_available": true,
      "spaces_full": false,
      "ppr_required": true,
      "runway": "09/27 650 m Grass",
      "landing_fees": [
        { "mtow_band": "Under 1,000 kg", "engines": "Single engine", "amount": "£10.00" }
      ],
      "landing_fee_note": "Waived for club members",
      "fees": "Fees are payable on arrival, never through Events.Aero."
    }
  }
}
```

## featured-events

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.

| Parameter | Type | Required | Description |
| - | - | - | - |
| `country` | string | No | Two-letter country code from `list-countries`. Without it, the selection covers every listed country. |

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.

| Parameter | Type | Required | Description |
| - | - | - | - |
| `country` | string | No | Two-letter country code for the page links. Default `GB`. |

It returns `country` and `event_types`, each with `value`, `label` and `url`.

| Value | Label |
| - | - |
| `airshow` | Airshow |
| `fly_in` | Fly-in |
| `static_display` | Static display |
| `workshop` | Workshop |
| `seminar` | Seminar |
| `online_event` | Online event |
| `club_meet` | Club meet |
| `conference` | Conference |
| `expo` | Expo |
| `competition` | Competition |
| `charity_event` | Charity event |
| `military` | Military |
| `spotting` | Spotting |
| `model_aircraft` | Model aircraft |

```json Example: list-event-types (first entry) theme={null}
{
  "country": "GB",
  "event_types": [
    { "value": "airshow", "label": "Airshow", "url": "https://events.aero/gb/airshows" }
  ]
}
```

## 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).

```json Example: list-countries (first entry) theme={null}
{
  "countries": [
    {
      "code": "GB",
      "name": "United Kingdom",
      "url": "https://events.aero/gb",
      "events_url": "https://events.aero/gb/events"
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.