Setup - Zinc API Documentation

Installation

Skills live in the zincio/skills catalog and install with the skills CLI.

npx skills (recommended)
Git clone
OpenClaw

Install the universal skill (covers every retailer):

npx skills add zincio/skills --skill universal-checkout

Or install a single retailer:

npx skills add zincio/skills --skill amazon-checkout

List everything in the catalog:

npx skills add zincio/skills --list

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

Clone the catalog and point your agent at the skills/ directory:

git clone https://github.com/zincio/skills.git

Compatible agents automatically discover skills in the workspace skills/ folder.

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.

Additional skill directories can be configured via skills.load.extraDirs.

Configuration

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

API key
MPP (no account)

For a pre-registered Zinc account, set the ZINC_API_KEY environment variable before starting your agent:

export ZINC_API_KEY=your-api-key

Get your key from the Zinc dashboard and deposit funds to place orders.

With Machine Payments Protocol 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.

OpenClaw configuration file

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

~/.openclaw/openclaw.json

{
  "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:

npx skills add zincio/skills --skill universal-checkout

​Installation

​Configuration

​OpenClaw configuration file

​Verifying the Installation

​Updating

Installation

Configuration

OpenClaw configuration file

Verifying the Installation

Updating