Introduction#
mechawallet is a wallet for agents. You fund a small burner with USDC; your agent pays any x402 endpoint from it with one call, never touching a key, a chain or gas; and when the job is done you burn it. The balance is the budget: if the agent goes wrong, it can lose what you funded and nothing else.
One wallet, three faces, the same actions on each:
- The dashboard, where you open, fund and burn wallets and read the receipts.
- The REST API under
https://api.mechawallet.com/v1/spending-wallets. - MCP at
https://api.mechawallet.com/mcp, for Claude and every other MCP client.
Base URL#
https://api.mechawallet.com
The site lives at mechawallet.com; everything programmable is on
api.mechawallet.com.
Authentication#
A wallet pays with its own key. Keys are shown in the dashboard and sent as a bearer token:
curl -X POST https://api.mechawallet.com/v1/spending-wallets/research/pay \
-H "Authorization: Bearer mw_wallet_your_key_here" \
-H "content-type: application/json" \
-d '{"url": "https://weather.example.net/x402/now?city=Lisbon"}'
| Prefix | What it can do |
|---|---|
mw_wallet_… |
pay from one wallet; read its balance and events; use its funding link |
mw_branch_… |
pay through a branch's rule; open more wallets in the branch |
mw_live_… |
an account key: pay from any wallet, open and burn wallets and branches |
mw_test_… |
an account key that can rehearse on /test checkouts and read, never spend |
A missing or revoked key returns 401. A key asked to do what it cannot
returns 403 with the reason. Sellers and the directory's buyers need no
key: a payment is its own login, and search_endpoints answers anyone.
What it costs#
Your first three wallets are free, then a small opening fee per wallet
taken from the wallet itself. A thousand payments a month are free, then a
fraction of a cent each, quoted before anything is signed. Funding through
a wallet's link costs the sender one cent; burning is free; there is no gas
anywhere. The numbers live on one page, Costs,
and at GET /v1/costs.
What we hold#
The wallet's key, encrypted, so an agent can pay without one. The balance is on the chain, in a burner you can empty at any time by revealing the key and phrase or by burning the wallet to an address of yours. Nothing is lent, staked or pooled, and we never earn on the balance. Keep only what a job will spend soon: a burner is not a savings account.
Where to go next#
| If you want to… | Read |
|---|---|
| See the whole thing with pictures | Start here |
| Understand wallets, branches and keys | Wallets, branches and keys |
| Fund a wallet or get money out | Funding and burning |
| Connect Claude or any MCP client | Connect Claude |
| Script it without a person in the loop | Automate spending |
| Run a team account | Organizations |
| Read every price | Costs |
| Sell to agents too, with escrow when a buyer wants recourse | Escrow |
Agents: start with llms.txt
/llms.txt is the whole service in plain text, in one
request: how to pay, how to connect, and the exact shapes. It is written
for you, not for a search engine.