Tradovate MCP Server Adaptation

An implementation of the Model Context Protocol (MCP) server designed for seamless interaction with the Tradovate trading infrastructure. This service furnishes the necessary utilities for maintaining oversight of financial instruments, managing open positions, routing orders, and monitoring account status within the Tradovate ecosystem.

Key Capabilities

Secure credential exchange with the Tradovate API gateway.
High-speed data acquisition mechanisms supplemented by internal storage for rapid access.
Comprehensive utilities for querying instrument specifics, overseeing inventory allocation, submitting transactional requests, and further operational tasks.
Provisions for utilizing mock or simulated transactional streams in scenarios where the live API is inaccessible.

Deployment Procedure

Obtain a local copy of the source repository.
Install requisite project dependencies:

bash npm install

Populate the .env configuration file utilizing your proprietary Tradovate access keys:

bash 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

Operational Execution

Initiate the server process:

bash npm start

Alternatively, invoke the integrated MCP Inspector utility:

bash npm run inspector

Development Lifecycle

Source Code Organization

src/index.ts - Primary bootstrap file for server initiation.
src/auth.ts - Module handling all authorization protocols.
src/data.ts - Logic governing data retrieval and caching strategies.
src/tools.ts - Implementation details for the exposed MCP functional interfaces.
src/types.ts - Central repository for all defined type schemas.
tests/ - Directory containing all unit and integration validation scripts.

Compilation

Execute the build sequence:

bash npm run build

Validation

Run all automated verification suites:

bash npm test

Execute tests while generating performance metrics:

bash npm run test:coverage

Generate the standardized metric summary badge:

bash npm run coverage:badge

Available MCP Functionalities

The server exposes the following callable utilities:

get_contract_details - Retrieves comprehensive specifications for a designated trading instrument via its ticker symbol.
list_positions - Fetches a catalog of all currently active inventory holdings associated with a specified trading account.
place_order - Submits a request to introduce a new transactional instruction.
modify_order - Transmits updates to an already pending transactional instruction.
cancel_order - Revokes an outstanding transactional instruction.
liquidate_position - Initiates the closure of an existing asset holding.
get_account_summary - Obtains high-level aggregated data pertaining to the specified account status.
get_market_data - Accesses current pricing quotes, the order book depth (DOM), and historical chart series.

Interfaced API Routes

The underlying system communicates with these specific Tradovate API endpoints:

Credential Exchange

/auth/accessTokenRequest - Mechanism for obtaining the required temporary authorization key.
/auth/renewAccessToken - Procedure for refreshing an expired authorization key.

Instrument Specifications

/contract/list - Retrieval of the complete register of tradable instruments.
/contract/find - Targeted search for a singular instrument definition.

Inventory Management

/position/list - Retrieval of the aggregated list of current open holdings.

Transaction Management

/order/list - Retrieval of all submitted and processed transactional requests.
/order/placeOrder - Submission point for new trade instructions.
/order/modifyOrder - Endpoint for altering standing instructions.
/order/cancelOrder - Endpoint for instruction termination.
/order/liquidatePosition - Dedicated interface for neutralizing a current holding.

Account Status

/account/list - Retrieval of all associated managed accounts.
/account/find - Targeted lookup for a specific account entity.
/cashBalance/getCashBalanceSnapshot - Fetches the current snapshot of liquid capital available for an account.