Nano Currency MCP Server

What is Nano Currency MCP Server?

Nano Currency MCP Server gives MCP-compatible clients, including AI agents, the ability to send Nano currency and retrieve account & block information via the Nano node RPC. It also enables the creation of x402-compatible headers for paying APIs/resources using Nano.

How to use Nano Currency MCP Server?

Install Node.js, then clone the repository, run npm install, and set required environment variables (NANO_RPC_URL). Configure the server in an MCP client (e.g., Claude Desktop) using the provided example. The server exposes six tools: raw_send, nano_send, nano_account_info, nano_my_account_info, block_info, and x402_payment_signature_exact_scheme_create.

Key features of Nano Currency MCP Server

• Send Nano in raw or nano units from a predefined account.
• Retrieve detailed account info (balance, representative, frontier block).
• Fetch detailed information about any Nano block.
• Create x402 PAYMENT-SIGNATURE headers for Nano transactions.
• Configurable maximum send amounts for safety.
• Works with any Nano node RPC endpoint (local or remote).

Use cases of Nano Currency MCP Server

• AI agents sending Nano on behalf of their owners.
• Autonomous AI paying for APIs using Nano via x402.
• Checking Nano account balances and details programmatically.
• Retrieving block information for transaction verification.

FAQ from Nano Currency MCP Server

What environment variables are required?

NANO_RPC_URL is required. NANO_PRIVATE_KEY, NANO_WORK_GENERATION_URL, RAW_MAX_SEND_AMOUNT, NANO_MAX_SEND_AMOUNT, and X402_NANO_NETWORK are optional but needed for sending transactions and x402 features.

How do I limit the amount of Nano that can be sent?

Set RAW_MAX_SEND_AMOUNT or NANO_MAX_SEND_AMOUNT to restrict the maximum per transaction. The default is 0.01 nano (or equivalent in raw).

Does this server support x402 payments?

Yes. The tool x402_payment_signature_exact_scheme_create creates the PAYMENT-SIGNATURE header for a Nano x402 transaction following the exact scheme.

What is the default Nano network for x402?

The default network is "nano:mainnet", configurable via the X402_NANO_NETWORK environment variable.

Can I use a remote Nano node?

Yes. Set NANO_RPC_URL to any Nano node RPC endpoint, whether local or remotely hosted.