Skip to content

Package Overview

Universal Crypto MCP is organized as a modular monorepo with specialized packages for different functionality areas.

Package Architecture

packages/
├── core/               # Shared types, utilities, configuration
├── shared/             # Common utilities and helpers
├── trading/            # CEX exchange integrations
├── market-data/        # Prices, news, analytics
├── wallets/            # Wallet management
├── defi/               # On-chain DeFi protocols
├── payments/           # Payment infrastructure
├── agents/             # Autonomous agent tools
├── automation/         # Bots & automation
├── generators/         # Meta-tools for building MCP servers
├── infrastructure/     # Infrastructure tools
└── marketplace/        # Tool marketplace

Package Categories

Core Packages

Package Description npm
@universal-crypto-mcp/core Shared types, configuration, base classes npm
@universal-crypto-mcp/shared Common utilities and helpers npm

Trading Packages

Package Description npm
@universal-crypto-mcp/trading-binance Binance spot & futures trading npm
@universal-crypto-mcp/trading-binance-us Binance US trading npm

Market Data Packages

Package Description npm
@universal-crypto-mcp/market-data-aggregator Multi-provider price aggregation npm
@universal-crypto-mcp/market-data-coingecko CoinGecko integration npm
@universal-crypto-mcp/market-data-news Crypto news aggregation npm

Wallet Packages

Package Description npm
@universal-crypto-mcp/wallet-evm Ethereum & EVM wallet management npm
@universal-crypto-mcp/wallet-solana Solana wallet management npm

DeFi Packages

Package Description npm
@universal-crypto-mcp/defi-protocols Multi-protocol DeFi tools npm
@universal-crypto-mcp/defi-aave Aave lending integration npm
@universal-crypto-mcp/defi-uniswap Uniswap DEX integration npm

Payment Packages

Package Description npm
@universal-crypto-mcp/payments-x402 x402 payment protocol npm

Installation

Full Package

Install everything:

npm install @nirholas/universal-crypto-mcp

Individual Packages

Install only what you need:

# Core (always required)
npm install @universal-crypto-mcp/core

# Add trading
npm install @universal-crypto-mcp/trading-binance

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

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

Package Dependencies

graph TD
    A[core] --> B[trading]
    A --> C[market-data]
    A --> D[wallets]
    A --> E[defi]
    A --> F[payments]
    D --> E
    A --> G[shared]
    G --> B
    G --> C
    G --> D
    G --> E
    G --> F

Quick Start

Using the Aggregated Package

import { createServer } from "@nirholas/universal-crypto-mcp";

const server = createServer({
  modules: ["trading", "market-data", "wallets", "defi", "payments"],
});

await server.start();

Using Individual Packages

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { registerMarketDataTools } from "@universal-crypto-mcp/market-data-aggregator";
import { registerTradingTools } from "@universal-crypto-mcp/trading-binance";
import { registerWalletTools } from "@universal-crypto-mcp/wallet-evm";

const server = new McpServer({
  name: "my-crypto-mcp",
  version: "1.0.0",
});

registerMarketDataTools(server);
registerTradingTools(server, { apiKey: "...", apiSecret: "..." });
registerWalletTools(server, { privateKey: "..." });

await server.start();

Package Details