> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mutagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Mutagent TypeScript SDK and make your first call.

<CodeGroup>
  ```bash npm theme={null}
  npm install @mutagent/sdk
  ```

  ```bash bun theme={null}
  bun add @mutagent/sdk
  ```

  ```bash pnpm theme={null}
  pnpm add @mutagent/sdk
  ```
</CodeGroup>

These pages describe `@mutagent/sdk` 0.8, the version the commands above install (0.8.1 today).
Versions before 0.6.22 use different method, group and type names, so update if a call on these pages
is missing:

```bash theme={null}
npm install @mutagent/sdk@latest
```

## Make your first call

Set an API key in your environment. See [API keys](/quickstart/api-keys) for where to create one.

```bash theme={null}
export MUTAGENT_API_KEY=<api-key>
```

```typescript whoami.ts theme={null}
import { Mutagent } from '@mutagent/sdk';

const client = new Mutagent({
  security: { apiKey: process.env.MUTAGENT_API_KEY! },
});

const { workspaces } = await client.workspaces.listWorkspaces();
console.log(workspaces.map((workspace) => workspace.name));
```

```bash theme={null}
bun whoami.ts
```

```text theme={null}
[ "Default workspace" ]
```

If the key is not valid, the call throws an error that says `Invalid, expired or revoked API key.`
Check the key with `mutagent auth status`, or create a new one.

## Next

* [Configuration](/sdk/typescript/configuration): the API address, timeouts, retries, and which
  workspace a call acts in.
* [LLM providers](/sdk/typescript/providers): add the model keys your cloud runs use.
* [Environments](/sdk/typescript/environments) and [Helix Cloud](/sdk/typescript/helix-cloud): store
  secrets, run Helix in the cloud, deploy managed agents.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.