# Xno Skills

> AI agent Skill, MCP server, and CLI for transacting in the Nano (XNO) cryptocurrency. Manage wallets securely via OWS, sign messages, and build seamless zero-fee integrations.

- **Type:** MCP server
- **Install:** `agentstack add mcp-casualsecurityinc-xno-skills`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [CasualSecurityInc](https://agentstack.voostack.com/s/casualsecurityinc)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [CasualSecurityInc](https://github.com/CasualSecurityInc)
- **Source:** https://github.com/CasualSecurityInc/xno-skills
- **Website:** https://www.npmjs.com/package/xno-skills

## Install

```sh
agentstack add mcp-casualsecurityinc-xno-skills
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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
```

### Claude Code

```
/plugin marketplace add CasualSecurityInc/xno-skills
/plugin install xno-skills@casual-security-inc
```

> [!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@4.4.0 && 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 |
| `rpc probe-caps [url]` | Probe one or more comma-separated RPC URLs for JSON RPC, ledger-read, process, and remote PoW support |
| `block` | Build unsigned Nano state blocks for manual/expert workflows |

### System

| Command | Description |
|---|---|
| `diag` | Show version, environment, effective RPC/work URLs, and local PoW recommendation without network probes |
| `mcp` | Start the MCP server or view configuration instructions |

All commands support `-j` / `--json` for machine-readable output.

Use `diag` for local configuration diagnostics. Use `rpc probe-caps ` when you need live endpoint capability checks, including `work_generate` support.

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@4.4.0", "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@4.4.0 xno-mcp
```

Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nano": {
      "command": "npx",
      "args": ["-y", "-p", "xno-skills@4.4.0", "xno-mcp"]
    }
  }
}
```

OpenCode (~/.config/opencode/opencode.json)

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nano": {
      "type": "local",
      "command": ["npx", "-y", "-p", "xno-skills@4.4.0", "xno-mcp"],
      "enabled": true
    }
  }
}
```

Gemini CLI (~/.gemini/settings.json)

```json
{
  "mcpServers": {
    "nano": {
      "command": "npx",
      "args": ["-y", "-p", "xno-skills@4.4.0", "xno-mcp"]
    }
  }
}
```

Antigravity (~/.gemini/antigravity/mcp_config.json)

```json
{
  "mcpServers": {
    "nano": {
      "command": "npx",
      "args": ["-y", "-p", "xno-skills@4.4.0", "xno-mcp"]
    }
  }
}
```

VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nano": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "-p", "xno-skills@4.4.0", "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

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [CasualSecurityInc](https://github.com/CasualSecurityInc)
- **Source:** [CasualSecurityInc/xno-skills](https://github.com/CasualSecurityInc/xno-skills)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/xno-skills

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-casualsecurityinc-xno-skills
- Seller: https://agentstack.voostack.com/s/casualsecurityinc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.