tradekit

CLI and MCP server for trading ERC-20 tokens on Uniswap V3.

Install

npm install -g tradekit

Or run directly:

npx tradekit

Quick Start

# Create a wallet
tradekit wallet create

# Check balances
tradekit wallet view --chain base

# Buy ETH with 10 USDC
tradekit trade buy --quoteAmount 10

# Sell 0.01 ETH
tradekit trade sell --baseAmount 0.01

Commands

Wallet

tradekit wallet create     # Create a new encrypted wallet
tradekit wallet import     # Import from private key
tradekit wallet export     # Export private key
tradekit wallet view       # View address and balances

Trade

tradekit trade buy         # Buy base token
tradekit trade sell        # Sell base token

Options:

| Flag | Description | Default | |------|-------------|---------| | --chain <name> | Chain name | base | | --base <token> | Base token address or ETH | ETH | | --quote <token> | Quote token address | USDC | | --baseAmount <n> | Exact base token amount | - | | --quoteAmount <n> | Exact quote token amount | - | | --slippage <bps> | Slippage in basis points | 50 |

MCP Server

tradekit mcp --pass <password>

Starts a Model Context Protocol server over stdio, exposing the following tools:

| Tool | Description | |------|-------------| | status | Wallet address, balances, current price, recent trades | | buy | Buy base token (by base or quote amount) | | sell | Sell base token (by base or quote amount) | | price | Current and historical prices (1d/1w/1m/1y) | | viewTx | Look up transaction details by hash |

MCP config example (Claude Desktop):

{
  "mcpServers": {
    "tradekit": {
      "command": "npx",
      "args": ["-y", "tradekit", "mcp"],
      "env": {
        "WALLET_PASS": "your-password"
      }
    }
  }
}

Password

Wallet password is resolved in order:

1. --pass <password> flag
2. WALLET_PASS environment variable
3. Interactive prompt (not available in MCP mode)

Supported Chains

| Chain | ID | Default Tokens | |-------|----|---------------| | base | 8453 | ETH / USDC | | ethereum | 1 | ETH / USDC | | arbitrum | 42161 | ETH / USDC |

Configuration

Optional config file at ~/.tradekit/config.json:

{
  "chains": {
    "base": {
      "rpc": "https://your-rpc.com",
      "base": "0x...",
      "quote": "0x..."
    }
  }
}

All fields are optional and override built-in defaults.

Data Storage

All data is stored in ~/.tradekit/:

| File | Content | |------|---------| | wallet.json | Encrypted keystore | | config.json | User configuration | | trade.csv | Trade history | | server.log | Logs |

License

MIT