Skip to main content

MCP server

public preview
This feature is in Public Preview.

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​

tip

If you experience any issues, try restarting your client or disabling and re-enabling the Astro MCP server connection.

  1. Open Windsurf settings with CTRL/CMD + ,.
  2. Navigate to Cascade > Manage plugins.
  3. Select View raw config.
  4. 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>"
          }
        }
      }
    }
  5. (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.
  6. (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.
  7. Click Save to save your configuration and check the Plugins section to verify that your servers are connected.

Was this page helpful?