Tradovate MCP Server

The Tradovate MCP Server is a model context protocol server for interacting with the Tradovate API, providing functions such as contract management, position management, order operations, and account management.

Finance Developer tools #Trading API #Position Management #Order System #Real-time Data Remote .JavaScript

rating : 2.5 points

downloads : 11

update time : 2025-04-28

What is the Tradovate MCP Server?

The Tradovate MCP Server is a tool for connecting and managing the Tradovate API, allowing users to access account information, market data, order management, and real-time trading functions through the model context protocol.

How to use the Tradovate MCP Server?

You need to install dependencies, set environment variables, and start the server. Then, you can use the provided API endpoints for operations.

Applicable Scenarios

The Tradovate MCP Server is suitable for professional investors and developers who need real-time trading, automated strategy development, and data monitoring.

Main Features

Authentication and AuthorizationSupports user authentication and token management through the Tradovate API.

Real-time Data AcquisitionProvides a caching mechanism to accelerate data requests and supports switching to simulated data when the API is unavailable.

Contract Details QueryAllows users to retrieve detailed information about specific contracts based on the symbol.

Order ManagementSupports placing, modifying, canceling, and closing orders.

Account Status ViewGets a snapshot of account summary information and cash balance.

Market Data AnalysisProvides functions such as quotes, depth market data, and chart generation.

Advantages and Limitations

Advantages

Easy to integrate into existing systems

Powerful real-time data processing capabilities

Supports multi-platform operation

Rich API endpoints cover comprehensive needs

Limitations

Requires a certain level of network stability

Requires familiarity with basic programming knowledge for efficient use

Simulated data may not fully reflect the real situation

How to Use

Install Dependencies

Run `npm install` to install all the dependencies required for the project.

Configure Environment Variables

Create a `.env` file and fill in your Tradovate credential information.

Start the Server

Execute the `npm start` command to start the Tradovate MCP Server.

Usage Examples

Query Contract Details of Apple Inc.The user wants to know the latest contract details about Apple Inc.

Place an Order to Buy 100 Shares of Tesla StockThe user plans to buy 100 shares of Tesla stock.

Frequently Asked Questions

How to ensure the security of my credentials?

What if the API is interrupted?

Does it support multiple currencies?

Related Resources

Official Documentation

Complete documentation for the Tradovate API.

GitHub Repository

Open-source code repository containing project source code and examples.

Technical Support Forum

Community communication platform to solve common problems.

🚀 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.

🚀 Quick Start

This is a Model Context Protocol (MCP) server designed to interact with the Tradovate API. It offers a suite of tools for managing contracts, positions, orders, and accounts.

✨ Features

Authentication with the Tradovate API.
Real-time data retrieval with caching.
Tools for contract details, position management, order placement, modification, etc.
Fallback to mock data when the API is unavailable.

📦 Installation

Clone the repository.
Install the dependencies:

npm install

Create a .env file and add 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 Examples

Basic Usage

Start the server:

npm start

Advanced Usage

Use it with the MCP Inspector:

npm run inspector

📚 Documentation

Project Structure

src/index.ts - The main server entry point.
src/auth.ts - Authentication functions.
src/data.ts - Data retrieval and caching.
src/tools.ts - MCP tool handlers.
src/types.ts - TypeScript type definitions.
tests/ - Test files.

Build

npm run build

Test

Run tests:

npm test

Run tests with coverage:

npm run test:coverage

Generate a coverage badge:

npm run coverage:badge

Available Tools

The server provides the following tools:

get_contract_details - Get detailed information about a specific contract based on its symbol.
list_positions - Get a list of positions for an account.
place_order - Place a new order.
modify_order - Modify an existing order.
cancel_order - Cancel an existing order.
liquidate_position - Liquidate a position.
get_account_summary - Get summary information about an account.
get_market_data - Get market data (quotes, depth charts).

API Endpoints

The server interacts with the following Tradovate API endpoints:

Authentication

/auth/accessTokenRequest - Get an access token.
/auth/renewAccessToken - Renew an 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 a snapshot of an account's cash balance.