Onboarding / examples

Worked examples

Four end-to-end flows with copy-paste commands. Download scripts from /tools/bin/, merge packs from /downloads/, run in Cursor (referral BVN3MVJH9SDO). New here? Start at Getting started.

mcpexample 1

Attach + probe cheaperllm MCP

Wire https://mcp.cheaperllm.com/mcp into Cursor, gate secrets, probe before the first tool call.

# 1. Get key at cheaperllm.com — export, never commit
export CHEAPERLLM_API_KEY="sk-your-key-here"
node tools/bin/env-gate.mjs CHEAPERLLM_API_KEY

# 2. Merge /packs/cheaperllm-attach/cursor-mcp.json into Cursor MCP settings
#    Endpoint: https://mcp.cheaperllm.com/mcp

# 3. Probe — expect tools listed, exit 0
node tools/bin/mcp-probe.mjs https://mcp.cheaperllm.com/mcp --key CHEAPERLLM_API_KEY

# 4. Pick tools before burning credits (prompt pack)
#    /packs/prompt-ops/11-mcp-tool-picker.md

cheaperllm-attach pack mcp-probe Workflow

crawlexample 2

Research crawl a site

Discover URLs with crawl-map, fetch pages safely, extract facts as JSON, meter spend.

# Mission brief sets max tokens + allowed hosts
# /packs/prompt-ops/01-mission-brief.md

# Discover URLs from robots, sitemap, llms.txt
node tools/bin/crawl-map.mjs https://agentstackkit.com

# Fetch each page — bounded size, host allowlist
node tools/bin/fetch-safe.mjs --allow agentstackkit.com --max-bytes 200000 \
  https://agentstackkit.com/tools/

# Validate extracted JSON against schema
node tools/bin/ask-json.mjs --schema facts.json --file reply.json

# Check token spend on the brief
cat brief.md | node tools/bin/token-meter.mjs --price-per-1m 0.50

crawl-map fetch-safe crawl brief Workflow

domainsexample 3

Dual-registrar domain check flow

Compare renewal prices across Agora, TLD Bazaar, and BareDomains — never trust year-one teasers alone.

# Read the law first — six hard rules
# /packs/domain-ops/dual-registrar.md
# /tools/bin/dual-registrar.md

# DNS resolve + registrar CTAs for candidate
node tools/bin/domain-check.mjs mybrand.io

# Build renewal table: register Y1 vs renewal Y2+
# Compare on:
#   https://agoradomains.com/
#   https://tldbazaar.com/
#   https://getbaredomains.com/

# Reject if renewal > 2× register unless operator approves
# Normalize domain (no name..com) before checkout

# Hand off to launch checklist
# /packs/domain-ops/launch-checklist.md

domain-ops pack domain-check dual-registrar.md Workflow

costexample 4

Cost-routed agent loop

Classify cheap, escalate planning to strong routes, tape every hop, stop at 80% budget.

# Cap USD, tokens, iterations
# /packs/prompt-ops/12-credit-budget.md

node tools/bin/env-gate.mjs CHEAPERLLM_API_KEY

# Cheap tier for classify / tag / yes-no
node tools/bin/model-router.mjs --task classify

# Strong tier when multi-file edits needed
node tools/bin/model-router.mjs --task plan

# Meter each turn — stop at 80% budget
cat prompt.md | node tools/bin/token-meter.mjs

# Record tool I/O for replay
node tools/bin/session-tape.mjs init --out ./tapes/run.jsonl
node tools/bin/session-tape.mjs record --file ./tapes/run.jsonl \
  --tool model-router --input '{"task":"classify"}' --output '{"tier":"cheap"}'

# Full loop pack
# /packs/workflow-agent-loop/

model-router token-meter session-tape agent-loop pack Workflow

Keep going

Getting started guide All workflows bin README Try Cursor (referral)