Installation

January 29, 2026 ยท View on GitHub

This guide covers installing Universal Crypto MCP for both end-users and developers.

Prerequisites

Before installing, ensure you have:

  • Node.js 18+ (LTS recommended)
  • pnpm (recommended) or npm/yarn
  • Git (for development)

Quick Install

For Claude Desktop Users

The fastest way to get started is using npx:

npx @nirholas/universal-crypto-mcp

Or install globally:

npm install -g @nirholas/universal-crypto-mcp

Individual Packages

Install only the packages you need:

# Trading packages
npm install @universal-crypto-mcp/trading-binance
npm install @universal-crypto-mcp/trading-binance-us

# Market data
npm install @universal-crypto-mcp/market-data-aggregator
npm install @universal-crypto-mcp/market-data-coingecko

# Wallet management
npm install @universal-crypto-mcp/wallet-evm
npm install @universal-crypto-mcp/wallet-solana

# DeFi protocols
npm install @universal-crypto-mcp/defi-aave
npm install @universal-crypto-mcp/defi-uniswap

# Payments
npm install @universal-crypto-mcp/payments-x402

For Development

Clone and set up the full monorepo:

# Clone the repository
git clone https://github.com/nirholas/universal-crypto-mcp.git
cd universal-crypto-mcp

# Install dependencies (pnpm recommended)
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

Add to Claude Desktop

Configure Claude Desktop to use Universal Crypto MCP by editing your claude_desktop_config.json:

macOS

# Open the config file
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows

# Open the config file
notepad %APPDATA%\Claude\claude_desktop_config.json

Linux

# Open the config file
nano ~/.config/Claude/claude_desktop_config.json

Configuration

Add the following to your config file:

{
  "mcpServers": {
    "universal-crypto": {
      "command": "npx",
      "args": ["@nirholas/universal-crypto-mcp"]
    }
  }
}

With Environment Variables

For features requiring API keys:

{
  "mcpServers": {
    "universal-crypto": {
      "command": "npx",
      "args": ["@nirholas/universal-crypto-mcp"],
      "env": {
        "COINGECKO_API_KEY": "your-api-key",
        "X402_PRIVATE_KEY": "your-private-key"
      }
    }
  }
}

Add to Cursor

Configure Cursor to use Universal Crypto MCP in your .cursor/mcp.json:

{
  "mcpServers": {
    "universal-crypto": {
      "command": "npx",
      "args": ["@nirholas/universal-crypto-mcp"]
    }
  }
}

Add to ChatGPT

For ChatGPT, use HTTP mode:

# Start the server in HTTP mode
npx @nirholas/universal-crypto-mcp --http --port 3000

Then configure ChatGPT to connect to http://localhost:3000.

Verify Installation

Test that the server is working:

# Run in stdio mode (default)
npx @nirholas/universal-crypto-mcp

# Or test with a simple command
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | npx @nirholas/universal-crypto-mcp

Next Steps