@ktmcp-cli/nowpayments 1.0.0 → 1.0.2

package/README.md

@@ -1,375 +1,65 @@
+> "Six months ago, everyone was talking about MCPs. And I was like, screw MCPs. Every MCP would be better as a CLI."
+>
+> — [Peter Steinberger](https://twitter.com/steipete), Founder of OpenClaw
+> [Watch on YouTube (~2:39:00)](https://www.youtube.com/@lexfridman) | [Lex Fridman Podcast #491](https://lexfridman.com/peter-steinberger/)
+
 # NOWPayments CLI
 
-<p align="center">
-  <img src="banner.png" alt="KTMCP Banner" width="100%">
-</p>
+Production-ready CLI for [NOWPayments](https://nowpayments.io) API. Accept cryptocurrency payments, manage invoices, and handle subscriptions from your terminal.
 
+## Features
 
-A production-ready command-line interface for the [NOWPayments](https://nowpayments.io) cryptocurrency payment processing API. Built with Commander.js for robust API integration and automation.
+- **Payments** — Create and track crypto payments
+- **Invoices** — Generate payment invoices
+- **Currencies** — List supported cryptocurrencies and get estimates
+- **Subscriptions** — Manage recurring payments
+- **JSON output** — All commands support `--json`
 
 ## Why CLI > MCP
 
-While Model Context Protocol (MCP) servers provide AI integration, a dedicated CLI offers superior advantages:
-
-### 1. Universal Tool Integration
-- Works with **any** AI assistant (Claude, ChatGPT, local models)
-- No MCP server dependency or compatibility issues
-- Standard stdin/stdout interface that all tools understand
-
-### 2. Human-First Design
-- Direct terminal usage for developers and operators
-- Rich formatted output with colors and tables
-- Interactive workflows when needed
-- Scriptable for automation
-
-### 3. Reliability & Performance
-- No additional server process to manage
-- Direct API calls with minimal overhead
-- Proper error handling and exit codes
-- No WebSocket/transport layer complexity
-
-### 4. Development Velocity
-- Easier to test (just run commands)
-- Simpler debugging (standard logs)
-- Faster iteration (no server restarts)
-- Better CI/CD integration
-
-### 5. Production Ready
-- Works in Docker containers
-- Cron job compatible
-- Shell script integration
-- No daemon management
-
-**Bottom Line:** CLIs are battle-tested, universal interfaces. MCP adds complexity for integration scenarios where a simple CLI + agent pattern works better.
-
-## Features
-
-- Full NOWPayments API coverage
-- Rich terminal output with colors and formatting
-- JSON output mode for scripting
-- Persistent API key management
-- Sandbox environment support
-- Comprehensive error handling
-- Production-ready reliability
+- **Simpler** — Just a binary you call directly
+- **Composable** — Pipe to `jq`, `grep`, other tools
+- **Scriptable** — Use in shell scripts, CI/CD
+- **AI-friendly** — Easy for AI agents to use
 
 ## Installation
 
 ```bash
-npm install -g @ktmcp-cli/nowpayments
-```
-
-Or install locally:
-
-```bash
-cd ktmcp-nowpayments-cli
-npm install
-npm link
-```
-
-## Quick Start
-
-### 1. Get Your API Key
-
-Sign up at [NOWPayments.io](https://nowpayments.io) and generate an API key.
-
-### 2. Configure Authentication
-
-```bash
-# Save API key to config (recommended)
-nowpayments auth set YOUR_API_KEY
-
-# Or use environment variable
-export NOWPAYMENTS_API_KEY=your_api_key
-
-# Or pass with each command
-nowpayments --api-key YOUR_API_KEY status
-```
-
-### 3. Verify Connection
-
-```bash
-nowpayments status
-```
-
-## Usage
-
-### Authentication Management
-
-```bash
-# Set API key
-nowpayments auth set YOUR_API_KEY
-
-# Show current key (masked)
-nowpayments auth show
-
-# Clear API key
-nowpayments auth clear
-```
-
-### Check API Status
-
-```bash
-nowpayments status
-```
-
-### Currency Operations
-
-```bash
-# List all available cryptocurrencies
-nowpayments currencies list
-
-# Show only available payment currencies
-nowpayments currencies list --available
-
-# Get currency information
-nowpayments currencies info BTC
-```
-
-### Price Estimates
-
-```bash
-# Estimate cryptocurrency amount for fiat price
-nowpayments estimate convert --from USD --to BTC --amount 100
-
-# Get minimum payment amount
-nowpayments estimate min --from USD --to BTC
-```
-
-### Payment Management
-
-```bash
-# Create a new payment
-nowpayments payment create \
-  --price 99.99 \
-  --currency USD \
-  --pay-currency BTC \
-  --order-id "ORDER-123" \
-  --order-description "Premium subscription"
-
-# Get payment details
-nowpayments payment get <payment_id>
-
-# List all payments
-nowpayments payment list --limit 20
-
-# Filter payments by date
-nowpayments payment list \
-  --date-from 2024-01-01 \
-  --date-to 2024-12-31
-
-# Update payment estimate (before expiration)
-nowpayments payment update-estimate <payment_id>
-```
-
-### Invoice Management
-
-```bash
-# Create an invoice
-nowpayments invoice create \
-  --price 49.99 \
-  --currency USD \
-  --order-id "INV-456" \
-  --success-url "https://example.com/success" \
-  --cancel-url "https://example.com/cancel"
-
-# Get invoice details
-nowpayments invoice get <invoice_id>
-
-# List invoices
-nowpayments invoice list --limit 10
-```
-
-### Payout Operations
-
-```bash
-# Create a payout
-nowpayments payout create \
-  --amount 0.01 \
-  --currency BTC \
-  --address "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
-
-# Verify payout with 2FA
-nowpayments payout verify <payout_id> <verification_code>
-
-# Get payout details
-nowpayments payout get <payout_id>
-
-# List payouts
-nowpayments payout list
-```
-
-### Global Options
-
-```bash
-# Use sandbox environment
-nowpayments --sandbox status
-
-# Output raw JSON (for scripting)
-nowpayments --json payment list
-
-# Enable debug logging
-nowpayments --debug payment create --price 100 --currency USD --pay-currency BTC
-
-# Combine options
-nowpayments --sandbox --json currencies list
+npm install -g @ktmcp-cli/nowpaymentsio
 ```
 
-## Advanced Usage
+## Setup
 
-### Scripting with JSON Output
+Get API key from [NOWPayments Dashboard](https://nowpayments.io).
 
 ```bash
-# Get payment status in JSON
-payment_data=$(nowpayments --json payment get abc123)
-status=$(echo "$payment_data" | jq -r '.payment_status')
-
-if [ "$status" = "finished" ]; then
-  echo "Payment completed!"
-fi
+nowpaymentsio config set --api-key YOUR_API_KEY
 ```
 
-### Environment Variables
+## Commands
 
 ```bash
-# Set in .env file
-NOWPAYMENTS_API_KEY=your_api_key
-
-# Load automatically
-nowpayments status
-```
-
-### Automation Example
-
-```bash
-#!/bin/bash
-# Create payment and monitor status
-
-# Create payment
-payment=$(nowpayments --json payment create \
-  --price 100 \
-  --currency USD \
-  --pay-currency BTC)
-
-payment_id=$(echo "$payment" | jq -r '.payment_id')
-pay_address=$(echo "$payment" | jq -r '.pay_address')
-
-echo "Payment created: $payment_id"
-echo "Send to: $pay_address"
-
-# Monitor status
-while true; do
-  status=$(nowpayments --json payment get "$payment_id" | jq -r '.payment_status')
-  echo "Status: $status"
-
-  if [ "$status" = "finished" ]; then
-    echo "Payment completed!"
-    break
-  fi
-
-  sleep 30
-done
-```
-
-## Payment Flow
-
-1. **Create Estimate**: Check conversion rates and fees
-   ```bash
-   nowpayments estimate convert --from USD --to BTC --amount 100
-   ```
-
-2. **Create Payment**: Generate payment address
-   ```bash
-   nowpayments payment create --price 100 --currency USD --pay-currency BTC
-   ```
-
-3. **Customer Sends Crypto**: Customer sends exact amount to provided address
-
-4. **Monitor Status**: Poll payment status or use IPN callbacks
-   ```bash
-   nowpayments payment get <payment_id>
-   ```
-
-5. **Payment Confirmed**: Status changes to "finished"
-
-## Payment Statuses
+# Status
+nowpaymentsio status get
 
-- `waiting` - Waiting for customer payment
-- `confirming` - Payment received, confirming on blockchain
-- `confirmed` - Payment confirmed
-- `sending` - Sending to your wallet
-- `partially_paid` - Underpaid
-- `finished` - Complete
-- `failed` - Transaction failed
-- `refunded` - Payment refunded
-- `expired` - Payment window expired
+# Currencies
+nowpaymentsio currencies list
+nowpaymentsio currencies estimate --amount 100 --from USD --to BTC
 
-## Error Handling
+# Payments
+nowpaymentsio payments list
+nowpaymentsio payments get <payment-id>
+nowpaymentsio payments create --amount 100 --from USD --to BTC
 
-The CLI provides detailed error messages and proper exit codes:
+# Invoices
+nowpaymentsio invoices list
+nowpaymentsio invoices create --amount 50 --currency USD
 
-- Exit code 0: Success
-- Exit code 1: Error (API error, validation error, etc.)
-
-```bash
-# Check exit code
-nowpayments payment get invalid_id
-echo $?  # Returns 1 on error
+# Subscriptions
+nowpaymentsio subscriptions plans
+nowpaymentsio subscriptions list
 ```
 
-## Configuration
-
-Configuration is stored in `~/.nowpayments/config.json`:
-
-```json
-{
-  "apiKey": "your_api_key",
-  "sandbox": false,
-  "defaultCurrency": "USD",
-  "defaultPayCurrency": "BTC"
-}
-```
-
-## API Documentation
-
-For detailed API documentation, see:
-- [NOWPayments API Docs](https://documenter.getpostman.com/view/7907941/S1a32n38)
-- [OpenAPI Specification](./openapi.json)
-
-## AI Agent Usage
-
-See [AGENT.md](./AGENT.md) for patterns and examples for AI assistants using this CLI.
-
-## OpenClaw Integration
-
-See [OPENCLAW.md](./OPENCLAW.md) for integration with the OpenClaw agent framework.
-
-## Examples
-
-See [examples/](./examples/) directory for complete usage examples:
-- Basic payment flow
-- Invoice generation
-- Payout automation
-- Status monitoring
-
-## Requirements
-
-- Node.js >= 16.0.0
-- NOWPayments API key
-
 ## License
 
-MIT
-
-## Support
-
-- GitHub Issues: Report bugs and request features
-- NOWPayments Support: https://nowpayments.io/help
-- API Status: https://status.nowpayments.io
-
-## Contributing
-
-Contributions welcome! Please submit pull requests or open issues.
-
----
-
-Built with Commander.js for the KTMCP project.
+MIT — Part of [KTMCP CLI](https://killthemcp.com)

package/bin/nowpayments.js

@@ -1,89 +1,10 @@
 #!/usr/bin/env node
 
-/**
- * NOWPayments CLI Entry Point
- *
- * A production-ready command-line interface for the NOWPayments cryptocurrency
- * payment processing API.
- *
- * @see https://documenter.getpostman.com/view/7907941/S1a32n38
- */
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
 
-const { Command } = require('commander');
-const chalk = require('chalk');
-const path = require('path');
-const fs = require('fs');
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 
-// Load environment variables
-require('dotenv').config();
-
-const program = new Command();
-
-// Import commands
-const statusCommand = require('../src/commands/status');
-const currenciesCommand = require('../src/commands/currencies');
-const estimateCommand = require('../src/commands/estimate');
-const paymentCommand = require('../src/commands/payment');
-const invoiceCommand = require('../src/commands/invoice');
-const payoutCommand = require('../src/commands/payout');
-const authCommand = require('../src/commands/auth');
-
-// CLI metadata
-program
-  .name('nowpayments')
-  .description('NOWPayments API CLI - Cryptocurrency payment processing from the command line')
-  .version('1.0.0')
-  .option('-k, --api-key <key>', 'NOWPayments API key (or set NOWPAYMENTS_API_KEY env var)')
-  .option('--sandbox', 'Use sandbox environment (sandbox.nowpayments.io)')
-  .option('--json', 'Output raw JSON responses')
-  .option('--debug', 'Enable debug logging')
-  .hook('preAction', (thisCommand, actionCommand) => {
-    // Make global options available to all commands
-    const opts = thisCommand.opts();
-    program._apiKey = opts.apiKey || process.env.NOWPAYMENTS_API_KEY;
-    program._sandbox = opts.sandbox || false;
-    program._json = opts.json || false;
-    program._debug = opts.debug || false;
-
-    if (program._debug) {
-      console.log(chalk.gray(`[DEBUG] Command: ${actionCommand.name()}`));
-      console.log(chalk.gray(`[DEBUG] Sandbox: ${program._sandbox}`));
-    }
-  });
-
-// Register commands
-program.addCommand(authCommand);
-program.addCommand(statusCommand);
-program.addCommand(currenciesCommand);
-program.addCommand(estimateCommand);
-program.addCommand(paymentCommand);
-program.addCommand(invoiceCommand);
-program.addCommand(payoutCommand);
-
-// Display helpful message when no command is provided
-program.on('--help', () => {
-  console.log('');
-  console.log('Examples:');
-  console.log('  $ nowpayments status');
-  console.log('  $ nowpayments currencies --available');
-  console.log('  $ nowpayments estimate --from USD --to BTC --amount 100');
-  console.log('  $ nowpayments payment create --price 99.99 --currency USD --pay-currency BTC');
-  console.log('  $ nowpayments payment get <payment_id>');
-  console.log('');
-  console.log('Authentication:');
-  console.log('  Set NOWPAYMENTS_API_KEY in .env file or use --api-key flag');
-  console.log('  $ nowpayments auth set YOUR_API_KEY');
-  console.log('');
-  console.log('Documentation:');
-  console.log('  README.md - General usage and examples');
-  console.log('  AGENT.md - AI agent integration patterns');
-  console.log('  OPENCLAW.md - OpenClaw integration guide');
-});
-
-// Parse and execute
-program.parse(process.argv);
-
-// Show help if no command provided
-if (!process.argv.slice(2).length) {
-  program.outputHelp();
-}
+// Import and run the main CLI
+import(join(__dirname, '..', 'src', 'index.js'));

package/package.json

@@ -1,40 +1,41 @@
 {
   "name": "@ktmcp-cli/nowpayments",
-  "version": "1.0.0",
-  "description": "Production-ready CLI for NOWPayments cryptocurrency payment processing API",
+  "version": "1.0.2",
+  "description": "Production-ready CLI for NOWPayments API - cryptocurrency payments, invoices, subscriptions",
+  "type": "module",
   "main": "src/index.js",
   "bin": {
-    "nowpayments": "./bin/nowpayments.js"
-  },
-  "scripts": {
-    "start": "node bin/nowpayments.js",
-    "test": "node --test",
-    "lint": "eslint ."
+    "nowpayments": "bin/nowpayments.js"
   },
   "keywords": [
     "nowpayments",
     "cryptocurrency",
-    "payment",
-    "cli",
     "crypto",
+    "payments",
     "bitcoin",
     "ethereum",
-    "commander"
+    "cli",
+    "api",
+    "ktmcp"
   ],
   "author": "KTMCP",
   "license": "MIT",
-  "engines": {
-    "node": ">=16.0.0"
-  },
   "dependencies": {
     "commander": "^12.0.0",
-    "chalk": "^4.1.2",
-    "ora": "^5.4.1",
-    "dotenv": "^16.4.1",
-    "node-fetch": "^2.7.0",
-    "cli-table3": "^0.6.3"
+    "axios": "^1.6.7",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "conf": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ktmcp-cli/nowpayments.git"
   },
-  "devDependencies": {
-    "eslint": "^8.56.0"
+  "homepage": "https://killthemcp.com/nowpayments-cli",
+  "bugs": {
+    "url": "https://github.com/ktmcp-cli/nowpayments/issues"
   }
 }

package/src/api.js

@@ -0,0 +1,94 @@
+import axios from 'axios';
+import { getConfig } from './config.js';
+
+const NOWPAYMENTS_BASE_URL = 'https://api.nowpayments.io/v1';
+
+async function apiRequest(method, endpoint, data = null, params = null) {
+  const apiKey = getConfig('apiKey');
+
+  if (!apiKey) {
+    throw new Error('API key not configured. Run: nowpaymentsio config set --api-key <key>');
+  }
+
+  const config = {
+    method,
+    url: `${NOWPAYMENTS_BASE_URL}${endpoint}`,
+    headers: {
+      'x-api-key': apiKey,
+      'Content-Type': 'application/json'
+    }
+  };
+
+  if (params) config.params = params;
+  if (data) config.data = data;
+
+  try {
+    const response = await axios(config);
+    return response.data;
+  } catch (error) {
+    if (error.response) {
+      const status = error.response.status;
+      const data = error.response.data;
+      if (status === 401) {
+        throw new Error('Authentication failed. Check your API key.');
+      } else if (status === 404) {
+        throw new Error('Resource not found.');
+      } else if (status === 429) {
+        throw new Error('Rate limit exceeded.');
+      } else {
+        const message = data?.message || JSON.stringify(data);
+        throw new Error(`API Error (${status}): ${message}`);
+      }
+    } else {
+      throw error;
+    }
+  }
+}
+
+export async function getStatus() {
+  return await apiRequest('GET', '/status');
+}
+
+export async function getCurrencies() {
+  return await apiRequest('GET', '/currencies');
+}
+
+export async function getEstimate(params) {
+  return await apiRequest('GET', '/estimate', null, params);
+}
+
+export async function getMinAmount(params) {
+  return await apiRequest('GET', '/min-amount', null, params);
+}
+
+export async function listPayments(params = {}) {
+  return await apiRequest('GET', '/payment/', null, params);
+}
+
+export async function getPayment(paymentId) {
+  return await apiRequest('GET', `/payment/${paymentId}`);
+}
+
+export async function createPayment(data) {
+  return await apiRequest('POST', '/payment', data);
+}
+
+export async function createInvoice(data) {
+  return await apiRequest('POST', '/invoice', data);
+}
+
+export async function listInvoices(params = {}) {
+  return await apiRequest('GET', '/invoice', null, params);
+}
+
+export async function listPlans(params = {}) {
+  return await apiRequest('GET', '/subscriptions/plans', null, params);
+}
+
+export async function getPlan(planId) {
+  return await apiRequest('GET', `/subscriptions/plans/${planId}`);
+}
+
+export async function listSubscriptions(params = {}) {
+  return await apiRequest('GET', '/subscriptions', null, params);
+}

package/src/config.js

@@ -0,0 +1,34 @@
+import Conf from 'conf';
+
+const config = new Conf({
+  projectName: 'nowpaymentsio-cli',
+  schema: {
+    apiKey: {
+      type: 'string',
+      default: ''
+    }
+  }
+});
+
+export function getConfig(key) {
+  return config.get(key);
+}
+
+export function setConfig(key, value) {
+  config.set(key, value);
+}
+
+export function getAllConfig() {
+  return config.store;
+}
+
+export function clearConfig() {
+  config.clear();
+}
+
+export function isConfigured() {
+  const apiKey = config.get('apiKey');
+  return !!apiKey;
+}
+
+export default config;