MCP server exposing 17 tools for twelvedata.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/twelvedata/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}time_series — Twelve Data OHLC time series for a stock, forex, crypto, or ETF symbol. Requires symbol and interval (e.g. '1min', '1h', '1day'). Returns timestamped open/high/low/close + volume.quote — Twelve Data real-time quote snapshot for a symbol: open, high, low, close, volume, 52-week range, exchange, currency. Use for a full current-day market snapshot.price — Twelve Data latest trade price for a single symbol (stock, forex, crypto, ETF). Returns a single numeric price field. Lightest endpoint for current-price lookups.eod — Twelve Data end-of-day closing quote for a symbol. Returns the last closing price, volume, and date. Use for daily settlement prices rather than intraday data.exchange_rate — Twelve Data live forex exchange rate for a currency pair symbol (e.g. 'EUR/USD'). Optional dp (decimal places) and timezone. Returns rate, timestamp, and pair identifiers.currency_conversion — Twelve Data real-time currency conversion: pass a forex pair symbol (e.g. 'EUR/USD') and an amount to get the converted value at the current exchange rate.stocks — Twelve Data reference list of all supported stock symbols with exchange and country metadata. Use to discover or validate tickers before querying price endpoints.forex_pairs — Twelve Data reference list of all supported forex currency pairs (e.g. EUR/USD). Use to enumerate or validate pair symbols before querying exchange_rate or time_series.cryptocurrencies — Twelve Data reference list of all supported cryptocurrency symbols with exchange metadata. Use to discover or validate crypto tickers before querying price endpoints.etfs — Twelve Data reference list of supported ETF symbols (64,000+ listings worldwide) with exchange and country metadata — paged, default 200 rows, `count` is the total matched. Filter by symbol (e.g. "SPY"), country or exchange. Use to discover or validate ETF tickers before querying price endpoints. A stock ticker (e.g. "AAPL") is not an ETF and returns an empty list with `empty_reason: wrong_instrument_class` — use the stocks tool for those.indices — Twelve Data reference list of supported market index symbols with exchange metadata — about 1,300 NON-US indices (e.g. N225 Nikkei 225, 000001 SSE Composite, NSEI Nifty 50), paged, default 200 rows. Filter by country (e.g. "Japan", "India", "China"), exchange or symbol. US indices (SPX, DJI, IXIC, NDX, VIX) are NOT in Twelve Data's reference list and quoting them requires a Grow-or-higher Twelve Data key via _apiKey — a US filter here returns that refusal, not an empty list. Use to discover or validate index tickers before querying time_series.earnings — Twelve Data earnings history and upcoming earnings dates for a stock symbol: EPS estimate, EPS actual, surprise percentage, and report date per quarter.earnings_calendar — Twelve Data broad earnings calendar — upcoming and recent earnings announcements across all covered symbols. Returns symbol, date, EPS estimate, and time of day (before/after market).dividends — Twelve Data historical dividends for a stock / ETF symbol: ex-date, amount, frequency. Use for income analysis and dividend-capture strategies on Twelve-Data-covered symbols.splits — Twelve Data historical stock splits for a symbol: ratio, date. Use to adjust historical Twelve Data prices across split events.profile — Twelve Data company profile for a stock symbol: name, sector, industry, employees, CEO, description, website, address, and exchange listing details.technical_indicator — Compute a technical indicator time series for a stock/forex/crypto symbol via Twelve Data — RSI, SMA, EMA, MACD, Bollinger Bands (bbands), ADX, ATR, Stochastic, CCI, and more. PREFER for "RSI(14) of AAPL", "50-day and 200-day SMA of TSLA", "MACD for BTC/USD", "Bollinger Bands of SPY". This is the right tool for ANY "RSI / SMA / EMA / MACD / moving average / technical indicator for <ticker>" question. Computes ONE indicator per call: if several are requested (e.g. "RSI and the 50-day and 200-day SMA"), call this once per indicator starting with the first — do NOT decline just because multiple indicators are asked for. Returns dated indicator values.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/twelvedata/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io