AI Agent Skill

Teach your AI agent to Disco.

Disco publishes two files for AI agents: an install guide and a skill reference. Point your agent at the install guide first, then the skill reference takes over for everything after install.

Step 1: Install — point your agent at install.md

Copy this URL and paste it into your AI agent's chat. The install guide walks the agent through downloading Disco, saving the ForeFlight API key (non-interactively, to avoid paste corruption), and registering as an MCP server.

https://staging.disco.postflight.co/install.md

Or just tell your agent:

"Read https://staging.disco.postflight.co/install.md and install Disco for me."

Step 2: Use — skill.md is the command reference

Once Disco is installed, your agent reads skill.md for the full command and MCP tool reference. This is what the agent consults whenever you ask it to plan a flight, check weather, or look up a route.

https://staging.disco.postflight.co/skill.md

Claude Code / OpenClaw

Paste the install URL into your chat. Claude will read it, run the installer, and configure the MCP server.

OpenAI Codex

Share the install URL as context. Codex parses the markdown and executes each step.

Google Gemini CLI

Provide the install URL. Gemini reads the spec and follows the install and config instructions.

Any MCP-Compatible Agent

Both files are plain markdown. Any agent that can read a URL and run shell commands can install and use Disco.

What's in each file

install.md — run this first
Covers: 1. curl one-liner to install the disco CLI 2. Asking the user for their ForeFlight API key (and pointing to the ForeFlight key page if they don't have one) 3. Saving the key non-interactively via disco setup --api-key "..." --default-aircraft N78ZG (never use interactive paste through PTY/process tools) 4. Verifying connectivity with disco flights 5. Registering as MCP with Claude Code, Codex, Claude Desktop 6. Troubleshooting
skill.md — reference for every call after install
Covers: 1. When to use this skill (intent patterns) 2. Full CLI command reference (flights, crew, passengers, aircraft, performance, documents, release, reschedule) 3. 40+ MCP tools organized by domain: dispatch, flight planning, weather, airports, navigation, NOTAMs, fusion data 4. Natural language → command mapping table 5. Behavior notes (timezones, ETD display, flag aliases)
View install.md View skill.md

What happens when your agent reads install.md

  1. The agent fetches install.md from the URL
  2. It runs curl -fsSL https://staging.disco.postflight.co/install.sh | bash to install the CLI
  3. It asks you for your ForeFlight Dispatch API key (and points you to dispatch.foreflight.com/tools/console/keys if you don't have one)
  4. It runs disco setup --api-key "<your-key>" --default-aircraft N78ZG to save credentials safely — no interactive prompts, so paste corruption can't happen
  5. It verifies the install by running disco flights
  6. For any subsequent request, it reads skill.md for the command and tool reference

The entire flow is hands-off once you give your agent the URL and your API key.