Emercoin MCP Server

Emercoin MCP Server v0.2

A comprehensive Model Context Protocol (MCP) server that provides HTTP/JSON access to all Emercoin CLI functionality with integrated formatting utilities.

Features

Complete RPC Coverage: All 100+ Emercoin RPC endpoints organized by category
Formatting Integration: Built-in support for emercoin-format.py and emercoin-value.py utilities
Multiple API Styles: Category-based routes, generic RPC calls, and legacy compatibility
Enhanced Error Handling: Detailed error responses with stderr output and exit codes
Auto-Discovery: /endpoints route lists all available methods by category
Health Monitoring: Comprehensive health check with endpoint count
CORS Support: Cross-origin requests enabled
High Performance: Uses spawn for better process management

Prerequisites

Node.js 14.0.0 or higher
Python 3 (for formatting utilities)
Emercoin daemon (emercoind) running with RPC enabled
emercoin-cli in your PATH or specified via environment variable

Installation

git clone <repository>
cd emercoin-mcp-server
npm install

Configuration

Configure using environment variables:

export PORT=7331                    # Server port (default: 7331)
export EMERCOIN_CLI_PATH=emercoin-cli  # Path to emercoin-cli
export RPC_USER=your_rpc_username      # RPC username
export RPC_PASSWORD=your_rpc_password  # RPC password  
export RPC_PORT=6662                   # RPC port (default: 6662)
export RPC_HOST=127.0.0.1             # RPC host (default: 127.0.0.1)

Running the Server

npm start
# or for development with auto-reload:
npm run dev

API Endpoints

Discovery & Health

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

Category-Based Routes

All RPC methods are available via category-based routes:

Blockchain Operations

POST /blockchain/getblockchaininfo
POST /blockchain/getblockcount
POST /blockchain/getbestblockhash
POST /blockchain/getblock - params: ["blockhash", verbosity]
And 20+ more blockchain endpoints...

Name Operations (Emercoin's unique feature)

POST /names/name_show - params: ["name", "valuetype", "filepath"]
POST /names/name_new - params: ["name", "value", days, "toaddress", "valuetype"]
POST /names/name_update - params: ["name", "value", days, "toaddress", "valuetype"]
POST /names/name_filter - params: ["regexp", maxage, from, nb, "stat", "valuetype"]
And 10+ more name endpoints...

Wallet Operations

POST /wallet/getbalance
POST /wallet/getnewaddress - params: ["label", "address_type"]
POST /wallet/sendtoaddress - params: ["address", amount, "comment", "comment_to", ...]
POST /wallet/listtransactions
And 40+ more wallet endpoints...

Other Categories

Control: getinfo, stop, uptime, etc.
Mining: getmininginfo, getblocktemplate, etc.
Network: getpeerinfo, getnetworkinfo, etc.
Raw Transactions: createrawtransaction, signrawtransaction, etc.
Utilities: validateaddress, estimatesmartfee, etc.
Randpay: Emercoin's micropayment system
ZMQ: Notification system

Generic RPC Routes

POST /rpc/:method - Call any RPC method directly
POST /rpc - Legacy RPC passthrough

Request Format

All endpoints accept JSON with optional formatting:

{
  "params": ["param1", "param2"],
  "format": true,        // Apply emercoin-format.py
  "extractValue": true   // Apply emercoin-value.py
}

Examples

Get blockchain info:

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

Show name with formatting:

curl -X POST http://localhost:7331/names/name_show \
  -H "Content-Type: application/json" \
  -d '{"params": ["dns:emercoin.com"], "format": true}'

Extract value from name:

curl -X POST http://localhost:7331/names/name_show \
  -H "Content-Type: application/json" \
  -d '{"params": ["dns:emercoin.com"], "extractValue": true}'

Send EMC:

curl -X POST http://localhost:7331/wallet/sendtoaddress \
  -H "Content-Type: application/json" \
  -d '{"params": ["EMC_ADDRESS", 1.0, "Payment", "To John"]}'

Formatting Utilities

The server integrates two Python utilities:

emercoin-format.py

Cleans text output by replacing literal \n with actual line breaks.

emercoin-value.py

Extracts the value field from JSON responses, useful for name operations.

Enable formatting by adding "format": true or "extractValue": true to your request body.

Security Considerations

Network Security: Run behind HTTPS reverse proxy
Access Control: Use firewall rules to limit access
Credentials: Use strong RPC credentials, consider rpcauth
Port Security: Default port 7331 avoids common conflicts
Input Validation: All user input is properly escaped

Error Handling

Detailed error responses include:

Error message
stderr output from emercoin-cli
Exit code
Method name for context

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 complete HTTP/JSON access to all 100+ Emercoin RPC endpoints with integrated formatting utilities. Enables blockchain operations, name system management, wallet functions, and mining operations through a comprehensive REST API interface.

Related MCP Servers

MCP Etherscan Server
crazyrabbitLTC
A
security
A
license
A
quality
Facilitates interaction with Ethereum blockchain data via Etherscan's API, providing real-time access to balances, transactions, token transfers, contract ABIs, gas prices, and ENS name resolutions.
Last updated -
14
26
MIT License
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
MCP Etherscan Server
5ajaki
A
security
A
license
A
quality
Provides Ethereum blockchain data tools via Etherscan's API, enabling users to check ETH balances, view transactions, track token transfers, fetch contract ABIs, monitor gas prices, and resolve ENS names.
Last updated -
14
1
MIT License
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

View all related MCP servers

Emercoin MCP Server