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

# Setup

> Install and configure the Universal Checkout Skill for your AI agent.

## Installation

Skills live in the [`zincio/skills`](https://github.com/zincio/skills) catalog and install with the [`skills`](https://github.com/vercel-labs/skills) CLI.

<Tabs>
  <Tab title="npx skills (recommended)">
    Install the universal skill (covers every retailer):

    ```bash theme={null}
    npx skills add zincio/skills --skill universal-checkout
    ```

    Or install a single retailer:

    ```bash theme={null}
    npx skills add zincio/skills --skill amazon-checkout
    ```

    List everything in the catalog:

    ```bash theme={null}
    npx skills add zincio/skills --list
    ```

    The CLI works with Claude Code, Cursor, OpenClaw, Gemini CLI, and other Agent Skills–compatible platforms.
  </Tab>

  <Tab title="Git clone">
    Clone the catalog and point your agent at the `skills/` directory:

    ```bash theme={null}
    git clone https://github.com/zincio/skills.git
    ```

    Compatible agents automatically discover skills in the workspace `skills/` folder.
  </Tab>

  <Tab title="OpenClaw">
    OpenClaw loads skills from the workspace (`./skills/`), user (`~/.openclaw/skills/`), and bundled locations. Use the `skills` CLI above, or clone a single skill into a skills directory. OpenClaw hot-reloads when `SKILL.md` changes — no restart needed.

    <Info>
      Additional skill directories can be configured via `skills.load.extraDirs`.
    </Info>
  </Tab>
</Tabs>

## Configuration

Set up **one** authentication method, depending on how you want to pay.

<Tabs>
  <Tab title="API key">
    For a pre-registered Zinc account, set the `ZINC_API_KEY` environment variable before starting your agent:

    ```bash theme={null}
    export ZINC_API_KEY=your-api-key
    ```

    <Info>
      Get your key from the <a href="https://app.zinc.com" target="_blank">Zinc dashboard</a> and deposit funds to place orders.
    </Info>
  </Tab>

  <Tab title="MPP (no account)">
    With [Machine Payments Protocol](/v2/mpp) you pay per request — no Zinc account needed. The skill uses the `/agent/*` endpoints, and the MPP client handles the 402 → pay → retry flow automatically. Pay via:

    * **Tempo stablecoins** — set `TEMPO_PRIVATE_KEY` to a funded wallet key.
    * **Stripe** — cards/wallets via Stripe Link (Shared Payment Tokens).

    Install a client library so your agent can complete payments: `pip install pympp` (Python) or `npm install mppx viem` (TypeScript). Try it without code at [agent.zinc.com](https://agent.zinc.com).
  </Tab>
</Tabs>

### OpenClaw configuration file

If you're using OpenClaw, you can set the API key through the config file instead of an environment variable:

```json ~/.openclaw/openclaw.json theme={null}
{
  "skills": {
    "entries": {
      "universal-checkout": {
        "enabled": true,
        "env": {
          "ZINC_API_KEY": "your-api-key"
        }
      }
    }
  }
}
```

## Verifying the Installation

Start your agent and ask:

> "List my recent Zinc orders."

If the skill loaded correctly, the agent makes a `GET /orders` request and returns your order history. An authentication error usually means `ZINC_API_KEY` isn't set (or, on MPP, that no payment method is configured).

## Updating

Re-run the install command to pull the latest version:

```bash theme={null}
npx skills add zincio/skills --skill universal-checkout
```