NANO MCP Server - AI Agent Integration Guide
For AI Agents: This server is designed specifically for autonomous agents. All errors are self-documenting with step-by-step guidance. No external documentation needed.
🌐 Production Server URL
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @chainreactionom/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add chainreactionom-nano-mcp-server -- npx -y @chainreactionom/nano-mcp-server@1.0.10รันในเทอร์มินัล
{ "mcpServers": { "chainreactionom-nano-mcp-server": { "command": "npx", "args": [ "-y", "@chainreactionom/[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
For AI Agents: This server is designed specifically for autonomous agents. All errors are self-documenting with step-by-step guidance. No external documentation needed.
Model Context Protocol (MCP) server for NANO cryptocurrency interactions
https://nano-mcp.replit.appAll requests go to: https://nano-mcp.replit.app (POST requests with JSON-RPC 2.0 format)
Quick Example:
curl -X POST https://nano-mcp.replit.app \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'
Server URL: https://nano-mcp.replit.app
No installation needed! The server is already running. Just start making requests.
POST https://nano-mcp.replit.app
{
"jsonrpc": "2.0",
"method": "initialize",
"params": {},
"id": 1
}
The server responds with all available methods. Start using them immediately.
🎯 No documentation reading required! Fetch the complete JSON Schema and auto-generate your client code:
# Get complete JSON Schema with all 16 tools
GET https://nano-mcp.replit.app/schema
# Get TypeScript definitions
GET https://nano-mcp.replit.app/schema/typescript
# Get OpenAPI 3.0 spec (Swagger compatible)
GET https://nano-mcp.replit.app/openapi.json
.d.ts for type-safe clients# Get schema for specific tool
GET https://nano-mcp.replit.app/schema/tools/sendTransaction
# Get examples for a tool
GET https://nano-mcp.replit.app/schema/examples/generateWallet
# Validate parameters before sending
POST https://nano-mcp.replit.app/schema/validate/sendTransaction
{ "fromAddress": "...", "toAddress": "...", "amountRaw": "...", "privateKey": "..." }
# Get tools by category (query, transaction, utility, etc.)
GET https://nano-mcp.replit.app/schema/category/transaction
# Get all error codes
GET https://nano-mcp.replit.app/schema/errors
// 1. Download TypeScript definitions
// curl https://nano-mcp.replit.app/schema/typescript > nano-mcp.d.ts
// 2. Import types
import type { SendTransactionParams, SendTransactionResult } from './nano-mcp';
// 3. Use with full type safety
const params: SendTransactionParams = {
fromAddress: "nano_...",
toAddress: "nano_...",
amountRaw: "1000000000000000000000000000",
privateKey: "..."
}; // TypeScript validates all fields!
📖 Complete Guide: See docs/JSON_SCHEMA_AI_AGENT_GUIDE.md for detailed schema integration patterns.
⏱️ Estimated Integration Time: 5 minutes (vs. hours of documentation reading)
If you need to run locally for development:
cd NANO_MCP_SERVER
npm install
npm start
Local server runs on: http://localhost:8080
Complete workflow in 5-6 calls, 30-60 seconds:
// STEP 1: Setup test wallets (1 call, < 1s)
POST https://nano-mcp.replit.app
{"jsonrpc":"2.0","method":"setupTestWallets","params":{},"id":1}
→ Returns: wallet addresses + private keys
// STEP 2: Human funds both addresses (30-60s wait)
// → Send 0.1+ NANO to each address
// STEP 3: Check BOTH wallets in parallel (2 calls, 4-6s)
POST https://nano-mcp.replit.app
{"jsonrpc":"2.0","method":"getAccountStatus","params":{"address":"wallet1_address"},"id":1}
{"jsonrpc":"2.0","method":"getAccountStatus","params":{"address":"wallet2_address"},"id":2}
→ Returns: balance, pending blocks, needsAction
// STEP 4: Follow needsAction automatically (2 calls, 16-24s)
POST https://nano-mcp.replit.app
{"jsonrpc":"2.0","method":"initializeAccount","params":{"address":"wallet1","privateKey":"key1"},"id":1}
{"jsonrpc":"2.0","method":"initializeAccount","params":{"address":"wallet2","privateKey":"key2"},"id":2}
→ Returns: initialized confirmation
// STEP 5: Send transaction (1 call, 10-15s)
POST https://nano-mcp.replit.app
{"jsonrpc":"2.0","method":"sendTransaction","params":{
"fromAddress":"wallet1",
"toAddress":"wallet2",
"amountRaw":"50000000000000000000000000",
"privateKey":"key1"
},"id":1}
→ Returns: transaction hash
// DONE! ✅ Total: 6 calls, ~60 seconds (including human wait)
⚠️ CRITICAL: Work Generation Performance
Proof-of-Work (PoW) generation time varies significantly by system:
If experiencing timeouts:
1. Don't call getBalance then getAccountStatus
// ❌ INEFFICIENT: 2 calls, 4-6s
await call('getBalance', {address}) // Returns: balance, pending
await call('getAccountStatus', {address}) // Returns: balance, pending + more
// ✅ EFFICIENT: 1 call, 2-3s
await call('getAccountStatus', {address}) // Returns: everything you need
2. Don't call checkTestWalletsFunding repeatedly
// ❌ INEFFICIENT: Shows 0 until manually updated
await call('checkTestWalletsFunding') // Returns: bothFunded: false
await call('checkTestWalletsFunding') // Still false (not auto-updating)
// ✅ EFFICIENT: Check blockchain directly
await call('getAccountStatus', {address}) // Shows pending blocks immediately
3. Don't set short timeouts on transactions
// ❌ FAILS: Work generation takes 10-15 seconds
await call('sendTransaction', {...}, {timeout: 5000}) // Times out!
// ✅ WORKS: Proper timeout
await call('sendTransaction', {...}, {timeout: 30000}) // Completes successfully
4. Don't test functions sequentially when independent
// ❌ SLOW: 6 seconds total
await call('getAccountStatus', {address: wallet1}) // 3s
await call('getAccountStatus', {address: wallet2}) // 3s
// ✅ FAST: 3 seconds total
await Promise.all([
call('getAccountStatus', {address: wallet1}),
call('getAccountStatus', {address: wallet2})
]) // Both in 3s
getAccountStatus for everything - It replaces getBalance, getAccountInfo, getPendingBlocksneedsAction array - Auto-recovery without trial-and-errorResult: Faster integration, lower costs, fewer errors.
NANO MCP Server provides JSON-RPC 2.0 API for NANO cryptocurrency operations with:
NANO Cryptocurrency Features:
initialize - Get server capabilities and all available functionsgenerateWallet - Create new NANO walletgetBalance - Check account balancegetAccountInfo - Get detailed account datagetPendingBlocks - List pending transactionsinitializeAccount - Open/activate new accountsendTransaction - Send NANO (with enhanced errors)receiveAllPending - Receive all pending blocksgenerateQrCode - Create payment QR code with base64 PNGconvertBalance - Convert NANO ↔ raw unitsgetAccountStatus - One call shows: balance, pending, capabilities, what actions needednanoConverterHelp - NEW! Comprehensive guide for Nano (XNO) conversions, formats, and number handling (essential for clients unfamiliar with Nano)setupTestWallets - Generate two test wallets (requires human funding)getTestWallets - Retrieve test wallet infoupdateTestWalletBalance - Update wallet balance trackingcheckTestWalletsFunding - Check if wallets are readyresetTestWallets - Delete and start fresh// Step 1: Check account status first (ALWAYS DO THIS)
POST https://nano-mcp.replit.app
{
"jsonrpc": "2.0",
"method": "getAccountStatus",
"params": {
"address": "nano_your_address"
},
"id": 1
}
// Response shows:
// - initialized: true/false
// - balance: {raw, nano}
// - pending: {count, amount}
// - needsAction: [array of required actions]
// - readyForTesting: true/false
// Step 2: Handle any required actions
// If needsAction includes "initializeAccount":
{
"jsonrpc": "2.0",
"method": "initializeAccount",
"params": {
"address": "nano_your_address",
"privateKey": "your_private_key"
},
"id": 2
}
// If needsAction includes "receiveAllPending":
{
"jsonrpc": "2.0",
"method": "receiveAllPending",
"params": {
"address": "nano_your_address",
"privateKey": "your_private_key"
},
"id": 3
}
// Step 3: Convert amount to raw units
{
"jsonrpc": "2.0",
"method": "convertBalance",
"params": {
"amount": "0.1",
"from": "nano",
"to": "raw"
},
"id": 4
}
// Returns: {"converted": "100000000000000000000000000000"}
// Step 4: Send transaction
{
"jsonrpc": "2.0",
"method": "sendTransaction",
"params": {
"fromAddress": "nano_sender",
"toAddress": "nano_recipient",
"amountRaw": "100000000000000000000000000",
"privateKey": "sender_private_key"
},
"id": 5
}
// Success: {"success": true, "hash": "..."}
// Error: Detailed error with nextSteps (see Error Handling section)
{"jsonrpc": "2.0", "method": "generateWallet", "params": {}, "id": 1}
Returns: address, privateKey, publicKey, seed
{"jsonrpc": "2.0", "method": "getBalance", "params": {"address": "nano_xxx"}, "id": 1}
Returns: balance (raw), pending (raw)
{"jsonrpc": "2.0", "method": "convertBalance", "params": {"amount": "0.1", "from": "nano", "to": "raw"}, "id": 1}
Returns: converted value with formula
{"jsonrpc": "2.0", "method": "getAccountStatus", "params": {"address": "nano_xxx"}, "id": 1}
Returns: Complete status + what to do next
The NANO MCP Server has the most comprehensive, AI-agent-friendly error handling:
All errors include:
errorCode - Machine-readable code (e.g., "INSUFFICIENT_BALANCE")error - Human-readable messagedetails - Specific context (what went wrong, expected format, etc.)nextSteps - Step-by-step remediation instructions (array)relatedFunctions - What functions can help solve thisexampleRequest - Copy-paste ready correct requestsuggestedCorrection - Auto-corrected values (when applicable)Validation Errors:
MISSING_PARAMETER - Required parameter not providedMETHOD_NOT_FOUND - Invalid MCP method nameINVALID_ADDRESS_FORMAT - Address missing or wrong typeINVALID_ADDRESS_PREFIX - Address doesn't start with 'nano_' or 'xrb_'INVALID_ADDRESS_LENGTH - Address wrong lengthINVALID_ADDRESS_CHARACTERS - Address has invalid charactersINVALID_PRIVATE_KEY_FORMAT - Private key missing or wrong typeINVALID_PRIVATE_KEY_LENGTH - Private key not 64 charactersINVALID_PRIVATE_KEY_CHARACTERS - Private key not hexadecimalINVALID_AMOUNT_FORMAT - Amount missing or wrong typeAMOUNT_WRONG_UNIT - Smart detection: You used NANO instead of rawINVALID_AMOUNT_CHARACTERS - Amount has invalid charactersINVALID_AMOUNT_ZERO_OR_NEGATIVE - Amount must be positiveINVALID_AMOUNT_OVERFLOW - Amount too largeINVALID_CONVERSION_UNITS - Invalid 'from' or 'to' unitSAME_CONVERSION_UNITS - Cannot convert same unitINVALID_QR_AMOUNT_FORMAT - QR code amount format invalidBlockchain Errors:
INSUFFICIENT_BALANCE - Not enough NANO to sendINSUFFICIENT_WORK - [CRITICAL] Work doesn't meet difficulty threshold (FIXED - just retry)ACCOUNT_NOT_INITIALIZED - Account needs to receive first transactionACCOUNT_NOT_INITIALIZED_NO_PENDING - Account has no pending blocksPENDING_BLOCKS_NOT_RECEIVED - Should receive pending firstBLOCKCHAIN_INVALID_BLOCK - Blockchain rejected blockBLOCKCHAIN_INSUFFICIENT_BALANCE - Blockchain balance check failedBLOCKCHAIN_ERROR - General blockchain operation errorCONVERSION_ERROR - Balance conversion failedRequest:
{
"jsonrpc": "2.0",
"method": "sendTransaction",
"params": {
"fromAddress": "nano_xxx",
"toAddress": "nano_yyy",
"amountRaw": "1000000000000000000000000000",
"privateKey": "key"
},
"id": 1
}
Error Response:
{
"jsonrpc": "2.0",
"result": {
"success": false,
"error": "Insufficient balance",
"errorCode": "INSUFFICIENT_BALANCE",
"details": {
"address": "nano_xxx",
"currentBalance": "80000000000000000000000000",
"currentBalanceNano": "0.00016",
"attemptedAmount": "1000000000000000000000000000",
"attemptedAmountNano": "0.002",
"shortfall": "920000000000000000000000000",
"shortfallNano": "0.00184"
},
"nextSteps": [
"Step 1: Check current balance using getBalance or getAccountInfo",
"Step 2: Either reduce send amount to maximum 0.00016 NANO or less",
"Step 3: Or fund account with additional 0.00184 NANO minimum",
"Step 4: After funding, use receiveAllPending to process pending blocks",
"Step 5: Retry your send transaction"
],
"relatedFunctions": ["getBalance", "getAccountInfo", "receiveAllPending"],
"exampleRequest": {
"jsonrpc": "2.0",
"method": "getBalance",
"params": {"address": "nano_xxx"},
"id": 1
}
},
"id": 1
}
You sent NANO instead of raw? The server auto-corrects for you!
Bad Request (NANO instead of raw):
{
"jsonrpc": "2.0",
"method": "sendTransaction",
"params": {
"fromAddress": "nano_3sender...",
"toAddress": "nano_3receiver...",
"amountRaw": "0.1",
"privateKey": "abc123..."
},
"id": 1
}
Smart Error Response:
{
"success": false,
"error": "amountRaw appears to be in NANO format, not raw",
"errorCode": "AMOUNT_WRONG_UNIT",
"details": {
"providedValue": "0.1",
"detectedFormat": "NANO (decimal)",
"expectedFormat": "raw (integer string)"
},
"suggestedCorrection": {
"originalValue": "0.1",
"originalUnit": "NANO",
"correctedValue": "100000000000000000000000000000",
"correctedUnit": "raw"
},
"nextSteps": [
"Step 1: Use the correctedValue from suggestedCorrection below",
"Step 2: Retry your request with the raw amount"
],
"exampleConversion": {
"jsonrpc": "2.0",
"method": "convertBalance",
"params": { "amount": "0.1", "from": "nano", "to": "raw" },
"id": 1
}
}
AI Agent Action:
// Extract corrected value automatically
if (response.errorCode === "AMOUNT_WRONG_UNIT") {
const correctedAmount = response.suggestedCorrection.correctedValue;
// Retry with corrected value: "100000000000000000000000000000"
}
For detailed error handling guide: See docs/AI_AGENT_ERROR_HANDLING.md
Topics covered:
Receive Error
|
├─> errorCode == "INSUFFICIENT_BALANCE"
| ├─> Check details.shortfall
| ├─> Option 1: Reduce amountRaw
| └─> Option 2: Fund account
|
├─> errorCode == "ACCOUNT_NOT_INITIALIZED"
| ├─> Check details.hasPendingBlocks
| ├─> If true: Call initializeAccount
| └─> If false: Send NANO to address first
|
├─> errorCode == "PENDING_BLOCKS_NOT_RECEIVED"
| └─> Call receiveAllPending
|
└─> Other errors
└─> Follow nextSteps array
Step 1: Generate Test Wallets
POST https://nano-mcp.replit.app
{
"jsonrpc": "2.0",
"method": "setupTestWallets",
"params": {},
"id": 1
}
Response (Save These Addresses!):
{
"jsonrpc": "2.0",
"result": {
"wallet1": {
"address": "nano_3h3m6kfckrxpc4t33jn36eu8smfpukwuq1zq4hy35dh4a7drs6ormhwhkncn",
"privateKey": "6b84f1b17dd0a6176df2b500b40ce17c0db5bd8042ca8ac04173dd74bac303b8",
"publicKey": "bc33249aa963b650b410c68123366ccdb6dcb9bb83f713fc11ade241578c92b8",
"seed": "cbce4f1ec09296e245f4125b8f89930cc490599f30697491bc03e4915041c146",
"balance": "0",
"funded": false
},
"wallet2": {
"address": "nano_39isqp67xsse8cj5igtonuiwicqy8p6txa57mbjd8bcyip7ggrai4bby1x1w",
"privateKey": "9279a138a0000ac09477be901210b58b80e503835744f08c70690d94d57e70b9",
"publicKey": "9e19bd885ee72c32a2383b55a6e1c82afe3589aea0659a62b3255e858ae76110",
"seed": "bf69ae134c00c0e24aabb97ac4a0a7e1933fdd28672a1b0caf9b1c7ea193d917",
"balance": "0",
"funded": false
},
"created": "2025-11-11T15:25:23.161Z",
"status": "awaiting_funding",
"fundingInstructions": [
"Send test NANO to Wallet 1: nano_3h3m6kfckrxpc4t33jn36eu8smfpukwuq1zq4hy35dh4a7drs6ormhwhkncn",
"Send test NANO to Wallet 2: nano_39isqp67xsse8cj5igtonuiwicqy8p6txa57mbjd8bcyip7ggrai4bby1x1w",
"After funding, use checkFundingStatus to verify both wallets are funded",
"Recommended test amount: 0.1 NANO or more per wallet"
]
},
"id": 1
}
⚠️ IMPORTANT - ACTION REQUIRED: HUMAN MUST FUND THESE WALLETS!
nano_3h3m6kfckrxpc4t33jn36eu8smfpukwuq1zq4hy35dh4a7drs6ormhwhkncnnano_39isqp67xsse8cj5igtonuiwicqy8p6txa57mbjd8bcyip7ggrai4bby1x1wStep 2: Check Funding Status
{
"jsonrpc": "2.0",
"method": "checkTestWalletsFunding",
"params": {},
"id": 2
}
Step 3: When Both Funded, Start Testing!
Response will show "bothFunded": true when ready.
setupTestWallets
↓
Fund addresses (external)
↓
initializeAccount (both wallets)
↓
updateTestWalletBalance (both wallets)
↓
checkTestWalletsFunding
↓
Ready for send/receive testing!
START
|
v
Call: getAccountStatus(address)
|
├─> initialized: false
| |
| ├─> hasPendingBlocks: true
| | └─> Call: initializeAccount
| |
| └─> hasPendingBlocks: false
| └─> STOP: Fund account first
|
└─> initialized: true
|
├─> pendingCount > 0
| └─> Call: receiveAllPending
|
└─> canSend: true
|
v
Call: convertBalance(amount, "nano", "raw")
|
v
Call: sendTransaction(...)
|
├─> success: true
| └─> DONE!
|
└─> success: false
└─> Parse errorCode
└─> Follow nextSteps in error response
NANO uses TWO units:
Conversion:
amountRaw parameterQuick Reference:
Use convertBalance function:
{"jsonrpc": "2.0", "method": "convertBalance", "params": {"amount": "0.1", "from": "nano", "to": "raw"}, "id": 1}
# Clone or download
cd NANO_MCP_SERVER
# Install dependencies
npm install
# Run server
npm start
MCP_PORT=8080 # Server port (default: 8080)
MCP_TRANSPORT=http # Transport type (default: http)
NANO_RPC_URL=https://... # NANO RPC node (has default)
NANO_REPRESENTATIVE=nano_xxx # Representative (has default)
# Run tests (21 tests for test wallet system)
npm test
Purpose: Initialize the MCP server and get list of all available capabilities/functions Parameters: None Returns: Server information and list of all available MCP tools with their descriptions
{"jsonrpc": "2.0", "method": "initialize", "params": {}, "id": 1}
Response includes:
protocolVersion - MCP protocol versionserverInfo - Server name and versioncapabilities - Server capabilitiestools - Complete list of all available MCP functions with descriptions and parameter schemasUse Case: First call to discover what the server can do and what functions are available
Purpose: Create new NANO wallet
Parameters: None
Returns: address, privateKey, publicKey, seed
{"jsonrpc": "2.0", "method": "generateWallet", "params": {}, "id": 1}
Purpose: Check account balance
Parameters: address
Returns: balance (raw), pending (raw)
{"jsonrpc": "2.0", "method": "getBalance", "params": {"address": "nano_xxx"}, "id": 1}
Purpose: Get detailed account information
Parameters: address
Returns: frontier, balance, representative, block_count, etc.
{"jsonrpc": "2.0", "method": "getAccountInfo", "params": {"address": "nano_xxx"}, "id": 1}
Purpose: List pending (unreceived) transactions
Parameters: address
Returns: Object with pending blocks and amounts
{"jsonrpc": "2.0", "method": "getPendingBlocks", "params": {"address": "nano_xxx"}, "id": 1}
Purpose: Open/activate new account (first receive)
Parameters: address, privateKey
Returns: initialized, blockHash, balance, etc.
{"jsonrpc": "2.0", "method": "initializeAccount", "params": {"address": "nano_xxx", "privateKey": "key"}, "id": 1}
Purpose: Send NANO to another address
Parameters: fromAddress, toAddress, amountRaw, privateKey
Returns: success, hash OR enhanced error
{"jsonrpc": "2.0", "method": "sendTransaction", "params": {"fromAddress": "nano_xxx", "toAddress": "nano_yyy", "amountRaw": "100000000000000000000000000", "privateKey": "key"}, "id": 1}
Purpose: Receive all pending transactions
Parameters: address, privateKey
Returns: Array of received blocks
{"jsonrpc": "2.0", "method": "receiveAllPending", "params": {"address": "nano_xxx", "privateKey": "key"}, "id": 1}
Purpose: Generate payment QR code for receiving NANO Parameters:
address (string, required) - NANO address to receive paymentamount (string, optional) - Amount in NANO (decimal format, e.g., "0.1")Returns:
qrCode (string) - Base64 encoded PNG imagepaymentString (string) - NANO URI for payment (nano:address?amount=...)address (string) - The NANO addressamount (string) - The amount in NANO (if provided)Example Request:
{
"jsonrpc": "2.0",
"method": "generateQrCode",
"params": {
"address": "nano_3h3m6kfckrxpc4t33jn36eu8smfpukwuq1zq4hy35dh4a7drs6ormhwhkncn",
"amount": "0.1"
},
"id": 1
}
Example Response:
{
"jsonrpc": "2.0",
"result": {
"qrCode": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...[long base64 string]",
"paymentString": "nano:nano_3h3m6kfckrxpc4t33jn36eu8smfpukwuq1zq4hy35dh4a7drs6ormhwhkncn?amount=100000000000000000000000000000",
"address": "nano_3h3m6kfckrxpc4t33jn36eu8smfpukwuq1zq4hy35dh4a7drs6ormhwhkncn",
"amount": "0.1"
},
"id": 1
}
Use Cases:
qrCode can be directly embedded in HTML: <img src="data:image/png;base64,..." />paymentString can be used as a clickable link or deep link for NANO walletsPurpose: Convert between NANO and raw units
Parameters: amount, from ("nano"/"raw"), to ("nano"/"raw")
Returns: converted, formula
{"jsonrpc": "2.0", "method": "convertBalance", "params": {"amount": "0.1", "from": "nano", "to": "raw"}, "id": 1}
Purpose: Comprehensive account readiness check
Parameters: address
Returns: initialized, balance, pending, capabilities, needsAction, recommendations
{"jsonrpc": "2.0", "method": "getAccountStatus", "params": {"address": "nano_xxx"}, "id": 1}
Purpose: Get comprehensive help for Nano (XNO) conversion utilities and number formats Parameters: None Returns: Conversion formulas, examples, common mistakes, best practices, and utility function documentation
⚠️ IMPORTANT: Essential for clients unfamiliar with Nano!
Why this tool exists: Most cryptocurrency clients expect simple decimal numbers like Bitcoin or Ethereum. However, Nano uses 30 decimal places (10^30 raw units = 1 XNO), which requires special handling to avoid precision errors.
Example Request:
{"jsonrpc": "2.0", "method": "nanoConverterHelp", "params": {}, "id": 1}
Example Response (truncated):
{
"jsonrpc": "2.0",
"result": {
"description": "Nano (XNO) uses raw units for all on-chain operations. 1 XNO = 10^30 raw. This ensures exact precision without floating-point errors.",
"formula": "raw = XNO × 10^30",
"reverseFormula": "XNO = raw ÷ 10^30",
"decimalPlaces": 30,
"examples": {
"0.1_XNO": "100000000000000000000000000000",
"1_XNO": "1000000000000000000000000000000"
},
"commonMistakes": [
"Using XNO value instead of raw in amountRaw parameter",
"Using floating-point arithmetic which causes rounding errors"
],
"utilityFunctions": {
"xnoToRaw": {
"description": "Convert XNO amount to raw units (use this for all transaction amounts)",
"example": "xnoToRaw(1) => '1000000000000000000000000000000'",
"usage": "Always use this before sending transactions"
}
},
"exampleWorkflow": [
"Step 1: Get user input in XNO (e.g., '0.1')",
"Step 2: Convert to raw using NanoConverter.xnoToRaw('0.1')",
"Step 3: Validate address using NanoConverter.isValidNanoAddress(address)",
"Step 4: Use raw amount in sendTransaction"
],
"warning": "IMPORTANT: Most clients don't know Nano uses 30 decimal places. Always educate users that 1 XNO = 10^30 raw units."
},
"id": 1
}
Use Cases:
Purpose: Generate two test wallets with all credentials
Parameters: None
Returns: wallet1, wallet2 (with address, privateKey, publicKey, seed), fundingInstructions
⚠️ Action Required: Human must fund both wallet addresses with test NANO
{"jsonrpc": "2.0", "method": "setupTestWallets", "params": {}, "id": 1}
Response includes:
Purpose: Retrieve current test wallet information
Parameters: None
Returns: wallet1, wallet2 (with addresses, balances, funding status)
{"jsonrpc": "2.0", "method": "getTestWallets", "params": {}, "id": 1}
Use Case: Get wallet credentials after generating them, or check current state
Purpose: Update tracked balance for a test wallet
Parameters: walletName ("wallet1" or "wallet2"), balance (raw), funded (boolean)
Returns: Updated wallet info
{"jsonrpc": "2.0", "method": "updateTestWalletBalance", "params": {"walletName": "wallet1", "balance": "100000000000000000000000000000", "funded": true}, "id": 1}
Use Case: Manually track balance changes or mark wallet as funded
Purpose: Check if both test wallets have been funded (have balance > 0)
Parameters: None
Returns: wallet1 (balance, funded), wallet2 (balance, funded), bothFunded, status
{"jsonrpc": "2.0", "method": "checkTestWalletsFunding", "params": {}, "id": 1}
Use Case: Verify wallets are ready for testing after human funding
Purpose: Delete test wallets and start fresh Parameters: None Returns: Confirmation message
{"jsonrpc": "2.0", "method": "resetTestWallets", "params": {}, "id": 1}
Use Case: Clean up and generate new test wallets
getAccountStatusconvertBalance before transactionsamountRaw (must be raw units)nextSteps - they guide recoveryerrorCode instead)Located in NANO_MCP_SERVER/:
✅ Self-documenting - Every error explains itself ✅ Helper functions - Convert, status check built-in ✅ Structured responses - Easy to parse JSON ✅ Machine-readable codes - Error codes for programmatic handling ✅ Actionable guidance - Every error includes nextSteps ✅ No external docs needed - All info in responses ✅ Fast integration - 5-10 minutes to first transaction
vs Traditional NANO integration: 1-2 hours minimum
Production Server (No Setup Required):
# Test the production server immediately:
curl -X POST https://nano-mcp.replit.app \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'
# You should see list of all 16 available methods
Local Development (Optional):
# 1. Start local server
cd NANO_MCP_SERVER && npm start
# 2. In another terminal, test:
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"initialize","params":{},"id":1}'
For AI Agents:
getAccountStatus to diagnose issueserrorCode for specific problemsnextSteps in error responsesFor Developers:
NANO_MCP_SERVER/docs/You have everything you need. The server guides you through every step with self-documenting errors.
First command to run:
cd NANO_MCP_SERVER && npm start
Server will be ready on: http://localhost:8080
Start with: {"jsonrpc":"2.0","method":"initialize","params":{},"id":1}
Good luck with your NANO integration! 🚀
Model Context Protocol (MCP) server for NANO cryptocurrency interactions
{ "mcpServers": { "chainreactionom-nano-mcp-server": { "command": "npx", "args": [ "-y", "@chainreactionom/[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
@chainreactionom/nano ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-16 Model Context Protocol (MCP) server for NANO cryptocurrency interactions