
Twelvedata
Market data MCP server for stocks, ETFs, forex, crypto and indices via Twelve Data
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Twelvedata
Twelvedata is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
The Pipeworx gateway wraps Twelve Data's market endpoints as MCP tools, so an AI client can pull OHLC history, live and end-of-day quotes, forex rates and currency conversions without a separate integration. Symbol discovery tools let a client list or validate stock, ETF, forex pair, crypto and index identifiers before querying prices.
Beyond prices, the server exposes earnings history and an earnings calendar, dividend and split histories, and company profiles for stocks. A technical indicator tool covers common studies such as RSI, moving averages, MACD and Bollinger Bands, as listed on the product page.
The README says the endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx, so a connection exposes more than the pack's own tools. Anonymous use is capped daily, and a free registered account raises the limit. It is aimed at developers and analysts building agents that need current or historical market data.
Install
Run in a terminal
claude mcp add --transport http twelvedata https://gateway.pipeworx.io/twelvedata/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/twelvedata/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"twelvedata": {
"url": "https://gateway.pipeworx.io/twelvedata/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"twelvedata": {
"type": "http",
"url": "https://gateway.pipeworx.io/twelvedata/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"twelvedata": {
"serverUrl": "https://gateway.pipeworx.io/twelvedata/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"twelvedata": {
"type": "http",
"url": "https://gateway.pipeworx.io/twelvedata/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (16)
Taken from the project documentation; the running server may differ.
- time_series
- OHLC time series for a stock, forex, crypto, or ETF symbol.
- quote
- Real-time quote snapshot for a symbol.
- price
- Latest trade price for a single symbol.
- eod
- End-of-day closing quote for a symbol.
- exchange_rate
- Live forex exchange rate for a currency pair.
- currency_conversion
- Converts an amount using the current forex pair rate.
- stocks
- Lists supported stock symbols with exchange and country metadata.
- forex_pairs
- Lists supported forex currency pairs.
- cryptocurrencies
- Lists supported cryptocurrency symbols.
- etfs
- Lists supported ETF symbols, paged.
- indices
- Lists non-US market index symbols, paged.
- earnings
- Earnings history and upcoming dates for a stock symbol.
- earnings_calendar
- Broad earnings calendar across covered symbols.
- dividends
- Historical dividends for a stock or ETF symbol.
- splits
- Historical stock splits for a symbol.
- profile
- Company profile for a stock symbol.
What it does
- Historical OHLC series
- Returns timestamped open, high, low, close and volume for stock, forex, crypto and ETF symbols at chosen intervals.
- Live and end-of-day quotes
- Offers intraday quote snapshots, latest trade prices and daily closing quotes for a single symbol.
- Forex conversion
- Provides live exchange rates for currency pairs and converts an amount at the current rate.
- Symbol discovery lists
- Lists supported stocks, ETFs, forex pairs, cryptocurrencies and non-US indices to validate tickers before querying.
- Earnings and dividends
- Covers earnings history, a broad earnings calendar, dividend history and stock split records.
- Technical indicators
- Computes indicator series such as RSI, moving averages, MACD, Bollinger Bands and ADX for a symbol.
Good for
- Pulling intraday or daily price history for a stock or crypto symbol into an analysis agent
- Checking current forex rates or converting an amount between currencies
- Tracking upcoming earnings dates and reported EPS against estimates
- Reviewing dividend and split history for income or price-adjustment analysis
- Validating ticker symbols before running price queries
Pricing
Freemium, from $49 a month
Free anonymous tier (50 calls/day) and free account (200 calls/day); paid credits and $49/$99 monthly plans above that.
Prices change. Check pipeworx.io before you buy.
Twelvedata FAQ
Do I need an API key to use it?
The README says calls work anonymously with a daily cap. An optional Pipeworx API key raises that cap, and the registry lists it as an optional secret variable.
Are US indices like SPX covered?
No. The README states US indices such as SPX, DJI and IXIC are not in Twelve Data's reference list for this pack, and quoting them requires a higher-tier key passed via _apiKey.
Which transports does the MCP server support?
The registry entry lists stdio via the npm package @pipeworx/mcp-twelvedata and a streamable-http remote at the Pipeworx gateway.
Is the server free?
The pricing page describes a free anonymous tier and a free registered account with a higher daily allowance. Pay-as-you-go and subscription rates apply beyond that, and bring-your-own upstream keys are not marked up.
Is Twelvedata free?
Twelvedata has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Twelvedata to Claude Code?
Run this command in your terminal: claude mcp add --transport http twelvedata https://gateway.pipeworx.io/twelvedata/mcp
What are the best alternatives to Twelvedata?
The closest alternatives to Twelvedata are Twelve Data, ApexTick Market Data & Options MCP, Taiwan Stocks, TickerLayer Market Data and mkts Market Data.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.