MCP server
Astro provides two experimental Model Context Protocol (MCP) servers that allow AI models and agents to securely access your Astro resources. Connect to our MCP server natively or by using the mcp-remote module in compatible AI clients.
Servers
The Astro Cloud MCP server is an authenticated remote MCP server that provides tools for discovering and managing your Astro resources, including Deployments, Workspaces, and environment variables. The Astro Cloud MCP server follows the authenticated remote MCP specification, with the server centrally hosted and managed by Astronomer.
The Astro Registry MCP server is a public remote MCP server that provides resources for the Astro Registry, including Airflow modules and connection configurations.
Setup Instructions
If you experience any issues, try restarting your client or disabling and re-enabling the Astro MCP server connection.
- Windsurf
- Cursor
- Open Windsurf settings with
CTRL/CMD + ,. - Navigate to
Cascade>Manage plugins. - Select
View raw config. - Add the following configuration. Only include the
astro-cloudsection if you're using the authenticated Astro Cloud MCP server.{
"mcpServers": {
"astro-registry": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.astronomer.io/registryV2/v1alpha1/mcp"
]
},
"astro-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.astronomer.io/v1alpha1/mcp?organizationId=<MY_ORGANIZATION_ID>",
"--header",
"Authorization: Bearer ${AUTH_TOKEN}"
],
"env": {
"AUTH_TOKEN": "<MY_AUTH_TOKEN>"
}
}
}
} - (If using Astro Cloud MCP) Find your Astro Organization ID in the Astro UI. Enter the ID as
<MY_ORGANIZATION_ID>in the URL of the configuration above. - (If using Astro Cloud MCP) Create a Workspace or Organization token in the Astro UI. Enter the token as
<MY_AUTH_TOKEN>in the"env"section of the configuration above. - Click
Saveto save your configuration and check thePluginssection to verify that your servers are connected.
- Open Cursor.
- Navigate to
Tools & Integrations>Add Custom MCP. - Add the following configuration. Only include the
astro-cloudsection if you're using the authenticated Astro Cloud MCP server.{
"mcpServers": {
"astro-registry": {
"url": "https://api.astronomer.io/registryV2/v1alpha1/mcp"
},
"astro-cloud": {
"url": "https://api.astronomer.io/v1alpha1/mcp?organizationId=<MY_ORGANIZATION_ID>",
"headers": {
"Authorization":"Bearer <MY_AUTH_TOKEN>"
}
}
}
} - (If using Astro Cloud MCP) Find your Astro Organization ID in the Astro UI. Enter the ID as
<MY_ORGANIZATION_ID>in the URL of the configuration above. - (If using Astro Cloud MCP) Create a Workspace or Organization token in the Astro UI. Enter the token as
<MY_AUTH_TOKEN>in the"env"section of the Custom MCP configuration you added previously. - Save the configuration and check the
Tools & Integrations>MCP Serverssection to verify that your servers are connected.