Termix Skill

A collection of blockchain/crypto skills for Claude Code, enabling AI-powered wallet management, token transfers, swaps, and cross-chain bridges.

About This Repository

Termix Skill is an open-source project that provides Claude Code with blockchain operation capabilities. It combines:

1. Claude Code Skills - Prompt-based skills following the Anthropic Skills format
2. MCP Server - Model Context Protocol server for direct blockchain interaction

Features

• Wallet Management - Create wallets, derive addresses, securely manage private keys
• Token Transfers - Send native tokens and ERC20 tokens across supported networks
• DEX Swaps - Execute token swaps via OKX DEX Aggregator (aggregates 100+ DEXs)
• Cross-Chain Bridges - Transfer assets via OKX Cross-Chain API (aggregates multiple bridges)

Supported Networks

Network	Type	Chain ID
BNB Smart Chain	Mainnet	56
Ethereum	Mainnet	1
Polygon	Mainnet	137
Arbitrum	Mainnet	42161
Optimism	Mainnet	10
Base	Mainnet	8453
Avalanche	Mainnet	43114
zkSync Era	Mainnet	324
Linea	Mainnet	59144
BSC Testnet	Testnet	97
Sepolia	Testnet	11155111

Installation

Prerequisites

1. OKX API Credentials (Required for Swap & Bridge)
   • Register at OKX Developer Portal
   • Create a project and get your API credentials

As Claude Code Plugin

# Add the marketplace
/plugin marketplace add termix-skill

# Install skills
/plugin install termix-skills

As MCP Server

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your OKX credentials and wallet private key

# Start the server
npm start

Claude Desktop Configuration

Add to ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "termix-skill": {
      "command": "npx",
      "args": ["-y", "termix-skill"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here",
        "OKX_PROJECT_ID": "your_project_id",
        "OKX_API_KEY": "your_api_key",
        "OKX_SECRET_KEY": "your_secret_key",
        "OKX_API_PASSPHRASE": "your_passphrase"
      }
    }
  }
}

MCP Tools

Wallet Tools

Tool	Description
create_wallet	Generate a new wallet with random private key
get_address	Derive address from private key
validate_address	Validate and checksum an address
get_native_balance	Get native token balance (ETH, BNB, etc.)
get_token_balance	Get ERC20 token balance
list_networks	List all supported networks

Transfer Tools

Tool	Description
transfer_native	Send native tokens to an address
transfer_token	Send ERC20 tokens to an address
approve_token	Approve token spending for DEX/Bridge
check_allowance	Check token approval amount
estimate_transfer_gas	Estimate gas for a transfer

Swap Tools (OKX DEX Aggregator)

Tool	Description
get_swap_quote	Get best swap quote across 100+ DEXs
execute_swap	Execute token swap
get_swap_tokens	List supported tokens on a chain
list_swap_chains	List supported chains

Bridge Tools (OKX Cross-Chain API)

Tool	Description
get_bridge_quote	Get best bridge quote across multiple bridges
execute_bridge	Execute cross-chain transfer
get_bridge_chains	List supported chains for bridging
get_bridge_tokens	List bridgeable tokens
get_supported_bridges	List available bridge protocols

Security

• Private keys are NEVER logged or stored in responses
• All sensitive operations require explicit user confirmation
• OKX API uses HMAC-SHA256 signed requests
• Supports hardware wallet integration (coming soon)

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run in SSE mode (for Cursor)
npm run dev:sse

# Run tests
npm test

# Build for production
npm run build

Project Structure

termix-skill/
├── .claude-plugin/
│   └── marketplace.json          # Claude Code plugin registry
├── skills/
│   ├── wallet/                   # Wallet management skill
│   ├── transfer/                 # Token transfer skill
│   ├── swap/                     # DEX swap skill
│   └── bridge/                   # Cross-chain bridge skill
├── src/
│   ├── server/                   # MCP server implementation
│   ├── evm/
│   │   ├── modules/              # Feature modules (wallet, tokens, swap, bridge)
│   │   └── services/             # Blockchain services (viem clients)
│   └── utils/
│       ├── okx-auth.ts           # OKX API authentication
│       ├── logger.ts             # Logging utility
│       └── response.ts           # MCP response helpers
├── template/                     # Skill template
└── package.json

Acknowledgements

This project is built upon and inspired by:

• Anthropic Skills - The skill format and plugin architecture
• BNB Chain MCP - The MCP server architecture and blockchain interaction patterns
• OKX DEX API - Swap and Cross-Chain aggregation APIs

Special thanks to the BNB Chain team for their excellent open-source MCP implementation, which served as the foundation for our blockchain integration layer.

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

License

Apache 2.0 - See LICENSE for details.

---

Built with support from the BNB Chain ecosystem and OKX Web3 APIs.