MCP Tradovate Server


A Model Context Protocol (MCP) server for Tradovate integration in Claude Desktop. This server enables AI assistants to manage Tradovate trading accounts through natural language interactions.

Features

- ✅ Complete Tradovate API integration
- 🔒 Secure authentication handling
- 📈 Real-time market data access
- 💼 Account management
- 📊 Risk management controls
- 🔄 Order placement and management
- 📝 Comprehensive test coverage

Installation

Installing via Smithery

To install the Tradovate MCP server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @0xjmp/mcp-tradovate --client claude

Manual Installation

1. Clone the repository:

git clone https://github.com/0xjmp/mcp-tradovate.git

cd mcp-tradovate

2. Install dependencies:

go mod download

3. Build the project:

go build ./cmd/mcp-tradovate

4. Run:

./mcp-tradovate

Configuration

Create a .env file in the project root with your Tradovate credentials:

TRADOVATE_USERNAME=your_username
TRADOVATE_PASSWORD=your_password
TRADOVATE_APP_ID=your_app_id
TRADOVATE_APP_VERSION=your_app_version
TRADOVATE_CID=your_client_id
TRADOVATE_SEC=your_client_secret

Available Tools

Authentication

- authenticate: Connect to Tradovate API - No parameters required

Account Management

- get_accounts: List all trading accounts - No parameters required

- get_positions: View current positions
- No parameters required

- get_risk_limits: Get risk management settings
- Required parameters:
- account_id: (number) Account ID to get limits for

- set_risk_limits: Configure risk management settings
- Required parameters:
- account_id: (number) Account ID to set limits for
- day_max_loss: (number) Maximum daily loss limit
- max_drawdown: (number) Maximum drawdown limit
- max_position_qty: (number) Maximum position quantity
- trailing_stop: (number) Trailing stop percentage

Trading Operations

- place_order: Submit a new order - Required parameters: - account_id: (number) Account ID to place the order for - contract_id: (number) Contract ID to trade - order_type: (string) Type of order (Market, Limit, etc.) - quantity: (number) Number of contracts to trade - time_in_force: (string) Time in force (Day, GTC, IOC, etc.) - Optional parameters: - price: (number) Order price (required for Limit orders)

- cancel_order: Cancel an existing order
- Required parameters:
- order_id: (number) Order ID to cancel

- get_fills: Get fills for a specific order
- Required parameters:
- order_id: (number) Order ID to get fills for

Market Data

- get_contracts: List available contracts - No parameters required

- get_market_data: Get real-time market data
- Required parameters:
- contract_id: (number) Contract ID to get market data for

- get_historical_data: Get historical price data
- Required parameters:
- contract_id: (number) Contract ID to get data for
- start_time: (string) Start time in ISO 8601 format
- end_time: (string) End time in ISO 8601 format
- interval: (string) Time interval (1m, 5m, 15m, 1h, 1d)

Development

Running Tests

Run all tests with coverage:

go test -v -race -coverprofile=coverage.txt -covermode=atomic ./...

Code Style

Follow Go best practices and conventions:

go fmt ./...

go vet ./...

Troubleshooting

Common Issues

1. Authentication Failures
- Verify your Tradovate credentials in the .env file
- Ensure your API access is enabled in Tradovate

2. Connection Issues
- Check your internet connection
- Verify Tradovate API status
- Ensure firewall isn't blocking connections

3. Rate Limiting
- Implement appropriate delays between requests
- Monitor API usage limits

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any issues or have questions, please file an issue on the GitHub repository.

Author

Jake Peterson (@0xjmp)