Skip to main content

Agentic finance 101: The MoonPay CLI explainer

Use AI assistants to buy, swap, and manage crypto through a non-custodial wallet you control — no exchange login required.

Updated today

What is agentic finance?


Agentic finance is what happens when AI assistants can do more than answer questions about money — they can move it.

Not through a centralized account they control, and not by handing an AI your exchange login. Through a non-custodial wallet you own, with transactions you authorize, executed through an AI that operates as your agent.

The MoonPay CLI bridges the gap between "AI that knows about crypto" and "AI that can act on crypto."

What is the MoonPay CLI?


The MoonPay CLI (@moonpay/cli, invoked as mp) is a command-line interface that exposes MoonPay's full financial stack to AI assistants.

It works as an MCP (Model Context Protocol) server — a standard that lets AI tools like Claude, Cursor, and OpenClaw call external tools through a consistent interface. When you connect the MoonPay CLI to Claude, Claude gains access to financial tools it can invoke on your behalf.

Those tools cover the full crypto stack:

  • Buying crypto with fiat via onramp

  • Swapping and bridging tokens across chains

  • Non-custodial wallet management

  • Automated DCA via virtual accounts

  • Prediction market trading on Polymarket, Kalshi, and D/Flow

  • Yield strategies via yield.xyz and Zyfai

  • On-chain data and analytics via Dune

  • Micropayments to x402-protected APIs

  • Hardware wallet signing via Ledger

Note: The capabilities listed above reflect the current release. New tools and integrations are added regularly — run mp tools to see everything available in your installed version.

Tip: Ready to get set up? See MoonPay CLI for AI agents for full installation, authentication, and wallet setup instructions.

What is a skill?


Skills are modular extensions to the CLI, each purpose-built for a specific workflow.

Think of the base CLI as the execution engine and skills as the playbooks. A skill packages together the right sequence of tool calls, prompts, and logic for a common task, and makes it available as a slash command inside your AI assistant.

  • /moonpay-iron-dca — sets up a full DCA strategy

  • /moonpay-polymarket-ready — funds a Polygon wallet for trading

  • /moonpay-missions — interactive walkthrough of everything

Skills install automatically with the CLI. You don't configure them — you just run them.

Tip: Want to explore everything skills can do? Check out our full skills guide.

How it works end-to-end


Step 1: Install the CLI

</> Bash
npm install -g @moonpay/cli

Step 2: Connect to your AI assistant

Add MoonPay as an MCP server in Claude, Cursor, or any MCP-compatible tool.

Note: During authentication, you can create a new non-custodial wallet or import an existing one using your mnemonic or private key.

Step 3: Authenticate

Run /moonpay-auth to create or import a non-custodial wallet.

Step 4: Use plain English

Describe what you want to do. The AI selects and calls the right tools.

Step 5: Confirm

Transactions are presented for your review before execution.

The AI plans. You approve. The CLI executes.

What you can do with it


Here are some examples of what you can ask your AI assistant:

  • Swap tokens — "Swap $200 of ETH to SOL."

  • Check your portfolio — "What's my wallet worth? Break it down by token."

  • Set up automated DCA — "I want to buy $50 of SOL every day for 30 days using my Iron account."

  • Trade prediction markets — "What does Polymarket give as the probability of a Fed rate cut before June? Buy $25 YES if it's above 50%."

  • Research a token before buying — "Is this token safe? Run a check on mint address X."

  • Earn yield — "What's the current APY on USDC at yield.xyz? Move $500 from my wallet into the best option."

  • Pay for an x402 API — "Make a request to this endpoint and pay the access fee automatically."

Is it safe?


The CLI is non-custodial. When you create a wallet through /moonpay-auth, you hold the private keys — MoonPay never does. Swaps, DCA purchases, and bridged assets all settle to your wallet address.

Important: The CLI is non-custodial — your private keys are yours alone. MoonPay cannot recover them if lost. Back up your wallet mnemonic securely before funding your wallet.

Tip: For maximum security, connect a Ledger hardware wallet during setup. Every transaction your agent initiates will require physical confirmation on your device before it can be signed.

How it compares to a traditional exchange


Exchange

MoonPay CLI

Custody

Exchange holds funds

You hold keys

Interface

Dashboard or app

Conversational

Multi-chain

Usually one chain

Cross-chain native

Automation

Limited recurring buys

DCA, stop loss, alerts

Prediction markets

Rarely

Polymarket, Kalshi, D/Flow

Composability

Closed ecosystem

Open skills architecture

Tip: See what others are building with the MoonPay CLI — from automated DCA strategies to prediction market trading agents. Browse the following use cases:

Get started


Install the CLI:

</> Bash
npm install -g @moonpay/cli

Then open Claude and type /moonpay-missions for a 15-minute interactive walkthrough of everything the CLI can do.

Or jump straight to what you need:

I want to…

Run this

Check my wallet

/moonpay-check-wallet

Swap tokens

/moonpay-swap-tokens

Set up a DCA

/moonpay-iron-dca

Trade Polymarket

/moonpay-polymarket-ready

Research a token

/moonpay-discover-tokens

Connect a Ledger

/moonpay-auth

FAQs


Do I need to create a new wallet?

No. During /moonpay-auth you can either create a new non-custodial wallet or import an existing one.

Which AI assistants are supported?

The CLI works with any MCP-compatible tool, including Claude and Cursor.

Does MoonPay ever hold my funds?

No. The CLI is non-custodial — your private keys stay with you at all times.

Did this answer your question?