Best for
- Individuals or teams with a Twelve Data account who want market data inside their AI assistant
- Users who want a no-install setup via the hosted cloud connector
- Developers who prefer to self-host with their own API key
T
Twelve Data MCP Server
Official
Connect AI assistants to Twelve Data financial market data
GitHub source repository ↗
52FMRS · D
Officially maintained by Twelve Data, this server exposes its financial data API via either a hosted OAuth-based cloud connector or a local stdio setup using a personal API key, covering prices, technical indicators, fundamentals, news, and regulatory data; it requires a Twelve Data account and the repository carries no stated license.
The Twelve Data MCP Server lets Claude, ChatGPT, and other AI assistants access the Twelve Data financial API through the Model Context Protocol, covering real-time and historical prices, 60+ technical indicators, fundamentals, earnings, dividends, ETFs, company news, and market movers. A Twelve Data account is required. Twelve Data offers a hosted cloud server (browser-based OAuth login, no installation or manual API key handling) and a local option (Python 3.10+, API key configured via a .env file, run over stdio for Claude Desktop).
Tools
The tool list has not been reviewed yet.
Setup
Option 1 (recommended, cloud server): in Claude's or ChatGPT's connector/integration settings, add the URL https://mcp.twelvedata.com/mcp; a browser window opens to log in with your Twelve Data account and your personal API key is linked automatically. Option 2 (local): get your API key from the Twelve Data dashboard; install Python 3.10+ (3.12 recommended) and run make install; create a .env file in the project root with TWELVE_DATA_API_KEY=your_api_key_here; add an mcpServers entry to Claude Desktop's claude_desktop_config.json pointing command at the project's .venv/bin/python and args at src/server.py (use the venv Python, not the system one, since macOS ships Python 3.9); restart Claude Desktop after saving.
claude_desktop_config.json
{
"mcpServers": {
"twelvedata": {
"command": "/path/to/twelve-data-mcp/.venv/bin/python",
"args": [
"/path/to/twelve-data-mcp/src/server.py"
]
}
}
}
Fit and risk
Not for
- Users without a Twelve Data account who don't want to sign up or authorize access
- Fully offline scenarios with no third-party data dependency
- General tasks unrelated to financial market data
Required permissions
- Cloud option: browser-based OAuth login linking your account to the Twelve Data hosted service
- Local option: reads TWELVE_DATA_API_KEY from a .env file and uses it to call the Twelve Data API
- Makes outbound network requests to fetch market data (to mcp.twelvedata.com for the cloud option, or directly to the Twelve Data API locally)
Risks and side effects
- The cloud server is hosted by Twelve Data, requiring account authorization to a third-party service
- In local mode, the API key is stored in plaintext in the .env file and must be kept secure
- Data access and rate limits are bound by your Twelve Data subscription plan
- The repository does not specify an open-source license, leaving usage and redistribution terms unclear
Troubleshooting
- If the local server fails to start, confirm the config points to the project's .venv/bin/python rather than the system Python (e.g., macOS's bundled Python 3.9 is too old)
- Verify Python 3.10+ is installed (3.12 recommended)
- Check that the .env file exists and contains a valid TWELVE_DATA_API_KEY
- Restart Claude Desktop after editing claude_desktop_config.json for changes to take effect
- For the cloud connector, if the login popup doesn't appear or authorization fails, check browser popup blockers and network connectivity
Use cases
Look up real-time or historical prices for stocks, ETFs, forex, and crypto
Compute technical indicators like RSI, MACD, SMA, and Bollinger Bands
Retrieve earnings, dividends, splits, financial statements, and key stats
Check ETF and mutual fund performance, holdings, and risk metrics
Get company news, market movers, analyst ratings, and price targets
Query SEC/EDGAR filings, insider transactions, and institutional holdings
Supported clients
Claude DesktopFull support
ChatGPTFull support