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.

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/cc-trading-terminal

Add to Claude Code

claude mcp add cc-trading-terminal \
  -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