OurPay Wallet
One account-owned crypto wallet for you and your authorized AI agents. Sign in to the same OurPay account from ChatGPT, Claude, a coding agent or a compatible application to use the same wallet, with separately revocable connections.
57 tools · 6 native packages · 18 client profiles · 5 model tool formats · 4 framework examples
Open wallet · Connect an agent · Release downloads · All tools
What it can do
| Area | Implemented capabilities |
|---|---|
| Account and wallet | Account sign-in, EVM/Solana addresses, supported-network and asset discovery, balances, owner recovery and revocable agent connections |
| Transfers | Native currency, ERC-20 and standard SPL transfers, receipt tracking and durable retries |
| Conversion | Supported same-chain swaps and EVM/Solana cross-chain routes with explicit minimum output, slippage and fee limits |
| Funding | Discover native USDC and quote gas, destination USDC or mainnet Hyperliquid collateral funding; continue multi-leg routes using actual received amounts |
| Merchant purchases | Search eligible OurPay products, open candidate checkouts, inspect details, prepare crypto invoices, quote/convert/pay and track the canonical order |
| EVM applications | Simulated sequential contract calls, personal/EIP-712 signatures, app grants, read-only RPC, an Ethereum provider and WalletConnect adapter |
| Shared data and plans | Shared market feed, cursor/long-poll updates and server-run bounded trading plans; see TRADING.md |
| Hyperliquid | Spot/default/HIP-3 market discovery, book/candle/trade snapshots, account and fee data, isolated or supported cross margin, leverage, GTC/ALO/IOC and native perpetual stop-loss/take-profit orders, concurrent independent orders, cancellation and fills |
| Owner control | Standard-mode action approval with email review links, shared daily allowance, owner-enabled Risky mode, pause and disconnect |
Availability depends on enabled networks, exact assets/markets, liquidity, provider/venue state and owner permissions. General wallet signing is not a complete integration with every dApp. Persistent plans execute bounded instructions; they do not host an LLM that invents or revises strategies. Complete Polymarket trading, arbitrary internet checkout and fiat/card/UPI payments remain outside the wallet. Full capability boundaries.
Connect with OAuth
Add this Streamable HTTP MCP server to a host that supports remote MCP with OAuth:
https://mcp.ourpay.dev/wallet/mcp
Use the full /wallet/mcp path. Follow OurPay sign-in and consent, using the account that owns your wallet. The host's plan, version and administrator settings can affect connector availability. Custom-connector support and repository installation are separate from vendor public-directory approval.
Then ask:
Call
ourpay_wallet_guidewith topicoverview, then read my wallet and supported networks. Do not submit any payment, signature or trade.
The guide provides task-specific instructions. A fresh 0.11.0 catalog has 57 tools: three checkout tools and 54 wallet tools. Purchase tools support bounded USDC subscriptions with explicit recurring consent and automatic settlement progress. Restart a host that cached an older schema; update the executable as well if using a local package. An ordinary tool update does not require a new wallet. Refresh and troubleshooting.
Install in coding agents
Local packages require Node.js 24 or newer and include the MCP runtime. The server does not need a merchant API key or an npm install to run. Its first wallet call returns account authorization; it does not ask for your recovery phrase.
Claude Code
claude plugin marketplace add Ourpay/ourpay-wallet
claude plugin install ourpay-wallet@ourpay
Codex
Add the public repository marketplace, then install ourpay-wallet from OurPay in the plugin browser:
codex plugin marketplace add https://github.com/Ourpay/ourpay-wallet.git
Gemini CLI
gemini extensions install https://github.com/Ourpay/ourpay-wallet
GitHub Copilot CLI
The repository root implements the portable Agent Plugins format:
copilot plugin install Ourpay/ourpay-wallet
Cursor and Claude Desktop
Use their native release packages from downloads. Cursor includes a local plugin manifest; Claude Desktop uses .mcpb. If a managed runtime is older than Node 24, use the generated configuration with a compatible external Node executable.
OpenCode and other hosts
OpenCode can use the hosted OAuth URL directly. The complete integrations archive generates profiles for Codex, Claude Code, Claude Desktop, Cursor, VS Code/Copilot, Windsurf, Cline, Roo Code, Continue, Gemini CLI, OpenCode, Kiro, Goose, Zed, Copilot CLI, LM Studio, Kilo and generic MCP clients.
From the complete extracted bundle:
node configure.mjs --list
node configure.mjs --target opencode --transport remote
node configure.mjs --target all --out ./local-configs
Merge the generated server entry into your existing configuration. Do not replace unrelated servers. Private local connection files must remain on your machine and persist across restarts. The SDK is not published on npm; do not use npx @ourpay/agent-wallets as an installation method. Complete integration instructions.
Fund once, then authorize the task
Send the correct asset to the wallet address for your chosen network. EVM networks share one EVM address; Solana uses another. Every chain's balance remains separate.
Agents can use native USDC on enabled Ethereum, Optimism, Polygon, Base, Arbitrum and Avalanche networks to obtain gas or mainnet Hyperliquid collateral through supported funding routes. Fees come from the authorized USDC input. Routes, minimum sizes and liquidity still matter; this does not provide free gas or universal support for every chain. Solana can receive gas through supported routes but is not a zero-SOL USDC gasless source.
HyperCore exchange collateral, HyperEVM HYPE and on-chain USDC are distinct balances. A funding quote does not prove delivery, and an exchange account value does not mean all collateral is withdrawable. Funding and settlement workflow.
Permissions and recovery
Standard mode requires owner review for new payments, trades, contract submissions, signatures and app connections. OurPay sends an email review link and returns the owner URL to the agent. The default $10,000 daily USD allowance is shared across agents and resets at 00:00 UTC; owners can adjust it. Reservations are authorization estimates, not maximum-loss guarantees.
Owner-enabled Risky mode skips supported per-action approvals and shared spending restrictions. Pause, revocation, supported-action validation and the host's own controls still apply. It does not authorize an agent to invent a trading strategy or spend outside your task.
Save the initial recovery phrase privately. You can reveal it later in wallet Settings after recent owner authentication. OurPay retains an encrypted backup; the owner-held phrase is an independent backup. Agents never receive it. Recovery preserves addresses and revokes prior connections. Owner guide.
Agent and developer documentation
| Document | Contents |
|---|---|
| USER_GUIDE.md | Setup, wallet screens, funds, recovery, Hyperliquid website connection and controls |
| INTEGRATIONS.md | Host configs, OpenCode, OAuth, local credentials, model adapters, frameworks and upgrades |
| WORKFLOWS.md | Exact amount units, approval handling, funding, purchases, trading, retries and completion evidence |
| PROTOCOLS.md | Supported networks/protocols, Hyperliquid details, provider/WalletConnect behavior and limitations |
| TOOLS.md | All 57 canonical tools, descriptions and complete input JSON Schemas |
| TROUBLESHOOTING.md | Cached tools, sign-in, approvals, gas/route failures, stale data and uncertain orders |
| TESTING.md | Test commands, skipped/live distinctions and what an end-to-end pass requires |
| RELEASE_VERIFICATION.md | v0.10.0 deployments, live client discovery, benchmarks and verification limits |
| DISTRIBUTION.md | Public distribution routes and vendor-review boundaries |
| CHANGELOG.md | Versioned changes and repository documentation updates |
| Agent skill | Task-oriented instructions and packaged references |
Model adapters support OpenAI Responses, Chat Completions-compatible function tools, Anthropic Messages, Gemini and tool-capable Ollama models. Framework examples cover OpenAI Agents SDK, LangChain/LangGraph, PydanticAI and Google ADK. The application supplies its model credentials, tool filters and execution loop; the wallet does not select a model or run a strategy for it.
Source and verification
Build the distributed SDK source with Node 24+:
cd source
npm ci
npm run build
The application repository owns the full tests and generation pipeline; this public repository includes the SDK source, plugin manifests, packaged runtime and documentation. Local packaging/schema/fixture tests, live read checks and funded execution are different evidence. See the v0.10.0 release verification for live deployments, all 57 tools observed in ChatGPT, snapshot benchmarks and the funded acceptance tests that remain unverified. Earlier release evidence remains in TESTING.md.
Documentation on main can be newer than a tagged package. Tags, archives and checksums remain fixed; changes to this README do not upgrade an installed executable. Pin a reviewed tag/commit for reproducible Git installs and use the matching release archive when updating a runtime.
Licensed under Apache-2.0. Bundled dependencies are documented in THIRD_PARTY_NOTICES.txt. No recovery phrase, connection credential or backend custody secret belongs in this repository.