@ada-diamonds/cli

Official command-line client for the Ada Diamonds agent API — search live lab grown diamond inventory, engagement ring settings, and fine jewelry from the terminal.

npx @ada-diamonds/cli diamonds --shape Oval --min-carat 1 --max-price 4000

CARAT  SHAPE  COLOR  CLARITY  PRICE   REPORT
-----  -----  -----  -------  ------  ---------------
1.02   Oval   E      VS1      $1,200  IGI LG538299162
1.20   Oval   F      VS2      $1,150  IGI LG530297354

No account, no API key, no signup — the catalog is readable anonymously.

Install

npm install -g @ada-diamonds/cli    # then: ada diamonds --help
npx @ada-diamonds/cli --help        # or run it without installing

Requires Node 18+ (uses the built-in fetch). No dependencies.

Commands

| Command | Does | | --- | --- | | ada diamonds | Search available loose lab grown diamonds | | ada rings | Search engagement ring settings | | ada jewelry | Search wedding bands, earrings, necklaces, bracelets | | ada guides | List knowledge base articles | | ada read <slug> | Print one article as markdown | | ada showrooms | Showroom locations and remote consultation options | | ada open | Print this deployment's API, MCP, and docs URLs |

Add --json to any command for the raw API response:

ada guides --json | jq -r '.data[].slug'
ada diamonds --shape Emerald --json | jq '.pagination.total'

How Ada prices a ring

An engagement ring is a setting plus a loose diamond, priced separately. ada rings shows setting prices, which exclude the center stone. To quote a complete ring, add a setting and a diamond:

ada rings --shape Oval --type Solitaire --limit 1
ada diamonds --shape Oval --min-carat 1.5 --sort price_asc --limit 1

All prices are US dollars.

Environment

| Variable | Purpose | | --- | --- | | ADA_API_KEY | Optional credential; raises the rate limit from 120 to 600 requests/minute | | ADA_API_BASE | Override the host (defaults to https://www.adadiamonds.com) |

Get a key instantly, no account required:

curl -X POST https://www.adadiamonds.com/api/v1/keys \
  -H "Content-Type: application/json" \
  -d '{"name":"my-cli","env":"sandbox"}'

Also available

• REST API — https://www.adadiamonds.com/api/v1
• OpenAPI 3.1 — https://www.adadiamonds.com/openapi.json
• MCP server (Streamable HTTP) — https://www.adadiamonds.com/mcp
• Docs — https://www.adadiamonds.com/developers

Support

[email protected] · Terms · Privacy