Commands
The Mercado Pago CLI provides commands to operate our main integrable products directly from the terminal. Check the commands available by product, how to use them, and the complete reference for each one.
Commands by product
| Command | Availability by product(s) |
mp payments, mp cards | Checkout API |
mp preferences | Checkout Pro |
mp orders | Checkout Pro Checkout API |
mp merchant-orders | Marketplace |
mp subscriptions, mp subscription-plans | Subscriptions |
mp pos, mp stores | Point QR code |
mp chargebacks | All products. |
mp reports releases, mp reports settlements | All products. |
mp oauth | All products. |
How to use commands
All CLI commands follow the pattern mp [resource] [action] [flags]. You can check the available options for any command using the --help flag:
bash
mp --help mp payments --help
Output format
By default, all commands return a JSON:
bash
mp payments list # { "status": "success", "data": { "results": [...] } }
For a readable tabular output, use the --table flag. See an example below:
bash
$ mp payments list --table ID STATUS AMOUNT METHOD DATE 12345678 approved $ 99.90 account_money 2025-01-01T...
Global flags
Any command accepts the following flags to control output format, authentication, or specific interactive behavior. Learn more about each one:
| Flag | Shortcut | Description |
--table | — | Formatted tabular output. |
--silent | -s | Suppress spinners and ANSI colors. |
--verbose | -v | Display HTTP headers. |
--profile | -p | Credentials profile to use. |
--idempotency-key | — | Idempotency key for POST/PUT. |
--data | — | Request body via JSON file (@payload.json). |
--no-interactive | — | Disable prompts (CI/CD). |
--no-color | — | Disable colored output. |
Exit codes
In scripts and pipelines, the Mercado Pago CLI returns an exit code at the end of each execution. Use these values to handle errors programmatically:
| Code | Meaning |
0 | Success. |
1 | General error. |
2 | Authentication error. |
3 | Validation error. |
4 | Rate limit. |
mp docs [product] — for example, mp docs payments.