How to use Obelisk
About five minutes to set up. After that you give the agent tasks in plain words.
1. Get a wallet ready
Use any browser wallet that supports custom networks, such as MetaMask, OKX Wallet or Rabby. The app adds BNB Chain for you when you connect.
You need two things on BNB Chain: a little BNB for gas (about $2 is plenty) and some USDC, the dollar stablecoin your vault uses. Check that the token address is 0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168, since other tokens use similar names.
2. Create a vault
- Max per transaction: the largest amount the agent may spend in one go.
- Max per day: the total it may spend in one day. It resets at 00:00 UTC.
- People the agent may pay: optional. Leave it empty if you only want swaps.
Your wallet asks twice: once to create the vault (a small gas fee) and once to sign a message that registers it with the agent (free). Start with small limits while you try it out.
3. Add funds
Enter an amount under Funds and press Deposit. You can withdraw at any time, with or without the agent.
4. Give it tasks
- swap 5 USDC to BNB swaps through the approved exchange. The BNB returns to your vault.
- pay Alex 10 USDC works if Alex is on your list of people it may pay.
- what is my balance? answers right away.
A task that breaks your rules is refused within seconds and nothing is sent. A task that follows them waits for its proof, usually a minute or two per step (up to about 15 minutes when the GPU prover is offline). Your first swap takes two steps (an allowance for the exchange, then the swap), and so does any swap after that allowance is used up. You can close the page while it runs.
5. Stay in control
- Scheduled tasks run on their own, for example a daily swap. Each run needs its own proof.
- Stop the agent with one click under Safety. Nothing can run on that vault until you allow it again.
- Withdraw your USDC or the swapped BNB back to your wallet whenever you want.
6. Use it from your own AI agent
Already have an agent (Claude, ChatGPT, a script or any framework)? Give it an agent key instead of your wallet. In the app, open your vault, go to Agent keys and create one. The key can ask for swaps into BNB, payments to your payees and the balance. It cannot withdraw, change the rules or add keys, and every action it asks for still needs a proof that it follows your rules. Revoke it any time.
- Claude Desktop, Cursor and other MCP clients: add the @obeliskmoney/mcp server with the key. The app shows the configuration when you create the key.
- TypeScript: npm install @obeliskmoney/agent-sdk, then obelisk.swap("2").
- Any language: a signed HTTP request per task. Developer guide.
Open the app or read how Obelisk is secured.