---
title: "Astronomer Integration"
description: "Manage Astro organizations, workspaces, deployments, clusters, and deploy history via the Astro API v1"
---
The Astronomer integration provides access to manage Astro organizations, workspaces, deployments, clusters, and deploy history via the Astro API v1 through the Integrate MCP server.

## Installation

The Astronomer integration is included with the SDK:

```typescript
import { astronomerIntegration } from "integrate-sdk/server";
```

## Setup

Add Astronomer to your server configuration. Provide credentials via environment variables or integration config:

```typescript
import { createMCPServer, astronomerIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    astronomerIntegration({
      // See configuration options below
    }),
  ],
});
```

### Client-Side Usage

```typescript
import { client } from "integrate-sdk";

const result = await client.astronomer.getSelf({});

console.log(result);
```

## Environment Variables

- `ASTRONOMER_API_KEY` (when supported by this integration)

## Configuration Options

<AutoTypeTable
  path="../src/integrations/astronomer.ts"
  name="AstronomerIntegrationOptions"
/>


## Tools

### `astronomer_get_self`

Get self

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerGetSelfParams"
/>

### `astronomer_list_organizations`

List organizations

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerListOrganizationsParams"
/>

### `astronomer_get_organization`

Get organization

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerGetOrganizationParams"
/>

### `astronomer_list_workspaces`

List workspaces

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerListWorkspacesParams"
/>

### `astronomer_get_workspace`

Get workspace

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerGetWorkspaceParams"
/>

### `astronomer_list_clusters`

List clusters

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerListClustersParams"
/>

### `astronomer_get_cluster`

Get cluster

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerGetClusterParams"
/>

### `astronomer_list_deployments`

List deployments

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerListDeploymentsParams"
/>

### `astronomer_get_deployment`

Get deployment

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerGetDeploymentParams"
/>

### `astronomer_create_deployment`

Create deployment

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerCreateDeploymentParams"
/>

### `astronomer_update_deployment`

Update deployment

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerUpdateDeploymentParams"
/>

### `astronomer_list_deploys`

List deploys

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerListDeploysParams"
/>

### `astronomer_get_deploy`

Get deploy

<AutoTypeTable
  path="generated/tool-params/astronomer.ts"
  name="AstronomerGetDeployParams"
/>

## Notes

- Category: Engineering
- Authentication mode: API key