Twelve Data MCP
Twelve Data MCP connects an assistant to a market data API: quotes, historical prices, indicators, fundamentals and company news.
- 86 ★ on the repository
- Last commit
Extended access
Why this level
- Queries and the API key go to Twelve Data.
- A local unauthenticated HTTP server makes calls under your key.
Install
- Works in
Manual install
claude mcp add --transport http twelvedata http://localhost:8000/mcpThe local HTTP variant after `make run` from the README; the cloud server `https://mcp.twelvedata.com/mcp` is added as a connector in the client.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Queries and the API key go to Twelve Data.
- A local unauthenticated HTTP server makes calls under your key.
This is third-party code. Review the repository files before installing.
What it does
The official Twelve Data MCP server gives an assistant access to the financial API: real-time and historical quotes, over 60 technical indicators, fundamentals, earnings, dividends, ETFs, company news and market movers. You can ask, for example, what the RSI of AAPL is now or what the latest TSLA earnings were. There are two options. The cloud server `https://mcp.twelvedata.com/mcp` needs no install: the client opens a browser, you sign in to Twelve Data and your key links automatically. The local option runs from the repository over stdio or HTTP with a key in `.env`. The server only reads data and has no trading operations.
Who it is for. Analysts and developers who ask an assistant to examine market data on stocks and indicators.
Good fit when
- The assistant calculates RSI and other indicators for a ticker and explains the signal.
- You need the latest earnings, dividends and company news in one answer.
- ETFs are compared by price and performance over a chosen period.
- A backtest script is drafted on historical quotes with data pulled through the assistant.
Not a fit when
- You want trading advice: the server returns data and no recommendations.
- You have no Twelve Data account: a key or sign-in is required.
- You need a quote stream with no plan limits.
Example request
Show the RSI and latest earnings for AAPL and compare them with the index over three months.MCP
- Transport
- http, stdio
- Authentication
- OAuth
Environment variables
TWELVE_DATA_API_KEYsecret- Twelve Data API key for a local run; not needed in the cloud option
MCP_HOST- Server bind address; `127.0.0.1` keeps it local and enables the `Host` and `Origin` check
Limitations
A Twelve Data account is needed, and data access and call rates depend on your plan. The cloud server is added as a custom connector at `https://mcp.twelvedata.com/mcp`, not at the host root. A local `make run` and the container serve `/mcp` without authentication on `0.0.0.0`: anyone who reaches the port works under your key. Run with `MCP_HOST=127.0.0.1`. OAuth login is not supported in Docker. The repository has no license file.
How to disable. Disable the connector in the client. For a local run remove the `twelvedata` entry, stop the process or container and delete the `.env` file with the key.
FAQ
Is an API key needed?
Not in the cloud option: sign-in goes through the browser and the key links to the account itself. Locally the key goes into `.env` as `TWELVE_DATA_API_KEY`.
What data is available?
Real-time and historical quotes, over 60 technical indicators, fundamentals, earnings, dividends, ETFs, company news and market movers.
How do I connect locally in Claude Code?
With `claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py`. Python 3.10 or newer is required.
Can it connect to Perplexity?
Yes. Pro, Max and Enterprise users add a remote connector with the address `https://mcp.twelvedata.com/mcp`, OAuth and Streamable HTTP. It is a per-account setup, not a listing in the Perplexity directory.
What does a local run look like?
Run `make install`, put the key into `.env` as `TWELVE_DATA_API_KEY`, then connect over stdio or start HTTP with `make run` at `http://localhost:8000/mcp`.
Discussion
No questions or reviews yet.
Related
MCP serversFinancial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
An MCP server for market data and technical analysis: quotes, indicators, screeners and backtesting for stocks, crypto, forex and futures
MCP server that gives an agent Yahoo Finance data by ticker: price history, financial statements and option chains
The Massive.com market data MCP server: quotes, options, forex and crypto through three tools for search, API calls and SQL
An MCP server for personal stock analysis: market data, technical indicators, screening and portfolio tracking, no keys for the core
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Twelve Data MCP (this card) | yes | OAuth | 86 | |
| Alpha Vantage MCP Server | yes | OAuth | 227 | also serves market data; here the official Twelve Data server with OAuth and over 60 indicators |
| Yahoo Finance MCP | no | not required | 209 | pulls data from Yahoo Finance; Twelve Data MCP reads the data provider own paid API |
README in short
The repository holds the local server (Python) and a guide to the cloud one. It describes connecting to Claude, ChatGPT and Perplexity, running in Docker and security measures for local mode.