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-cloud
section 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
Save
to save your configuration and check thePlugins
section to verify that your servers are connected.
- Open Cursor.
- Navigate to
Tools & Integrations
>Add Custom MCP
. - Add the following configuration. Only include the
astro-cloud
section 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 Custom MCP configuration you added previously. - Save the configuration and check the
Tools & Integrations
>MCP Servers
section to verify that your servers are connected.