mcpField
T
Tradovate MCP Server

Tradovate MCP Server

Local
github.com/alexanimalFinance1Updated 83w ago
Repository

About Tradovate MCP Server

An MCP server for the Tradovate API, intended for managing contracts, positions, orders, and accounts, as well as fetching market data. It caches data and can fall back to simulated data when the API is unavailable.

Key features

  1. 01Retrieve contract details
  2. 02View and manage positions
  3. 03Place, modify, or cancel orders
  4. 04Liquidate positions
  5. 05Query account summaries and market data

Use cases

  1. 01Inspect a specific contract
  2. 02Check account positions and balances
  3. 03Submit or adjust orders
  4. 04Fetch quotes, market depth, and charts

MCP support

Provides MCP clients with tools for Tradovate contracts, positions, orders, accounts, and market data. The server authenticates with and interacts through the Tradovate API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Tradovate MCP Server

smithery badge 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
  1. 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.