OnWallet.
Docs Developers Add to Edge Add to Chrome

Quickstart

Remote connections are moving into a shared gateway and are not available right now. The desktop agent, for AI apps that run local programs on a Mac, is not available to download right now.

What you need

  • The OnWallet extension with a wallet created in it (or imported from recovery words). Wallets imported from a family seed cannot make agent wallets.
  • An AI app that supports MCP.

Remote: connect an AI app

Connecting an AI app by address is moving into a shared gateway at https://mcp.openapps.network/connect and is not available right now. See the gateway docs.

The remote server at https://mcp.openapps.network/openwallet was switched off on 5 October 2026. In the gateway, OnWallet's tools become operations on https://mcp.openapps.network/connect, with the scopes wallet:read and wallet:pay. A payment still goes to the person's extension for approval, exactly as before. The gateway docs will say when it opens.

Desktop: OnWallet Agent on a Mac

OnWallet Agent, the desktop program, is not available to download right now. This page describes how it works; its install instructions will be added here with the first download.

The desktop agent is a local MCP server (stdio) for macOS. AI apps that run local programs, such as Claude Code, Claude Desktop, Cursor and VS Code, start it with openwallet-agent mcp. Only install it from a link on this page.

Pair it with your wallet

# In a terminal, not in the chat.
openwallet-agent pair --network mainnet --label "Claude Code on MacBook"
  1. The program prints a pair request (owpair1.…) and five words.
  2. In the extension: Agents → Add agent. Paste the request and check that the five words match.
  3. Set the limits and the budget. The extension creates and funds the agent wallet and gives the agent's key permission to spend from it.
  4. The extension shows a grant token (owgrant1.…) and a second set of words. Paste the token at the program's prompt and compare the words.

The MCP tools never show pairing material, because a model could rewrite a token and its words together. Clients that auto-approve tool calls do not weaken payments: approvals happen in the agent, not in the client.