Tradovate MCP Server

Tradovate MCP Server

codecov

License: MIT

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.