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

# CLI Installation

> Install the lqt CLI on macOS, Linux, or Windows.

The `lqt` CLI is a single Go binary with no dependencies. Pre-built binaries are available for all major platforms.

## Install

<Tabs>
  <Tab title="macOS (Apple Silicon)">
    ```bash theme={null}
    curl -sL https://github.com/gbgplc/lqt/releases/latest/download/lqt_darwin_arm64.tar.gz | tar xz
    sudo mv lqt /usr/local/bin/
    ```
  </Tab>

  <Tab title="macOS (Intel)">
    ```bash theme={null}
    curl -sL https://github.com/gbgplc/lqt/releases/latest/download/lqt_darwin_amd64.tar.gz | tar xz
    sudo mv lqt /usr/local/bin/
    ```
  </Tab>

  <Tab title="Linux (x86_64)">
    ```bash theme={null}
    curl -sL https://github.com/gbgplc/lqt/releases/latest/download/lqt_linux_amd64.tar.gz | tar xz
    sudo mv lqt /usr/local/bin/
    ```
  </Tab>

  <Tab title="Linux (ARM64)">
    ```bash theme={null}
    curl -sL https://github.com/gbgplc/lqt/releases/latest/download/lqt_linux_arm64.tar.gz | tar xz
    sudo mv lqt /usr/local/bin/
    ```
  </Tab>

  <Tab title="Windows">
    Download `lqt_windows_amd64.zip` from the [latest release](https://github.com/gbgplc/lqt/releases/latest), extract `lqt.exe`, and add it to your PATH.
  </Tab>
</Tabs>

Verify the installation:

```bash theme={null}
lqt version
```

## Set your API key

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={null}
    export LOQATE_API_KEY=your-key-here
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={null}
    $env:LOQATE_API_KEY="your-key-here"
    ```
  </Tab>
</Tabs>

<Tip>
  Don't have an API key? [Sign up for a free trial](https://account.loqate.com) with 45 days of access.
</Tip>

## Available commands

| Command                | Description                                                                        |
| :--------------------- | :--------------------------------------------------------------------------------- |
| `lqt verify`           | Verify addresses, emails, and phone numbers with policy-driven recommendations     |
| `lqt parse`            | Parse and standardize contact data using Claude Haiku (no Loqate credits consumed) |
| `lqt policy list`      | Display available policies and their thresholds                                    |
| `lqt policy show`      | Inspect a specific policy's configuration                                          |
| `lqt policy validate`  | Validate a custom policy JSON file                                                 |
| `lqt mcp`              | Start the MCP server (stdio or HTTP mode)                                          |
| `lqt tool-description` | Export JSON schema for agent frameworks (LangChain, OpenAI, etc.)                  |
| `lqt version`          | Display the installed version                                                      |

## Global flags

| Flag            | Description                                |
| :-------------- | :----------------------------------------- |
| `-k, --key`     | Override the Loqate API key                |
| `-o, --output`  | Output format: `json`, `jsonl`, or `table` |
| `-v, --verbose` | Enable verbose logging                     |
| `--no-color`    | Disable colored output                     |