What is Tradovate Mcp Server

Tradovate MCP Server is a Model Context Protocol server designed to interact with the Tradovate API, providing tools for managing contracts, positions, orders, and accounts.

Use cases

Use cases include fetching market data, managing trading positions, placing and modifying orders, and obtaining account summaries.

How to use

To use Tradovate MCP Server, clone the repository, install dependencies with ‘npm install’, create a ‘.env’ file with your Tradovate credentials, and start the server using ‘npm start’.

Key features

Key features include authentication with the Tradovate API, real-time data fetching with caching, tools for contract details, position management, order placement, and a fallback to simulated data when the API is unavailable.

Where to use

Tradovate MCP Server is primarily used in the financial trading sector, particularly for trading futures and managing trading accounts.

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.