tradingview-mcp-codex

Codex-first TradingView MCP bridge for TradingView Desktop via Chrome DevTools Protocol.

This project adapts ideas and workflows from tradesdontlie/tradingview-mcp for Codex:

• same local TradingView Desktop CDP model

• Codex-friendly MCP setup

• thin shared core for CLI and MCP tools

• clearer Codex install and workflow docs

Status

Current scaffold ships working base pieces:

• CLI:

  • tvx launch

  • tvx status

  • tvx symbol <SYMBOL>

  • tvx timeframe <TF>

• MCP tools:

  • tvx_launch

  • tvx_health_check

  • tvx_set_symbol

  • tvx_set_timeframe

  • tvx_chart_state

It does not yet expose full upstream feature parity. Use vendor/tradingview-mcp as feature reference while growing this Codex-first server.

Goals

• keep MCP server small and readable

• share logic across CLI and MCP tools

• document Codex setup better than Claude-only examples

• make feature parity work incremental and explicit

Prerequisites

• Node.js 18+

• TradingView Desktop installed

• valid TradingView subscription for your own local app usage

• Codex CLI with MCP support

Install

npm install

Run locally

Start MCP server:

npm start

Use CLI:

npm run launch
npm run health
node src/cli/index.js symbol BBCA
node src/cli/index.js timeframe 1

Add to Codex

Register global MCP entry:

codex mcp add tradingview-codex -- node /Users/you/Projects/tradingview-mcp-codex/src/server.js

Check config:

codex mcp list
codex mcp get tradingview-codex

Restart Codex session after adding server so tool list refreshes.

Quick verification

1. Launch TradingView with CDP:

   • npm run launch

2. Check CLI connection:

   • npm run health

3. In fresh Codex session, call MCP tool:

   • tvx_health_check

Documentation

• Codex setup: docs/CODEX_SETUP.md

• Feature mapping from upstream reference: docs/FEATURE_PARITY.md

• Skill port plan: docs/SKILLS.md

Reference source

Primary reference used while shaping this project:

• upstream repo: vendor/tradingview-mcp/README.md

• upstream setup: vendor/tradingview-mcp/SETUP_GUIDE.md

• upstream Claude workflows: vendor/tradingview-mcp/CLAUDE.md

Upstream project:

• https://github.com/tradesdontlie/tradingview-mcp

Design notes

• keep shared TradingView logic in src/core

• keep CLI wrappers thin in src/cli

• keep MCP wrappers thin in src/tools

• prefer explicit, JSON-friendly outputs

• port upstream features one workflow at time instead of blind copy