https://github.com/casualsecurityinc/xno-skills
(BETA) AI agent Skills, CLI and MCP server for Nano (XNO). Generate wallets, convert units, validate addresses, QR codes.
https://github.com/casualsecurityinc/xno-skills
ai-agents developer-tools mcp nano nanocurrency skills xno
Last synced: 11 days ago
JSON representation
(BETA) AI agent Skills, CLI and MCP server for Nano (XNO). Generate wallets, convert units, validate addresses, QR codes.
- Host: GitHub
- URL: https://github.com/casualsecurityinc/xno-skills
- Owner: CasualSecurityInc
- License: mit
- Created: 2026-03-14T07:41:42.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-25T11:37:30.000Z (about 1 month ago)
- Last Synced: 2026-04-25T13:32:22.231Z (about 1 month ago)
- Topics: ai-agents, developer-tools, mcp, nano, nanocurrency, skills, xno
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/xno-skills
- Size: 1.14 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# xno-skills
[](https://www.npmjs.com/package/xno-skills)
[](https://opensource.org/licenses/MIT)
[](https://www.typescriptlang.org/)
A CLI, MCP server, and AI skills for [Nano](https://nano.org/) (XNO). Built on top of [Open Wallet Standard (OWS)](https://github.com/open-wallet-standard/core) for secure key custody.
## Agent Skills
[](https://smithery.ai/servers/casualsecurityinc/xno-skills)
[](https://skills.sh/casualsecurityinc/xno-skills)
Built-in skill for Personal AI Agents (OpenClaw etc.) and humans with AI Coding Assistants (Claude Code, Cursor, etc.) alike:
```bash
npx skills add CasualSecurityInc/xno-skills -g
# or non-interactively, i.e. for agent use:
npx -y skills add CasualSecurityInc/xno-skills -g -y --all
```
> [!IMPORTANT]
> If you installed skills from this repository before May 4, 2026, you have 11 individual `nano-*` skills that have been consolidated into a single `nano` skill. Remove the old ones first:
> ```bash
> npx skills remove nano-block-lattice-expert nano-check-balance nano-convert-units nano-create-wallet nano-generate-qr nano-mcp-wallet nano-request-payment nano-return-funds nano-sign-message nano-validate-address nano-verify-message -g -y
> ```
> Then reinstall as above.
Available skills:
- `nano`: Wallet ops, balance, send/receive, QR codes, address validation, unit conversion, payment requests, refunds, block-lattice protocol expertise, and more — all in one skill. Uses `xno-mcp` MCP tools first, falls back to `xno-skills` CLI.
## CLI
### Installation & Upgrades
To install or upgrade the CLI, AI agent skills, and wallet dependencies to the latest version, run:
```bash
npm install -g xno-skills && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
xno-skills --help
```
To pin to the current stable release instead:
```bash
npm install -g xno-skills@3.2.6 && npx -y skills add CasualSecurityInc/xno-skills -g -y --all
```
### Wallet Operations
| Command | Description |
|---|---|
| `wallets [options]` | List wallets that have Nano accounts |
| `balance [options]` | Show balance and pending amount |
| `receive [options]` | Receive pending blocks |
| `send [options]` | Send Nano |
| `change-rep [options]` | Submit a change representative block |
| `submit-block [options]` | Sign and submit a prepared block hex |
| `history [options]` | Show transaction history |
### Utilities
| Command | Description |
|---|---|
| `info [options]` | Discover the current state and representative of any Nano account |
| `convert [options] ` | Convert between XNO units |
| `qr [options]
` | Generate a QR code for a Nano address |
| `validate [options] ` | Validate a Nano address or block hash |
### Cryptography & Signing
| Command | Description |
|---|---|
| `sign [options] ` | Sign a NOMS message with a private key |
| `verify [options]
` | Verify a NOMS message signature |
### Advanced & RPC
| Command | Description |
|---|---|
| `rpc` | Query a Nano node RPC |
| `block` | Build unsigned Nano state blocks for manual/expert workflows |
### System
| Command | Description |
|---|---|
| `about` | Show version and environment info for troubleshooting |
| `mcp` | Start the MCP server or view configuration instructions |
All commands support `-j` / `--json` for machine-readable output.
Wallet lifecycle (create, import, rename, delete) is managed by [OWS](https://github.com/open-wallet-standard/core). `xno-skills` bundles OWS as a dependency — no separate install needed. See the [OWS quick-start](https://openwallet.sh/#quickstart) for terminal usage, or install OWS agent skills with `npx skills add open-wallet-standard/core@ows`.
## MCP Server
Exposes Nano wallet functions as tools for AI agents (Claude Desktop, Cursor, Codex, etc.). MCP resources (`xno-wallet://` URIs) are served but require client-side `resources/read` support — not yet available in OpenCode ([#15535](https://github.com/anomalyco/opencode/issues/15535)).
```json
{
"mcpServers": {
"nano": {
"command": "npx",
"args": ["-y", "-p", "xno-skills@3.2.6", "xno-mcp"]
}
}
}
```
### Client Setup Examples
Codex
```bash
codex mcp add nano \
-c sandbox_mode="danger-full-access" \
-c 'sandbox_permissions=["network-access"]' \
-- npx -y -p xno-skills@3.2.6 xno-mcp
```
Claude Desktop (claude_desktop_config.json)
```json
{
"mcpServers": {
"nano": {
"command": "npx",
"args": ["-y", "-p", "xno-skills@3.2.6", "xno-mcp"]
}
}
}
```
OpenCode (~/.config/opencode/opencode.json)
```jsonc
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"nano": {
"type": "local",
"command": ["npx", "-y", "-p", "xno-skills@3.2.6", "xno-mcp"],
"enabled": true
}
}
}
```
Gemini CLI (~/.gemini/settings.json)
```json
{
"mcpServers": {
"nano": {
"command": "npx",
"args": ["-y", "-p", "xno-skills@3.2.6", "xno-mcp"]
}
}
}
```
Antigravity (~/.gemini/antigravity/mcp_config.json)
```json
{
"mcpServers": {
"nano": {
"command": "npx",
"args": ["-y", "-p", "xno-skills@3.2.6", "xno-mcp"]
}
}
}
```
VS Code (.vscode/mcp.json)
```json
{
"servers": {
"nano": {
"type": "stdio",
"command": "npx",
"args": ["-y", "-p", "xno-skills@3.2.6", "xno-mcp"]
}
}
}
```
## Library
For using `xno-skills` as a TypeScript library, see [LIBRARY.md](./LIBRARY.md).
## Security Notes
- **Never share your seed or private keys.** Anyone with access can fully control your wallet.
- **Store seeds securely.** Use hardware wallets or encrypted storage — never in plain text or version control.
- **Address validation.** Always validate addresses before sending. Nano addresses include checksums.
- **Unit precision.** Nano uses 30 decimal places. Always use string-based conversion to avoid floating-point errors.
## Development
```bash
npm install
npm test
npm run build
```
## Releasing
See `RELEASING.md`.
## Similar Projects
- [kilkelly/nano-currency-mcp-server](https://github.com/kilkelly/nano-currency-mcp-server) — MCP server for Nano with a simple per-transaction send limit
- [strawberry-labs/berrypay-cli](https://github.com/strawberry-labs/berrypay-cli) — Nano wallet CLI for AI agents with payment processing and auto-sweep
## License
MIT