Privateness MCP Server

MCP server providing HTTP/JSON access to all Privateness CLI functionality for team development workflows.

Features

Complete CLI Coverage: All 40+ privateness-cli commands organized by category
Multiple API Styles: Category-based routes, generic commands, and legacy RPC
Environment Integration: Supports all privateness-cli environment variables
Team Development: Self-hosted API for internal tooling
Port 7332: Avoids common port conflicts

Prerequisites

Node.js 14.0.0 or higher
privateness-cli in your PATH or specified via environment variable
Privateness node running (default: http://127.0.0.1:6660)

Installation

git clone this repository
cd privateness-mcp-server
npm install

Configuration

Configure using environment variables (same as privateness-cli):

export PORT=7332                           # Server port (default: 7332)
export PRIVATENESS_CLI_PATH=privateness-cli # Path to privateness-cli
export RPC_ADDR=http://127.0.0.1:6660      # RPC node address
export RPC_USER=username                   # RPC username (if enabled)
export RPC_PASS=password                   # RPC password (if enabled)
export COIN=privateness                    # Coin name
export DATA_DIR=./data                     # Data directory

Running the Server

npm start
# or for development:
npm run dev

API Endpoints

Discovery & Health

GET /health - Server health and statistics
GET /endpoints - List all available commands by category

Command Categories

Wallet Management

POST /wallet/walletCreate - Create new wallet
POST /wallet/listWallets - List all wallets
POST /wallet/listAddresses - List wallet addresses
POST /wallet/addPrivateKey - Add private key to wallet
POST /wallet/encryptWallet - Encrypt wallet
POST /wallet/showSeed - Show wallet seed

Address Operations

POST /address/addressGen - Generate addresses
POST /address/addressBalance - Check address balance
POST /address/addressOutputs - Display address outputs
POST /address/verifyAddress - Verify address format

Balance & Outputs

POST /balance/walletBalance - Check wallet balance
POST /balance/walletOutputs - Display wallet outputs
POST /balance/walletHistory - Show wallet transaction history

Transactions

POST /transaction/send - Send coins
POST /transaction/createRawTransaction - Create raw transaction
POST /transaction/signTransaction - Sign transaction
POST /transaction/broadcastTransaction - Broadcast transaction
POST /transaction/pendingTransactions - Get pending transactions

Blockchain

POST /blockchain/status - Node status
POST /blockchain/blocks - Get block information
POST /blockchain/lastBlocks - Get recent blocks
POST /blockchain/version - Get version info

System

POST /system/showConfig - Show configuration
POST /system/checkdb - Verify database

Generic Command Routes

POST /cmd/:command - Execute any privateness-cli command
POST /rpc - Legacy RPC passthrough

Request Format

All endpoints accept JSON with parameters and flags:

{
  "params": ["param1", "param2"],
  "flags": {
    "wallet": "my-wallet.wlt",
    "password": "secret",
    "amount": "100"
  }
}

Examples

Create a new wallet:

curl -X POST http://localhost:7332/wallet/walletCreate \
  -H "Content-Type: application/json" \
  -d '{"flags": {"wallet": "team-wallet.wlt", "label": "Team Wallet"}}'

Check wallet balance:

curl -X POST http://localhost:7332/balance/walletBalance \
  -H "Content-Type: application/json" \
  -d '{"flags": {"wallet": "team-wallet.wlt"}}'

Send coins:

curl -X POST http://localhost:7332/transaction/send \
  -H "Content-Type: application/json" \
  -d '{
    "flags": {
      "wallet": "team-wallet.wlt",
      "to": "recipient_address",
      "amount": "10.5"
    }
  }'

Generate addresses:

curl -X POST http://localhost:7332/address/addressGen \
  -H "Content-Type: application/json" \
  -d '{"flags": {"num": "5", "coin": "privateness"}}'

Get node status:

curl -X POST http://localhost:7332/blockchain/status \
  -H "Content-Type: application/json" \
  -d '{}'

Command Categories

Wallet (11 commands)

Wallet creation, management, encryption, and key operations.

Address (6 commands)

Address generation, verification, and balance checking.

Balance (3 commands)

Wallet balance, outputs, and transaction history.

Transaction (9 commands)

Creating, signing, broadcasting, and managing transactions.

Blockchain (5 commands)

Node status, blocks, and network information.

System (6 commands)

Configuration, database verification, and help.

Error Handling

Detailed error responses include:

Error message
stderr output from privateness-cli
Exit code
Command name for context

Security

Network Security: Run behind HTTPS reverse proxy for production
Access Control: Use firewall rules to limit access
Credentials: Secure RPC credentials if authentication enabled
Local Development: Designed for team development workflows

Development

npm run dev  # Auto-reload on changes

License

MIT

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Provides HTTP/JSON access to all Privateness CLI functionality for cryptocurrency wallet management, transactions, and blockchain operations. Enables team development workflows by exposing 40+ privateness-cli commands through REST API endpoints.

Related MCP Servers

Penumbra MCP Server
bmorphism
A
security
F
license
A
quality
Enables privacy-preserving interactions with the Penumbra blockchain, offering tools for transaction queries, validator set information, DEX state, and governance proposals.
Last updated -
5
4
Cryptocurrency Daemon MCP Server
raw391
-
security
F
license
-
quality
Enables secure interactions with cryptocurrency daemon RPC interfaces through AI assistants, supporting transaction management, wallet operations, and daemon monitoring for Bitcoin-derived cryptocurrencies.
Last updated -
1
Ethereum RPC MCP Server
0xKoda
A
security
A
license
A
quality
Provides tools for AI assistants to interact with the Ethereum blockchain through standard JSON-RPC methods, enabling queries for account balances, gas prices, and smart contract code.
Last updated -
3
10
MIT License
Furikake
ashwwwin
-
security
F
license
-
quality
A local CLI & API for MCP management that allows users to download, install, manage, and interact with MCPs from GitHub, featuring process state management, port allocation, and HTTP API routes.
Last updated -
78

View all related MCP servers