CVEX MCP Server

A Model Context Protocol (MCP) server for interacting with the CVEX Trading API. This server allows Claude to interact with the CVEX trading platform, view market data, account information, and execute trades.

Features

- 🔍 Market Data Access: View available contracts and real-time market data
- 💰 Account Management: Check account balances and position information
- 📊 Trading Capabilities: Place and manage orders directly through Claude
- 🔐 Secure Trading: Private keys are only accessed when needed for signing requests

Installation

npm install -g @modelcontextprotocol/server-cvex

Usage with Claude Desktop

To use this server with Claude Desktop, run:

claude --mcp "npx @modelcontextprotocol/server-cvex --api-key YOUR_API_KEY --private-key-path /path/to/private_key.pem"

Replace YOUR_API_KEY with your actual CVEX API key and /path/to/private_key.pem with the path to your private key file.

Command Line Options

| Option | Description |
|--------|-------------|
| --api-key <key> | Your CVEX API key |
| --private-key-path <path> | Path to your private key file (required for trading operations) |
| --api-url <url> | CVEX API URL (default: https://api.cvex.trade) |
| --help | Show help information |
| --version | Show version number |

Available Tools

The MCP server provides the following tools to Claude:

1. getMarketData: Get market data for a specific contract
2. getContractDetails: Get detailed information about a specific contract
3. getAccountInformation: Get account information including balances
4. estimateOrder: Estimate an order without executing it
5. placeOrder: Place a new order on the exchange

Example Queries for Claude

Once connected, you can ask Claude to:

What contracts are available on CVEX?
Show me the current market data for BTCUSD
What's my account balance?
Estimate how much it would cost to buy 0.1 BTC at market price
Place a limit order to buy 0.01 ETH at $4000

Security Considerations

- Your private key is only read when needed for signing trading requests
- The private key is never stored in memory longer than necessary
- All API requests use secure HTTPS connections
- Always verify order details before confirming trades
- Never share your terminal session when using the CVEX MCP server

Development

1. Clone the repository
2. Install dependencies with npm install
3. Build the project with npm run build
4. Run the server with node dist/cli.js [options]

See Also

- USAGE.md for more detailed usage examples
- CVEX API Documentation

License

MIT