Tradovate MCP Server

A Model Context Protocol (MCP) server for interacting with the Tradovate API. This server provides tools for managing contracts, positions, orders, and accounts in Tradovate.

Features

• Authentication with Tradovate API
• Real-time data fetching with caching
• Tools for contract details, position management, order placement, and more
• Fallback to simulated data when API is unavailable

Installation

1. Clone the repository

2. Install dependencies:

npm install

3. Create a `.env` file with your Tradovate credentials:

TRADOVATE_API_ENVIRONMENT=demo
TRADOVATE_USERNAME=your_username
TRADOVATE_PASSWORD=your_password
TRADOVATE_APP_ID=Sample App
TRADOVATE_APP_VERSION=1.0
TRADOVATE_CID=your_cid
TRADOVATE_SEC=your_sec

Usage

Start the server:

npm start

Or use with the MCP Inspector:

npm run inspector

Development

Project Structure

• `src/index.ts` - Main server entry point
• `src/auth.ts` - Authentication functions
• `src/data.ts` - Data fetching and caching
• `src/tools.ts` - Tool handlers for MCP
• `src/types.ts` - TypeScript type definitions
• `tests/` - Test files

Building

npm run build

Testing

Run tests:

npm test

Run tests with coverage:

npm run test:coverage

Generate coverage badge:

npm run coverage:badge

Available Tools

The server provides the following tools:

1. `get_contract_details` - Get details for a specific contract by symbol

2. `list_positions` - List positions for an account

3. `place_order` - Place a new order

4. `modify_order` - Modify an existing order

5. `cancel_order` - Cancel an existing order

6. `liquidate_position` - Liquidate a position

7. `get_account_summary` - Get account summary information

8. `get_market_data` - Get market data (quotes, DOM, charts)

API Endpoints

The server interacts with the following Tradovate API endpoints:

Authentication

• `/auth/accessTokenRequest` - Get access token
• `/auth/renewAccessToken` - Renew access token

Contracts

• `/contract/list` - List all contracts
• `/contract/find` - Find a specific contract

Positions

• `/position/list` - List all positions

Orders

• `/order/list` - List all orders
• `/order/placeOrder` - Place a new order
• `/order/modifyOrder` - Modify an existing order
• `/order/cancelOrder` - Cancel an existing order
• `/order/liquidatePosition` - Liquidate a position

Accounts

• `/account/list` - List all accounts
• `/account/find` - Find a specific account
• `/cashBalance/getCashBalanceSnapshot` - Get cash balance for an account

Market Data

• `/md/getQuote` - Get quote data
• `/md/getDOM` - Get depth of market data
• `/md/getChart` - Get chart data

License

MIT License

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