Astro (MCP)

Connect AI tools to your Astro control plane (Deployments, Workspaces, environment objects, Organization settings) via the Model Context Protocol (MCP)

The Astro MCP server is an Astronomer Labs feature. Contact your Astronomer account team to have it enabled before connecting.

🚀 Quickstart

Connect to the Astro MCP server with Tenklo and call MCP tools in minutes. Astro MCP uses OAuth 2.0 with dynamic client registration, so no app registration is required — it signs you in with your own Astro credentials and respects your existing permissions.

Create the integration

In Tenklo (free signup), go to Integrations -> Configure New Integration -> Astro (MCP).

Authorize

Go to Connections -> Add Test Connection -> Authorize, then log in with your Astro credentials. Later, you'll let your users do the same directly from your app.

Call an Astro MCP tool

Make your first MCP request (initialize handshake). Replace the placeholders below with your Environment API key, integration ID, and connection ID:

curl "https://api.tenklo.dev/proxy/v1alpha1/astro/mcp" \
  -X POST \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
        "protocolVersion": "2024-11-05",
        "capabilities": {},
        "clientInfo": {
            "name": "nango-client",
            "version": "1.0.0"
        }
    }
}'

✅ You're connected! Check the Logs tab in Tenklo to inspect requests.

Implement Tenklo in your app

Follow our Auth implementation guide to integrate Tenklo in your app.

📚 Astro (MCP) guides

Tenklo uses dynamic client registration with Astronomer's MCP OAuth server. You do not need to register an MCP application.

The Astro MCP server currently provides read access to Deployments, Workspaces, environment objects (connections and variables), and Organization settings, plus Otto skills like Airflow upgrade planning.

Official resources: Astro MCP servers documentation


On this page