mechawallet_
Get started

Quickstart#

From nothing to a paid call, in about five minutes. The first payment is a rehearsal that moves no money.

1. Open a wallet#

Sign in at mechawallet.com/login. The first screen is the wallet screen: pick Base, name it research, tick the line that says a wallet is a tool for an agent to pay with and not a place to keep money, and press Open my wallet. The card shows the wallet's address and its key, mw_wallet_…. Copy the key now; it is shown again whenever you ask, in the dashboard only.

2. Connect your agent#

claude mcp add --transport http mechawallet https://api.mechawallet.com/mcp \
  --header "Authorization: Bearer $MW_KEY"

Settings, Connectors, Add custom connector, paste https://api.mechawallet.com/mcp, approve.

curl https://api.mechawallet.com/v1/spending-wallets/research/budget \
  -H "Authorization: Bearer $MW_KEY"

spending_budget, or the budget route above, answers with the wallet this key pays from, whether it is ready or still waiting for its first dollar, its rules, and the fee rule.

3. Rehearse, free#

The dashboard shows a rehearsal line. Paste it into your agent:

Buy this for me from my research wallet, up to $0.10: https://api.mechawallet.com/c/chk_…/test

Or by hand:

curl -X POST https://api.mechawallet.com/v1/spending-wallets/research/pay \
  -H "Authorization: Bearer $MW_KEY" -H "content-type: application/json" \
  -d '{"url": "https://api.mechawallet.com/c/chk_…/test"}'

The /test face settles with a synthetic receipt and no funds, from an empty wallet. You have seen the whole loop before anything is at stake.

4. Fund it#

Send money to on the card: pick $5 and use the door that matches where your USDC is (a browser wallet, a phone, the QR, or the address the plain way). Press Check balance when it is sent. The wallet wakes when it has held a dollar.

5. Pay something real#

Find a weather endpoint under five cents and get me Lisbon's forecast.

Your agent calls search_endpoints("weather"), picks a row, and pay_x402(url) returns the goods with a receipt. By hand, the same is POST /v1/spending-wallets/research/pay with the row's url. Read what happened under Activity, or with spending_wallet_events.

6. Burn it when the job is done#

Set a burn address once under Account, Profile and page. Then Burn on the card: anything owed is collected, the rest goes to your address, the wallet closes and its history moves to Archive. The next job gets a fresh wallet.

What next#