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
The tool returns the guide as a plain-text markdown document, mirrored into structured content as:
{
"text": string // Markdown content of the guide
}
Organization Flight conventions
When Guides are enabled, the returned guide includes a "Flight guides" section listing your organization's Flight conventions stored under the reserved flights topic. The AI assistant reads the relevant ones with get_guide before authoring or operating a Flight.
To save personal Flight preferences for future sessions, ask the assistant to create a Guide with topic flights and access user through create_guide. Org-wide Flight conventions use access organization.
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 the Flights you can see.- Flights concept — The human-readable overview.