tradingview-mcp MCP Server
Overview
MCP server for market analysis in AI assistants: screeners, multi-timeframe technical analysis, backtests and sentiment for crypto, stocks, forex and futures. 39 tools. Self-host free, or use the hosted version…
From the project README: ""TradingView MCP" now means two very different kinds of project. Both are useful — for different jobs:"
Install and configure
These commands were found in the project's own README. We checked each package name against the public registry.
pip install tradingview-mcp-server
(tradingview-mcp-server found on PyPI, latest 0.8.1)
It also lists hosted endpoints of type: streamable-http.
Example configuration from the README (check the project's documentation for the current format):
> ⚠️ **Important:** Prefix must match your provider. `google/...` needs a Google API key. `openrouter/...` needs an OpenRouter key.
### ⚠️ Common Mistakes
| Symptom | Cause | Fix |
|---------|-------|-----|
| `Unrecognized keys: mcpServers` | `mcpServers` not supported in this version | Remove from config, use bash wrapper |
| `No API key for provider "google"` | Used `google/model` but only have OpenRouter key | Use `openrouter/google/model` instead |
| `which agent?` loop | `acp.defaultAgent` not set | `openclaw config set acp.defaultAgent main` |
| Gateway won't start | `gateway.mode` missing | `openclaw config set gateway.mode local` |
### Test Your Bot
Once running, send your Telegram bot:
Environment variables:
| Variable | Required | Description |
|---|---|---|
MARKETAUX_API_TOKEN |
see README | - |
YOUR_USERNAME |
see README | - |
ALL_BATCHES_FAILED |
see README | - |
YOUR_BOT_TOKEN_HERE |
see README | - |
Requirements
The Python package requires Python >=3.10,<3.14. The README mentions setup for these clients: Claude Desktop, Claude Code, Cursor, Zed.
Limitations and things to check
Before you connect it:
- The README mentions: needs credentials or api keys; controls or scrapes a web browser; downloads or scrapes third-party content: check the source site's terms and local copyright law.
- Read the code or the documentation of the tools it exposes, and note what each tool can do.
- Grant the smallest permissions you can: limit folders, API scopes and database roles.
- Keep credentials in environment variables or a secrets manager, never in a shared config file.
- Run it in a container or a separate user account if it can execute code or touch files.
Known issues and troubleshooting
These are the most discussed threads on the project's issue tracker. They show what other users ran into; read them before you install, and check whether they are still open.
- [HELP] Installation Issue: (closed, 4 comments)
- Complement idea: "What happened next?" via Chart Library (closed, 4 comments)
- Error contract is half-migrated: 5 tools return structured envelopes, ~95 return sites still return strings (open, 3 comments)
- [FEATURE] Add mexc data (closed, 3 comments)
- [FEATURE] Docker image (closed, 3 comments)
Maintenance and community
The repository has 25 contributors, 160 commits in the last 12 months, 9 open issues and pull requests. It is maintained by Ahmet Taner Atila, a GitHub user with 20 public repositories and 220 followers. GitHub's community checks found a security policy, contribution guidelines, no code of conduct.
Frequently asked questions
Is tradingview-mcp free to use?
The repository is released under the MIT license.
When was tradingview-mcp last updated?
The last commit was on 2026-10-29, and the project is marked active by our 12-month check.
Which AI clients does tradingview-mcp work with?
Its README gives setup notes for Claude Desktop, Claude Code, Cursor, Zed. Other MCP-compatible clients may also work, but the project does not say so.
Sources
This page combines data from:
- tradingview-mcp on GitHub
- TradingMCP — the market analyst's toolkit inside Claude, ChatGPT and Cursor
- TradingMCP — the market analyst's toolkit inside Claude, ChatGPT and Cursor
- TradingMCP — the market analyst's toolkit inside Claude, ChatGPT and Cursor
- Official MCP Registry entry (registry.modelcontextprotocol.io)
- PyPI package
tradingview-mcp-server
Security snapshot
- Needs credentials or API keys
- Controls or scrapes a web browser
- Downloads or scrapes third-party content: check the source site's terms and local copyright law
Automated checks on public data, last run Oct 31, 2026. This is not a security audit. Read the code and decide which permissions to grant before you connect any MCP server.