Agents airflow-adapter

Airflow adapter pattern for v2/v3 API compatibility. Use when working with adapters, version detection, or adding new API methods that need to work across Airflow 2.x and 3.x.

install

source · Clone the upstream repo

git clone https://github.com/astronomer/agents

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/astronomer/agents "$T" && mkdir -p ~/.claude/skills && cp -r "$T/astro-airflow-mcp/.claude/skills/airflow-adapter" ~/.claude/skills/astronomer-agents-airflow-adapter && rm -rf "$T"

manifest: astro-airflow-mcp/.claude/skills/airflow-adapter/SKILL.md

Airflow Adapter Pattern

Enables compatibility with both Airflow 2.x (

/api/v1

) and 3.x (

/api/v2

Architecture

MCP Tool → _get_adapter() → AirflowV2Adapter or AirflowV3Adapter → Airflow API

Version is auto-detected at startup.

Key Files

```
adapters/base.py
```
- Abstract interface
```
adapters/airflow_v2.py
```
- Airflow 2.x (
```
/api/v1
```
)
```
adapters/airflow_v3.py
```
- Airflow 3.x (
```
/api/v2
```
)

Related Files

@api-differences.md - V2 vs V3 field/endpoint differences
@patterns.md - Implementation patterns

Quick Reference

adapter = _get_adapter()
dags = adapter.list_dags(limit=100)
run = adapter.trigger_dag_run("my_dag", conf={"key": "value"})