# Nano Pay

> Nano Pay is a free MCP server for finance and payments. Local Nano wallet and x402 client that lets agents pay for APIs with feeless micropayments. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Linux, Windows, self-hosted
- **Website:** https://feeless402.com
- **Repository:** https://github.com/feeless402/feeless402
- **MCP Registry name:** com.feeless402/nano-pay
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

Where most x402 payments are quoted in fee-bearing crypto, this tool lets an agent settle in Nano (XNO) from a self-custodied wallet kept on its own machine. The project argues that gas fees force a price floor of about $0.001 per call, while Nano settles each call alone on the ledger in under a second. Its README gives a worked comparison in which $5 buys about 5,000 calls on a floored USDC-on-Base rail, against hundreds of thousands of calls in Nano.

The client handles the x402 handshake: it reads the 402 quote in either supported dialect, checks a price cap, signs a send block locally and retries with payment headers. Every payment is journaled before sending, and a lost reply is checked against the ledger so the receipt says settled, not settled or indeterminate, and a landed block is never paid twice. The same package includes a merchant server, nano-pay serve, with on-ledger verification, a starter faucet and a railHint extension that tells visiting agents how to onboard.

It installs with pip install feeless402 on Python 3.10 or later and creates a wallet file under ~/.nano-pay. Topping up is quoted through NanSwap and needs a NANSWAP_API_KEY to execute.

## Features

- **Self-custodied wallet:** The wallet lives on the agent's machine and payments are signed locally.
- **x402 handshake:** Parses 402 quotes in two dialects, applies a price cap and retries with payment headers.
- **Double-payment protection:** Payments are journaled and a signed block that landed is never paid again.
- **Merchant server:** nano-pay serve accepts payments with on-ledger verification and no facilitator.
- **railHint extension:** Tells visiting agents how to switch to Nano and offers a starter faucet.
- **Top-up quotes:** Quotes converting USDC on Base to XNO through NanSwap.

## Good for

- Let an agent pay per call for an x402-priced AI API
- Run a paid API that accepts Nano without a facilitator
- Price API calls below the gas-fee floor
- Top up an agent wallet from USDC

## Install

### Claude Code (Terminal)

```sh
claude mcp add nano-pay -- uvx feeless402
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "nano-pay": {
      "command": "uvx",
      "args": [
        "feeless402"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "nano-pay": {
      "command": "uvx",
      "args": [
        "feeless402"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "nano-pay": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "feeless402"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "nano-pay": {
      "command": "uvx",
      "args": [
        "feeless402"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "nano-pay": {
      "command": "uvx",
      "args": [
        "feeless402"
      ]
    }
  }
}
```

## FAQ

### Does it charge fees?

Nano itself has no transaction fees, according to the project. Converting USDC to XNO goes through NanSwap.

### Who holds the keys?

You do. The wallet file is created locally with restricted permissions.

### What does it need?

Python 3.10 or later, installed with pip install feeless402.

### Can it also accept payments?

Yes, nano-pay serve runs a merchant server with on-ledger verification.

### Is Nano Pay free?

Yes. Nano Pay is free to use.

### How do I add Nano Pay to Claude Code?

Run this command in your terminal: claude mcp add nano-pay -- uvx feeless402

### What are the best alternatives to Nano Pay?

The closest alternatives to Nano Pay are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/nano-pay
