Machines CLI

Machines CLI lets you manage your Machines account from the terminal. Use it for login, identity verification, balance checks, crypto deposits, card management, agentic payments, and connecting AI apps.

Prerequisites

Node.js 18+
A Machines account

Install

npm i -g @machines-cash/cli

After installing, run machines to open the guided menu, or use commands directly.

Don’t want a global install? Use npx machines-cash@latest <command> for one-off commands.

Quick start

machines login

Opens your browser to authenticate. Your session is saved locally for future commands.

Verify your identity

machines user create --browser

Check your status anytime:

machines kyc status

Add money

machines deposit create --token USDC --network base --amount 25

Check your balance:

machines balance

Create a card

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

Buy something

machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --wait

If you already have an active Machines card and saved billing profile, you usually do not need to pass anything else.

Commands

machines login                              # browser login
machines login --no-launch-browser          # prints URL instead of opening browser
machines login --agent                      # CLI-only login for agents with wallets
machines logout                             # sign out

Balance and deposits

machines balance                            # check spending power
machines deposit assets                     # list supported tokens and networks
machines deposit create --token USDC --network base --amount 25
machines deposit show --id <deposit-id>     # check one deposit
machines deposit watch --id <deposit-id>    # poll until complete

Send only the exact token on the exact network shown. If a memo appears, include it exactly. CLI deposits are crypto only.

Identity verification

Browser-based (recommended):

machines user create --browser
machines kyc status

CLI-based (for automation):

machines user create --from-file ./kyc-user.json --open --wait

See Identity Verification for the full JSON format and field reference.

Cards

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

Disposable cards:

machines disposable create --amount-cents 5000 --auto-cancel-after-auth

Agentic payments

machines search "apple airpods pro"
machines search "kindle paperwhite"
machines search "ninja air fryer"
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q"
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --card "<card-label-or-last4>" --wait
machines agent status <action-id>
machines agent confirm <action-id>
machines agent 3ds <action-id> --code <code>

Notes:

shopping defaults to Amazon right now
machines search is the preferred command
machines browser still works as a compatibility alias
if --card is omitted, Machines uses your default active card and stored billing profile
--wait and --watch keep polling until the action pauses or finishes
use --payment-card-file <path|-> only for direct testing; never pass raw card numbers in flags

More examples:

machines search "lego botanical orchid"
machines search "anker usb c charger"
machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --wait --json

See Agentic Payments for the full purchase flow and API examples.

Connect an AI app

machines mcp install --host codex    # or: claude, copilot, chatgpt
machines mcp auth login
machines mcp doctor                  # check connection health

For step-by-step AI setup, see MCP Setup or Claude.

Agent output

Add --json to any command for structured output:

machines card list --json

This also works for commerce commands:

machines buy "https://www.amazon.com/dp/B0DGHMNQ5Q" --wait --json

Troubleshooting

Problem	Fix
Browser didn’t open	Use `--no-launch-browser` and open the URL manually
`user not found`	Complete identity verification first
`machines: command not found`	Run `npm i -g @machines-cash/cli` or use `npx machines-cash@latest`
Need full command list	Run `machines --help`

Next steps

MCP Setup — connect Machines to your AI app
Agentic Payments — one shared search, buy, status, confirm, and 3DS flow
Claude — recommended setup for Claude users
Raw Knowledge File — paste context into any AI for better responses

FAQ

MCP Setup

Updates

Start

Use Your Own AI

Agentic Payments

User API

User Auth API

User Crypto API

User KYC API

User Cards API

User Balances & Contracts API

User Deposits API

User Identity API

User Payments API

User Additional API

Prerequisites

Install

Quick start

Commands

Balance and deposits

Identity verification

Cards

Agentic payments

Connect an AI app

Agent output

Troubleshooting

Next steps

​Prerequisites

​Install

​Quick start

​Commands

​Login

​Balance and deposits

​Identity verification

​Cards

​Agentic payments

​Connect an AI app

​Agent output

​Troubleshooting

​Next steps

Prerequisites

Install

Quick start

Commands

Login

Balance and deposits

Identity verification

Cards

Agentic payments

Connect an AI app

Agent output

Troubleshooting

Next steps