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.

AI agents are increasingly adopting the MCP standard and this server gives them the ability to send Nano at their owner’s request or possibly autonomously in some setups 🤖

Nano Currency MCP Server also allows for the creation of x402-compatible headers, giving AI agents the ability to pay for APIs/resources using Nano.

❔ What is MCP?

The Model Context Protocol (MCP) is an open framework that defines a standardized approach for applications to deliver context to Large Language Models (LLMs).

❔ What is Nano Currency?

Nano is a digital currency designed to enable fast, scalable, and feeless transactions. It aims to address common issues in traditional cryptocurrencies, such as high fees and slow processing times, making it an efficient option for everyday peer-to-peer payments. Learn more at nano.org

❔ What is x402?

x402 is an internet-native payment protocol that revives the unused HTTP 402 Payment Required status code to enable instant, programmatic, and permissionless payments over the web. Learn more at x402.org. Nano-specific x402 schemes and implementation code can be found at the x402nano GitHub resource.

🚨 Before Proceeding 🚨

Caution: LLMs can hallucinate and not always perform as you want, so test this server with small amounts of Nano. Use either the RAW_MAX_SEND_AMOUNT or NANO_MAX_SEND_AMOUNT environment variables described later to restrict the maximum amount of Nano that can be sent at a time.

🛠️ Tools Provided by Nano Currency MCP Server

🔧 raw_send - Send a specified amount of raw units from a predefined Nano account to a destination Nano account.

🔧 nano_send - Send a specified amount of nano units from a predefined Nano account to a destination Nano account.

🔧 nano_account_info - Retrieve detailed information about a specific Nano account, including balance (in both nano and raw units), representative, and frontier block.

🔧 nano_my_account_info - Retrieve detailed information about my Nano account, including balance (in both nano and raw units), representative, and frontier block. This is the account that is used to send Nano from.

🔧 block_info - Retrieve detailed information about a specific Nano block.

🔧 x402_payment_signature_exact_scheme_create - Create the PAYMENT-SIGNATURE header for a Nano x402 transaction conforming to the exact scheme.

🔌 Installation

Make sure you have Node.js with NPM installed on your system.

git clone https://github.com/kilkelly/nano-currency-mcp-server.git
cd nano-currency-mcp-server
npm install