Quickstart

This guide gets your agent buying through Sangria in five steps: install the CLI and skill, get a key, set it, fund your balance, and buy something.

1. Install the CLI and skills

In Claude Code, paste this URL and let Claude run it:

https://getsangria.com/skill

command -v npm >/dev/null 2>&1 || { echo "npm not found. Install Node.js (which bundles npm) from https://nodejs.org/ and re-run." >&2; exit 1; }

npm install -g @sangria-sdk/cli

mkdir -p ~/.claude/skills/sangria
curl -fsSL https://getsangria.com/skills/sangria/SKILL.md -o ~/.claude/skills/sangria/SKILL.md

The skill should now appear in Claude Code — look for sangria in /skills.

The CLI should also work:

sangria --help

2. Get an API key

Sign in at getsangria.com, then generate an agent API key from your dashboard at getsangria.com/client/dashboard. Agent keys start with sg_agents_. The same key authenticates both discovery and buying.

3. Save your key

Save the key with the CLI:

sangria auth set "sg_agents_…"

Verify it works by checking your balance:

sangria auth status

You can also use SANGRIA_API_KEY directly if you prefer environment variables. It takes precedence over saved CLI config.

4. Fund your balance

Top up at getsangria.com/client/dashboard. Discovery is free, but buying draws from your credit balance — there's no overdraft, so fund it before your first purchase.

5. Make your first purchase

Just ask your agent in plain language:

Buy me a decaf oat-milk latte near the office.

Behind the scenes:

1. The sangria skill finds matches and a price-locked quote (valid ~45 minutes).
2. Your agent shows you the match name and price, and asks for the go-ahead.
3. The sangria skill commits the chosen match, charges your credits, and returns the merchant's confirmation.

The quote expires in about 45 minutes, so approve before then — otherwise your agent will re-discover for a fresh price before buying.

Want the full detail — how intent is scored, order statuses, retries, every error code? That lives in the skill files. See The skill.