Best for
- Quantitative analysts and traders who need quick access to TradingView Screener data.
- Developers who want to integrate market data into AI workflows.
T
TVScreener MCP Server
Community
Unofficial TradingView Screener data access via MCP, supporting stocks, crypto, forex, bonds, futures, and coins.
GitHub source repository ↗
42FMRS · D
tvscreener is a powerful unofficial TradingView Screener MCP server offering comprehensive fields and flexible filtering, but given its unofficial nature, users should be aware of data reliability and compliance risks.
tvscreener is a third-party Python library and MCP server that allows AI assistants to access public data from TradingView's screener. It supports six screener types (Stock, Crypto, Forex, Bond, Futures, Coin) with over 13,000 fields, and offers Pandas DataFrame output, streaming updates, and type-safe validation. The MCP server provides tools to discover fields, execute custom queries, and use simplified screeners for stocks, crypto, and forex.
Tools
discover_fields
Search available fields by keyword, returning a list of matching fields.
custom_query
Execute flexible queries with any fields and filters, returning a data frame.
search_stocks
Simplified stock screener with common filters, returning stock data.
search_crypto
Simplified cryptocurrency screener, returning crypto data.
search_forex
Simplified forex screener, returning forex pair data.
get_top_movers
Get a list of top gainers and losers.
Setup
Install the Python package: pip install 'tvscreener[mcp]'. Then run the MCP server: tvscreener-mcp. Register with Claude Code: claude mcp add tvscreener -- tvscreener-mcp.
Fit and risk
Not for
- Use cases requiring an official data source or real-time trading execution.
- Production environments with high reliability requirements or guaranteed data stability.
Required permissions
- Requires network access to request TradingView Screener.
- May need to read local configuration files to persist user settings.
Risks and side effects
- Unofficial APIs may change without notice, causing malfunction or inaccurate data.
- Potential violation of TradingView's Terms of Service, with legal risks.
- High query frequency could lead to IP restrictions or bans.
- Data is for reference only and does not constitute investment advice.
Troubleshooting
- Verify network connectivity and access to TradingView.
- Check Python environment and dependencies are fully installed.
- If a query fails, try reducing filter criteria or update to the latest version.
- If rate-limited, increase query intervals or use the interval parameter in streaming updates.
Use cases
Retrieve real-time stock, crypto, and other market data via an AI assistant.
Perform custom market screening based on 13,000+ fields.
Monitor market trends and get top movers.
Supported clients
Claude DesktopFull support