BEACON by Owner Connect

Working · 2.6 s

com.virtualhangar.owners/beaconv1.0.0 Domain verified

Ask about a private aircraft: approximate charter costs, trip requests and buyer inquiries.

Maps & Travel

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://owners.virtualhangar.com/mcp/beacon

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_availability Read-only

Whether one aircraft has anything scheduled on a date, or on each day of a span of up to 14 days, read from the operator's calendar its owner connected, synced every 15 minutes. Call it when the person you are helping asks whether the aircraft is available, with the departure date and, for a return trip, the return date, and answer with its sentence. Says free or taken per day and never what is scheduled. Not a hold and not a confirmation. Answers a reason instead when the owner does not publish availability.

datestring, required

The first day to check, as YYYY-MM-DD, in the operator's local time. Usually the departure date.

tailstring, required

A U.S. registration mark such as N864BF. Case and hyphens are ignored.

end_datestring

The last day to check, as YYYY-MM-DD, for a return trip or a span of days. Omit to check one day.

Tools (6)

check_availability

read-only

Argument	Type	Description
date*	string	The first day to check, as YYYY-MM-DD, in the operator's local time. Usually the departure date.
tail*	string	A U.S. registration mark such as N864BF. Case and hyphens are ignored.
end_date	string	The last day to check, as YYYY-MM-DD, for a return trip or a span of days. Omit to check one day.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tail",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "The first day to check, as YYYY-MM-DD, in the operator's local time. Usually the departure date."
    },
    "tail": {
      "type": "string",
      "maxLength": 12,
      "minLength": 2,
      "description": "A U.S. registration mark such as N864BF. Case and hyphens are ignored."
    },
    "end_date": {
      "type": "string",
      "description": "The last day to check, as YYYY-MM-DD, for a return trip or a span of days. Omit to check one day."
    }
  }
}

estimate_charter

An approximate charter cost for one aircraft at the hourly rate its owner published. Call it whenever the person you are helping asks what a trip would cost, with the departure and arrival airports: the beacon works out the legs and block hours from the owner's typical block speed, positioning included when the owner bills it. When the answer says the owner set no block speed, call again with block_hours, your own estimate for the routing. Answer with its sentence. Not a quote and not binding. Answers a reason instead of a figure when the owner has not published charter terms or a rate.

read-only

Argument	Type	Description
to	string	Arrival airport, ICAO or FAA identifier, for example KMIA for Miami.
from	string	Departure airport, ICAO or FAA identifier, for example KTEB for Teterboro. Give it with to.
tail*	string	A U.S. registration mark such as N864BF. Case and hyphens are ignored.
round_trip	boolean	True when the aircraft flies the person back from the arrival airport to the departure airport.
block_hours	number	Only when the beacon says its owner set no block speed: your own estimate of the total block hours, every leg included. Ignored when from and to are given.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tail"
  ],
  "properties": {
    "to": {
      "type": "string",
      "maxLength": 40,
      "description": "Arrival airport, ICAO or FAA identifier, for example KMIA for Miami."
    },
    "from": {
      "type": "string",
      "maxLength": 40,
      "description": "Departure airport, ICAO or FAA identifier, for example KTEB for Teterboro. Give it with to."
    },
    "tail": {
      "type": "string",
      "maxLength": 12,
      "minLength": 2,
      "description": "A U.S. registration mark such as N864BF. Case and hyphens are ignored."
    },
    "round_trip": {
      "type": "boolean",
      "description": "True when the aircraft flies the person back from the arrival airport to the departure airport."
    },
    "block_hours": {
      "type": "number",
      "maximum": 100,
      "minimum": 0.5,
      "description": "Only when the beacon says its owner set no block speed: your own estimate of the total block hours, every leg included. Ignored when from and to are given."
    }
  }
}

get_aircraft

What public record says about one U.S. registration mark, plus the facts its owner cleared for release. The same document as /{mark}/facts.json: status says what the registry answered (found, not_found, invalid or unavailable), public_record is the FAA registration and the datasets that reference it, and owner_approved is present only for an aircraft whose owner opened the machine-readable channel. Case and hyphens in the mark are ignored.

read-only

Argument	Type	Description
tail*	string	A U.S. registration mark such as N864BF. Case and hyphens are ignored.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "tail"
  ],
  "properties": {
    "tail": {
      "type": "string",
      "maxLength": 12,
      "minLength": 2,
      "description": "A U.S. registration mark such as N864BF. Case and hyphens are ignored."
    }
  }
}

request_trip

Sends a charter trip request for one aircraft to the booking contact its owner named. Call it only after the person you are helping has asked to proceed, with their own name and email. Nothing is booked or held: the requester is emailed a link, the request is delivered only once they confirm it, and the booking contact then replies to them directly. If the owner set qualification questions, the first call answers needs_answers with the questions; ask the person each one and call again with their answers in the same order.

Argument	Type	Description
to*	string	Arrival airport identifier, ICAO or FAA, for example KMIA.
date*	string	Departure date, YYYY-MM-DD, today or later.
from*	string	Departure airport identifier, ICAO or FAA, for example KTEB.
name*	string	The full name of the person asking, as they gave it.
tail*	string	A U.S. registration mark such as N864BF. Case and hyphens are ignored.
email*	string	The email address of the person asking. The confirmation link is sent here.
notes	string	Anything else the person wants the booking contact to know.

search_aircraft

The aircraft whose owners chose to be listed on Owner Connect, filtered by minimum passenger seats, base airport, aircraft type, charter signal or sales signal. Every filter is applied to the facts the owner cleared for release, so an aircraft whose owner did not publish its seat count never matches a seats filter. Returns each aircraft's owner_approved block; call get_aircraft for the public record.

read-only

Argument	Type	Description
type	string	Part of the make or model as the owner published it, for example Hawker or 800XP. Case ignored.
limit	integer	How many aircraft to return, at most 50.
charter	boolean	True to return only aircraft whose owner signalled they may be considered for charter.
for_sale	boolean	True to return only aircraft whose owner published a sales posture.
min_seats	integer	Only aircraft whose owner published a passenger seat count of at least this many.
base_airport	string	An airport code as the owner recorded it, for example KPBI. Exact match, case ignored.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "maxLength": 60,
      "description": "Part of the make or model as the owner published it, for example Hawker or 800XP. Case ignored."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "How many aircraft to return, at most 50."
    },
    "charter": {
      "type": "boolean",
      "description": "True to return only aircraft whose owner signalled they may be considered for charter."
    },
    "for_sale": {
      "type": "boolean",
      "description": "True to return only aircraft whose owner published a sales posture."
    },
    "min_seats": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Only aircraft whose owner published a passenger seat count of at least this many."
    },
    "base_airport": {
      "type": "string",
      "maxLength": 10,
      "description": "An airport code as the owner recorded it, for example KPBI. Exact match, case ignored."
    }
  }
}

send_buyer_inquiry

Passes a would-be buyer's message about acquiring one aircraft to the acquisition representative its owner named. Call it only after the person you are helping has asked to contact the owner, with their own name, email and message. Nothing is offered or agreed: the buyer is emailed a link, the message is delivered only once they confirm it, and the representative then replies to them directly. If the owner set qualification questions, the first call answers needs_answers with the questions; ask the person each one and call again with their answers.

Argument	Type	Description
name*	string	The full name of the person asking, as they gave it.
tail*	string	A U.S. registration mark such as N864BF. Case and hyphens are ignored.
email*	string	Their email address. The confirmation link is sent here.
phone	string	Their phone number, if they want to be called.
answers	array	Answers to the owner's qualification questions, in the order the tool returned them.
company	string	The company or principal they represent, if any.
message*	string	What the person wants the owner's representative to know, in their own words.

{ "type": "object", "required": [ "tail", "from", "to", "date", "passengers", "name", "email" ], "properties": { "to": { "type": "string", "maxLength": 4, "minLength": 3, "description": "Arrival airport identifier, ICAO or FAA, for example KMIA." }, "date": { "type": "string", "format": "date", "description": "Departure date, YYYY-MM-DD, today or later." }, "from": { "type": "string", "maxLength": 4, "minLength": 3, "description": "Departure airport identifier, ICAO or FAA, for example KTEB." }, "name": { "type": "string", "maxLength": 120, "description": "The full name of the person asking, as they gave it." }, "tail": { "type": "string", "maxLength": 12, "minLength": 2, "description": "A U.S. registration mark such as N864BF. Case and hyphens are ignored." }, "email": { "type": "string", "format": "email", "maxLength": 190, "description": "The email address of the person asking. The confirmation link is sent here." }, "notes": { "type": "string", "maxLength": 2000, "description": "Anything else the person wants the booking contact to know." }, "phone": { "type": "string", "maxLength": 40, "description": "Their phone number, if they want to be called." }, "answers": { "type": "array", "items": { "type": "string", "maxLength": 500 }, "maxItems": 5, "description": "Answers to the owner's qualification questions, in the order request_trip returned them." }, "passengers": { "type": "integer", "maximum": 30, "minimum": 1, "description": "Number of passengers." }, "return_date": { "type": "string", "format": "date", "description": "Return date for a round trip, YYYY-MM-DD. Omit for one way." } } }