get_flight_guide
Loads the authoritative guide for working with Flights. Call this tool first whenever the conversation turns to creating, updating, or operating a Flight, before reaching for any other *_flight* MCP tool.
Description
get_flight_guide returns a single guide document covering: the anatomy of a Flight, the difference between config and secrets, scheduling, run lifecycle, and common failure patterns. It does not take any arguments.
The human-readable equivalent of this guide lives at the Flights concept page. The guide returned by this tool is what AI agents should consult inside an agent session.
Input parameters
This tool takes no arguments.
Output schema
{
"success": boolean,
"guide": string // Markdown content of the guide
}
Example usage
When the user asks for anything Flight-related, the assistant should call this tool before calling create_flight or other flight tools:
Create a Flight that ingests Postgres data into MotherDuck hourly.
The assistant first calls get_flight_guide, reads the guide, and then proceeds to author the Flight.
Related
create_flight— Create a new Flight.list_flights— List Flights you own.- Flights concept — The human-readable overview.