Skip to main content
Use the Machines CLI when you want the fastest path from terminal to real account actions. It is made for both:
  • humans who want simple copy/paste commands
  • agents and automation that need --json output

​
What you can do

  • log in
  • submit KYC in one command
  • open and track KYC verification
  • create, update, and delete cards
  • reveal card details when needed
  • create disposable cards
  • install MCP for Codex, Claude, Copilot, or ChatGPT

​
Quick start

1

1) Log in

npx machines@latest login
This opens your browser by default.
2

2) Submit KYC in one command

npx machines@latest create user --name=john --lastname=doe --birth-date=1990-01-01 --country-of-issue=US --national-id=123456789 --email=john@example.com --line1="123 main st" --city="new york" --region=NY --postal-code=10001 --country-code=US --occupation=SELFEMP --annual-salary="50k-99k" --account-purpose=testing --expected-monthly-volume="under-$1k" --open --wait
For US and CA, --national-id is required.
3

3) Create your first card

npx machines@latest card create --name "ads-bot" --limit 250 --frequency per30DayPeriod

​
Most-used commands

# Login
npx machines@latest login
npx machines@latest login --browser --no-launch-browser
npx machines@latest login --agent

# KYC and user setup
npx machines@latest user create --name=john --lastname=doe ...
npx machines@latest create user --name=john --lastname=doe ...
npx machines@latest kyc status
npx machines@latest kyc open --no-launch-browser
npx machines@latest kyc wait --interval-seconds 5 --timeout-seconds 900

# Cards
npx machines@latest card create --name "ads-bot" --limit 250 --frequency per30DayPeriod
npx machines@latest card list
npx machines@latest card reveal --last4 4242
npx machines@latest card update --last4 4242 --name "ads-bot-v2"
npx machines@latest card lock --last4 4242
npx machines@latest card unlock --last4 4242
npx machines@latest card limit set --last4 4242 --amount 500 --frequency per30DayPeriod
npx machines@latest card delete --last4 4242

# Disposable card
npx machines@latest disposable create --amount-cents 5000 --auto-cancel-after-auth

# MCP setup
npx machines@latest mcp install --host codex
npx machines@latest mcp install --host claude
npx machines@latest mcp install --host copilot
npx machines@latest mcp install --host chatgpt
npx machines@latest mcp auth login
npx machines@latest mcp doctor

# Full health check
npx machines@latest doctor

​
Output modes

  • default: human-readable output
  • --json: machine-friendly output for scripts and agents
Example: 
npx machines@latest card list --json

​
KYC flow in plain language

  1. You submit profile details with create user.
  2. Machines sends this to Rain.
  3. Rain returns a hosted verification link (Sumsub).
  4. You complete ID + selfie on that external page.
  5. Status updates by webhook; CLI can poll with kyc wait.

​
Use a JSON file instead of long flags

npx machines@latest user create --from-file ./kyc-user.json --open --wait
You can also pass JSON inline: 
npx machines@latest user create --payload '{"firstName":"john","lastName":"doe", ...}'

​
Troubleshooting

  • user not found: finish onboarding/KYC first, then retry.
  • Browser did not open: use --no-launch-browser and open the link manually.
  • Need command list: run npx machines@latest --help.

​
Legacy note

If you already use @machines-cash/agent-skill, it still works as a compatibility wrapper. Need MCP-only setup? See Connect Your AI (MCP).
Need Clawdbot-specific steps? See Clawdbot.