AI agent tooling for data engineering workflows. Includes an MCP server for Airflow, a CLI tool (`af`) for interacting with Airflow from your terminal, and skills that extend AI coding agents wit
How to install agents?
astronomer/agents
$git clone https://github.com/astronomer/agentsInstalls into the current project.
›Prefer a prompt? Paste this to your agent
Install agents by running `git clone https://github.com/astronomer/agents`, then use it for the current task and follow its documentation at https://github.com/astronomer/agents.
README.md
| 1 | # agents |
| 2 | |
| 3 | AI agent tooling for data engineering workflows. Includes an [MCP server](./astro-airflow-mcp/) for Airflow, a [CLI tool (`af`)](./astro-airflow-mcp/README.md#airflow-cli-tool) for interacting with Airflow from your terminal, and [skills](#skills) that extend AI coding agents with specialized capabilities for working with Airflow and data warehouses. Works with [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.com), and other agentic coding tools. |
| 4 | |
| 5 | Built by [Astronomer](https://www.astronomer.io/). [Apache 2.0 licensed](https://github.com/astronomer/agents/blob/main/LICENSE) and compatible with open-source Apache Airflow. |
| 6 | |
| 7 | ## Table of Contents |
| 8 | |
| 9 | <!-- START doctoc generated TOC please keep comment here to allow auto update --> |
| 10 | <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --> |
| 11 | |
| 12 | - [Installation](#installation) |
| 13 | - [Quick Start](#quick-start) |
| 14 | - [Compatibility](#compatibility) |
| 15 | - [Claude Code](#claude-code) |
| 16 | - [Cursor](#cursor) |
| 17 | - [Other MCP Clients](#other-mcp-clients) |
| 18 | - [Features](#features) |
| 19 | - [MCP Server](#mcp-server) |
| 20 | - [Skills](#skills) |
| 21 | - [Why Astro?](#why-astro) |
| 22 | - [User Journeys](#user-journeys) |
| 23 | - [Airflow CLI (`af`)](#airflow-cli-af) |
| 24 | - [Configuration](#configuration) |
| 25 | - [Warehouse Connections](#warehouse-connections) |
| 26 | - [Airflow](#airflow) |
| 27 | - [Usage](#usage) |
| 28 | - [Getting Started](#getting-started) |
| 29 | - [Development](#development) |
| 30 | - [Local Development Setup](#local-development-setup) |
| 31 | - [Adding Skills](#adding-skills) |
| 32 | - [Troubleshooting](#troubleshooting) |
| 33 | - [Common Issues](#common-issues) |
| 34 | - [Contributing](#contributing) |
| 35 | - [Roadmap](#roadmap) |
| 36 | - [License](#license) |
| 37 | |
| 38 | <!-- END doctoc generated TOC please keep comment here to allow auto update --> |
| 39 | |
| 40 | ## Installation |
| 41 | |
| 42 | ### Quick Start |
| 43 | |
| 44 | ```bash |
| 45 | npx skills add astronomer/agents --skill '*' |
| 46 | ``` |
| 47 | |
| 48 | This installs all Astronomer skills into your project via [skills.sh](https://skills.sh). You'll be prompted to select which agents to install to. To also select skills individually, omit the `--skill` flag. |
| 49 | |
| 50 | > [!IMPORTANT] |
| 51 | > **Claude Code users:** We recommend using the plugin instead (see [Claude Code](#claude-code) section below) for better integration with MCP servers and hooks. |
| 52 | |
| 53 | ### Compatibility |
| 54 | |
| 55 | **Skills:** Works with [25+ AI coding agents](https://github.com/vercel-labs/add-skill?tab=readme-ov-file#available-agents) including Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, Cline, and more. |
| 56 | |
| 57 | **MCP Server:** Works with any [MCP-compatible client](https://modelcontextprotocol.io/clients) including Claude Desktop, VS Code, and others. |
| 58 | |
| 59 | > [!NOTE] |
| 60 | > **Open-source Airflow users:** The MCP server works with any Airflow 2.x/3.x REST API. Set `AIRFLOW_API_URL` to your self-hosted instance. Skills are tool-agnostic and work with any Airflow deployment. |
| 61 | |
| 62 | ### Claude Code |
| 63 | |
| 64 | ```bash |
| 65 | # Add the marketplace and install the plugin |
| 66 | claude plugin marketplace add astronomer/agents |
| 67 | claude plugin install astronomer-data@astronomer |
| 68 | |
| 69 | # Upgrading from the old plugin name? Uninstall first: |
| 70 | # claude plugin uninstall data@astronomer && claude plugin marketplace update && claude plugin install astronomer-data@astronomer |
| 71 | ``` |
| 72 | |
| 73 | The plugin includes the Airflow MCP server that runs via `uvx` from PyPI. Data warehouse queries are handled by the `analyzing-data` skill using a background Jupyter kernel. |
| 74 | |
| 75 | ### Cursor |
| 76 | |
| 77 | Cursor supports both MCP servers and skills. |
| 78 | |
| 79 | **MCP Server** - Click to install: |
| 80 | |
| 81 | <a href="https://cursor.com/en-US/install-mcp?name=astro-airflow-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJhc3Ryby1haXJmbG93LW1jcCIsIi0tdHJhbnNwb3J0Iiwic3RkaW8iXX0"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add Airflow MCP to Cursor" height="32"></a> |
| 82 | |
| 83 | **Skills** - Install to your project: |
| 84 | |
| 85 | ```bash |
| 86 | npx skills add astronomer/agents --skill '*' -a cursor |
| 87 | ``` |
| 88 | |
| 89 | This installs skills to `.cursor/skills/` in your project. |
| 90 | |
| 91 | <details> |
| 92 | <summary>Manual MCP configuration</summary> |
| 93 | |
| 94 | Add to `~/.cursor/mcp.json`: |
| 95 | |
| 96 | ```json |
| 97 | { |
| 98 | "mcpServers": |
Related
6 picksType
- langchain-mcp-adaptersMake Anthropic Model Context Protocol (MCP) tools compatible with LangChain and LangGraph agents.Jul 2026
- mcporterTypeScript runtime and CLI for connecting to configured Model Context Protocol servers.Jul 2026
- mcp-proxyA MCP server which proxies requests to a remote MCP server over streamable HTTP or SSE.Jul 2026
- mcp-atlassianThe Model Context Protocol (MCP) Atlassian integration is an open-source implementation that bridges Atlassian products (Jira and Confluence) with AI language models following Anthropic's MCP specification.Jul 2026
- open-webuiOpen WebUIJul 2026
- rulesyncUnified AI rules management CLI tool that generates configuration files for various AI development toolsJul 2026
