All AI videos

AI video

Designing CLIs for Agents, Not Humans — Pedro Lopez, Airbyte

Airbyte engineer Pedro Lopez compares MCP and CLI interfaces for agents, then gives concrete rules for machine-readable commands, authentication, and progressive tool discovery.

AI Engineer · 2026 featured video

Watch on YouTube

What this video shows

Lopez shows two thin interfaces over Airbyte Agents: an MCP server for clients with protocol support and a CLI for shell-capable agents. He recommends a small MCP tool set that lets agents discover operations progressively, OAuth for user authorization, and long-lived sessions that match client expectations.

For command-line tools, the practical guidance is consistent noun-and-verb commands, JSON input and output, documented exit behavior, bundled skills, and no interactive prompts during unattended work. The comparison comes from Airbyte product work, so teams should test both interfaces with their actual host agents instead of treating either option as universal.

Check the authentication and connector behavior in the Airbyte Agent MCP documentation before copying the demonstrated flow. Compare the interface with the official MCP architecture and its client-server responsibilities.

What you will learn

  • Progressive discovery keeps the initial MCP surface small while still exposing a larger underlying API.
  • Agent-facing CLI commands should produce stable structured output and meaningful exit codes without terminal prompts.
  • Authentication differs by host: MCP clients can coordinate browser OAuth, while unattended CLIs need an explicit credential setup path.
  • Both interfaces should share authorization, validation, audit, and business logic rather than implementing separate behavior.

How to apply this safely

  1. List the agents and hosts that must call the product, including whether they support MCP, a shell, browser OAuth, and persistent sessions.
  2. Define three representative tasks and prototype the smallest interface that supports them without broad credentials.
  3. Add JSON schemas, stable errors, timeouts, pagination, dry runs, and non-interactive authentication behavior.
  4. Run malformed-input, expired-token, revoked-access, large-result, retry, and destructive-action tests in every supported client.

Important limitations

  • The talk reflects Airbyte product choices and does not benchmark task success or token cost across multiple MCP clients and coding agents.
  • Client support changes quickly. Features such as elicitation, session persistence, and OAuth need verification against each deployed client version.

Sources to check

Continue learning on Learnetto