Skip to main content
This guide makes one safe, read-only request. You will list your accounts, choose one, and list its projects.

Before you start

You need:
  • An account.
  • A Personal Access Token created in Settings > Access tokens.
  • The API URL for your environment.
The token authenticates you. It does not decrypt records. Your vault passphrase is only needed when you read or change encrypted record values.

API

Keep credentials in environment variables instead of command history.
List the accounts you can access:
A successful request uses the standard envelope:
Save the account ID, then list its projects:

SDK

Install the package:

CLI

airctrl login stores the API URL, your PAT, and an optional default project in ~/.airctrl/config.json.

MCP

Add @airctrl/mcp to your MCP client, then ask your agent:
Use to list my accounts. Then list the projects in account 00000000-0000-4000-8000-000000000001.
The agent calls list_accounts, followed by list_projects. See MCP setup for the full configuration.

Next steps