tradingview

This MCP server provides a research-focused trading screen and market health checks using TradingView's market screener data. It exposes a multi-asset screening capability (stocks, forex, crypto, and ETFs) with 75+ metrics (fundamental, technical, and performance fields) and several pre-configured strategies/presets to help you build systematic investment ideas. The server also includes AI-assisted exploration via Claude, enabling natural language queries to find undervalued stocks or compare metrics. You can run and interact with the server through Claude Code commands like /market-regime to gauge market health, or /run-screener to perform interactive stock screening and export results to CSV. To connect, configure MCP in Claude Desktop/Code by pointing to the TradingView MCP server, typically via npx tradingview-mcp-server, which will start the server locally or in your environment when invoked.

Prerequisites:

• Node.js and npm installed on your system
• Access to a shell/terminal (Linux, macOS, or Windows PowerShell/CMD)

Option A: NPM (Recommended)

1. Install globally:

npm install -g tradingview-mcp-server

2. Run or configure MCP usage as needed (see “Configuration” below).

Option B: Clone Repository (with demo commands)

git clone https://github.com/fiale-plus/tradingview-mcp-server.git
cd tradingview-mcp-server
npm install

# Quick setup - creates project-level MCP config
./local-setup.sh          # Linux/Mac
local-setup.bat           # Windows

# Restart Claude Code and try: /market-regime or /run-screener

Configuration (example for Claude integration):

{
  "mcpServers": {
    "tradingview": {
      "command": "npx",
      "args": ["-y", "tradingview-mcp-server"]
    }
  }
}

For Claude Code, save as .mcp.json in your project root and enable MCP servers in Claude settings:

{
  "mcpServers": {
    "tradingview": {
      "command": "npx",
      "args": ["-y", "tradingview-mcp-server"]
    }
  }
}

Enable in Claude Code:

{
  "enableAllProjectMcpServers": true
}

Optional environment variables (tuning):

• CACHE_TTL_SECONDS - Cache duration (default: 300)
• RATE_LIMIT_RPM - Requests per minute (default: 10)

Starting the server will expose the TradingView MCP capabilities to Claude and other MCP clients via the configured command and arguments.

Tips and notes:

• The MCP server exposes powerful screening with 75+ metrics across multiple asset classes and supports several investment strategies.
• If you see rate limit or cache-related messages, adjust CACHE_TTL_SECONDS or RATE_LIMIT_RPM accordingly in your environment.
• Ensure your environment has internet access to fetch npm packages when using npx or npm-based setups.
• The included Claude Code commands (/market-regime and /run-screener) are designed to demonstrate practical workflows; you can customize or extend the commands as needed.
• When using Claude Desktop, add the tradingview MCP server under mcpServers with command npx and args [-y, tradingview-mcp-server].