Control the running 1Sat desktop wallet via MCP. Use this proactively whenever the user mentions their wallet, BSV balance, ordinals, inscriptions, tokens, sending BSV, browsing the 1Sat app, or any blockchain task that could be done through the wallet UI. The 1sat plugin ships .mcp.json automatically — if the plugin is installed and the wallet app is running, tools are available immediately with no manual setup. Requires the 1Sat wallet-desktop app to be running.
From 1satnpx claudepluginhub b-open-io/claude-plugins --plugin 1satThis skill uses the workspace's default tool permissions.
Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
The 1Sat desktop wallet exposes an MCP server on 127.0.0.1:3322 when running. It provides 25 tools for browser automation, blockchain data queries, and wallet operations. Authentication is handled automatically by 1sat mcp-proxy.
If the 1sat Claude Code plugin is installed, the .mcp.json is already configured. No manual steps — install the CLI, launch the wallet, MCP tools appear automatically.
Install the 1Sat CLI globally:
bun install -g @1sat/cli
Launch the 1Sat wallet desktop app. The MCP server starts on 127.0.0.1:3322 automatically.
MCP tools appear in Claude Code. The 1sat plugin ships .mcp.json. Restart Claude Code to pick it up.
Verify the server is reachable:
curl -s http://127.0.0.1:3322/
Expected: {"name":"1sat-browser","version":"0.0.1","transport":"streamable-http","auth":"brc-31"}
1sat mcp-proxy CommandThe .mcp.json runs 1sat mcp-proxy. This command:
~/.1sat-wallet/mcp-agent.keyFor manual testing: 1sat mcp-proxy
wallet_balance — get current balancewallet_send_bsv — send to recipientwallet_balance — confirm new balancewallet_ordinals — list owned ordinalsinscription_metadata — get full metadata for an inscriptionbrowser_navigate with 1sat://ordinals/gallery — open visual gallerywallet_tokens — list owned BSV-21 tokenstoken_balances — balance for a specific tickermarketplace_listings — current OrdLock listingsbrowser_navigate with any 1sat:// URL:
1sat://wallet/send — send flow1sat://ordinals/gallery — collection1sat://identity/profile — BAP identitybrowser_navigate — load a pagebrowser_get_page_text — extract textbrowser_execute_js — deeper inspection| Tool | Description |
|---|---|
browser_open | Open a URL in a new browser window |
browser_close | Close a browser window |
browser_list_windows | List all open browser windows |
browser_navigate | Navigate current window to a URL |
browser_go_back | Go back in browser history |
browser_go_forward | Go forward in browser history |
browser_execute_js | Execute JavaScript in the browser context |
browser_get_page_text | Get the text content of the current page |
| Tool | Description |
|---|---|
tab_list | List all open tabs |
tab_create | Create a new tab |
tab_close | Close a tab |
tab_navigate | Navigate a tab to a URL |
tab_activate | Switch to a tab |
tab_go_back | Go back in a tab's history |
tab_reload | Reload a tab |
| Tool | Description |
|---|---|
inscription_metadata | Get metadata for an inscription (via ORDFS) |
marketplace_listings | Query OrdLock marketplace listings |
token_balances | Get BSV-21 token balances |
listing_lookup | Look up a specific marketplace listing |
| Tool | Description |
|---|---|
wallet_status | Get wallet lock/unlock status |
wallet_balance | Get BSV balance |
wallet_identity | Get the wallet's BAP identity |
wallet_ordinals | List owned ordinals/inscriptions |
wallet_tokens | List owned BSV-21 tokens |
wallet_send_bsv | Send BSV to an address |
1sat://wallet/overview — wallet dashboard1sat://wallet/send — send BSV flow1sat://wallet/receive — receive address + QR1sat://wallet/history — transaction history1sat://ordinals/gallery — ordinals collection1sat://tokens/all — token portfolio1sat://identity/profile — BAP identity1sat://settings — app settings1sat://social/feed — BSV social timeline1sat://chat — messagingIf MCP tools aren't appearing in Claude Code:
curl -s http://127.0.0.1:3322/.mcp.json.The 1sat mcp-proxy exits with code 1 if it can't reach 127.0.0.1:3322:
Launch the 1Sat wallet app and unlock it, then restart Claude Code.
If wallet_balance, wallet_ordinals, etc. return errors:
wallet_status to check — if locked, the user needs to unlock via Touch ID in the app