Skip to content
MCP server

Nano Pay

Local Nano wallet and x402 client that lets agents pay for APIs with feeless micropayments

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.2.13
Listing updated
2 days ago

About Nano Pay

Nano Pay is a free MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add nano-pay -- uvx feeless402

Add to claude_desktop_config.json

{
  "mcpServers": {
    "nano-pay": {
      "command": "uvx",
      "args": [
        "feeless402"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "nano-pay": {
      "command": "uvx",
      "args": [
        "feeless402"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Free

Free to install; network fees are none, top-ups via NanSwap

Prices change. Check feeless402.com before you buy.

Nano Pay 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 to Nano Pay

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government