CC Trading Terminal

An MCP server that lets Claude Code (and other MCP clients) trade crypto, read market data, and manage wallets across EVM chains and Solana.

Version License: MIT

What it does

Connect this server to your AI agent and it can:

• Trade on EVM chains — get swap quotes, execute trades, and use gasless swaps on 17 networks (Ethereum, Base, Arbitrum, Optimism, Polygon, and others)
• Trade on Solana — swap via Jupiter/Raydium/Meteora, place limit orders, check balances, send SOL
• Research markets — token prices, trending pools, OHLCV, and pool data via CoinGecko
• Run memecoin workflows — PumpFun trending, quick buys, launch scanning, and an optional auto-buy bot
• Manage wallets — generate, import, and back up multiple EVM and Solana wallets locally
• Stream live data — optional pipeline for ingesting and processing real-time market feeds

Your keys stay on your machine. The server signs transactions locally and never sends private keys anywhere.

Quick start

Install

npm install @degentic/smart-trade-ai

Add to Claude Code

claude mcp add smart-trade-ai \
  -e USER_PRIVATE_KEY=your_evm_private_key \
  -e USER_ADDRESS=0xYourEVMWalletAddress \
  -e COINGECKO_API_KEY=your_coingecko_api_key \
  -e ALCHEMY_API_KEY=your_alchemy_api_key \
  -e SOLANA_PRIVATE_KEY=your_solana_private_key \
  -- npx cc-trading-terminal

Check it’s connected

claude mcp list

Run the setup wizard for sample configs and a dev .env template:

npm run setup
npm run setup:dev   # copies .env.example → .env for local work

Environment variables

Variable	Required	Purpose
USER_PRIVATE_KEY	Yes	EVM wallet used to sign trades
USER_ADDRESS	Yes	EVM wallet address
COINGECKO_API_KEY	Yes	Market data (pools, prices, OHLCV)
ALCHEMY_API_KEY	No	Better RPC endpoints when available
SOLANA_PRIVATE_KEY	No	Enables Solana tools (base58, hex, or JSON array)

Generate a new EVM wallet without leaving the terminal:

npx cc-trading-terminal --create-wallet

How to use it

Once the MCP server is running, ask your agent in plain language — for example:

• “Get a swap quote for 0.1 ETH → USDC on Base.”
• “Show trending pools on Ethereum.”
• “What’s my SOL balance?”
• “Swap 1 SOL to BONK with low slippage.”

The agent picks the right tool automatically. You don’t need to memorize tool names.

Tools group roughly into: EVM swaps & portfolio, CoinGecko data, Solana wallet & DEX, memecoin / PumpFun, wallet vault, and unit conversion helpers.

Solana CLI scripts

For quick shell workflows (no MCP required), use the scripts in solana_commands/:

node solana_commands/solana-balance-check.js [address] [cluster]
node solana_commands/solana-transfer.js <recipient> <amount> [cluster]
node solana_commands/solana-airdrop-request.js [amount] [cluster]   # devnet/testnet

Set SOLANA_PRIVATE_KEY in your environment or .env first.

Data pipeline (optional)

The built-in pipeline pulls live market data over WebSockets, validates and normalizes it, and can store history for backtesting or monitoring. Most users only need the MCP tools; run the pipeline when you want a always-on data feed.

npm run pipeline:start

Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Data Sources  │───▶│   Pipeline Core  │───▶│   Consumers     │
├─────────────────┤    ├──────────────────┤    ├─────────────────┤
│ • CC Terminal   │    │ • Connection Mgr │    │ • Trading Bots  │
│ • Binance       │    │ • Queue Manager  │    │ • Risk Systems  │
│ • Coinbase      │    │ • Data Processor │    │ • Analytics     │
│ • CoinGecko     │    │ • Validator      │    │ • Monitoring    │
│ • Uniswap       │    │ • Transformer    │    │ • Historical DB │
│ • Custom APIs   │    │ • Enricher       │    │ • Dashboards    │
└─────────────────┘    └──────────────────┘    └─────────────────┘

See src/pipeline/examples/startDataPipeline.js for a programmatic setup.

Security

• Private keys and signing happen only on your device
• Use a dedicated trading wallet, not your main holdings
• Encrypted wallet backups use AES-256-CBC — pick a strong password
• Never commit .env, keys, or wallets/ to git

License

MIT