Analytics

Twelve Data MCP Server

Connect your account, then chat with AI to run tools.

Twelve Data provides real-time and historical market data for stocks, forex, crypto, ETFs, mutual funds, commodities, bonds, and indices across 50+ countries. Access OHLCV time series, quotes, technical indicators, fundamentals (income statements, balance sheets, cash flow), analyst estimates, insider transactions, institutional holdings, and more.

46 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Twelve Data — workflow patterns, data models, and gotchas for your AI agent.

Twelve Data

Real-time and historical market data for 1M+ instruments across 50+ countries.

Data Model

  • Time Series — OHLCV bars at intervals from 1min to 1month for any symbol.
  • Quote — Full real-time snapshot: price, open/high/low/close, volume, 52-week range, change %.
  • Price — Lightweight latest price (cheapest API call at 1 credit).
  • EOD Price — Official closing price from the last trading session.
  • Exchange Rate — Real-time forex and crypto conversion rates (e.g. USD/EUR, BTC/USD).
  • Currency Conversion — Convert specific amounts between currencies at real-time rates.
  • Market Movers — Top gaining and losing assets for the current trading day (stocks, ETFs, forex, crypto).
  • Technical Indicators — 100+ calculated indicators: SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic, ADX, ATR, VWAP, SuperTrend, and more.
  • Fundamentals — Company profile, logo, key executives, statistics (P/E, market cap, margins), income statement, balance sheet, cash flow, dividends, splits, earnings, press releases, historical market cap.
  • Analysis — Analyst recommendations (buy/hold/sell consensus), price targets, earnings estimates, growth estimates.
  • Regulatory — Insider transactions, institutional holders, fund holders.
  • Calendars — Dividends calendar, earnings calendar, IPO calendar, splits calendar (cross-company upcoming events).
  • Reference Data — Stocks, forex pairs, crypto pairs, ETFs, mutual funds, commodities, bonds, exchanges, exchange schedules, market state, crypto exchanges.
  • Discovery — Symbol search, cross listings, earliest timestamp.

Symbol Formats

  • Stocks: AAPL, MSFT, AMZN (or AAPL:NASDAQ to specify exchange)
  • Forex: EUR/USD, GBP/JPY (base/quote with slash)
  • Crypto: BTC/USD, ETH/BTC (crypto/fiat or crypto/crypto with slash)
  • Indices: SPX, IXIC, DJI
  • ETFs: SPY, QQQ, IWM
  • Commodities: XAU/USD (gold), XAG/USD (silver), CL (crude oil)
  • Bonds: Identified by symbol in the bonds catalog

Interval Options (Time Series & Indicators)

1min, 5min, 15min, 30min, 45min, 1h, 2h, 4h, 1day, 1week, 1month

Technical Indicators

Compute any indicator by name: sma, ema, rsi, macd, bbands, stoch, adx, atr, cci, obv, vwap, supertrend, dema, tema, wma, kama, mom, willr, mfi, sar.

Key parameters: time_period (lookback window, e.g. 14 for RSI), series_type (open/high/low/close).

Exchange Codes

Common exchanges: NYSE, NASDAQ, LSE, TSE, HKEX, SSE, NSE, ASX, TSX, XETRA.

Rate Limits & Credits

  • Each endpoint has a credit cost (1 for price/logo, 20 for fundamentals, 100+ for market movers and calendars).
  • Fundamentals (statistics, income_statement, etc.) require Pro plan or higher (20-1500 credits/symbol).
  • Regulatory data (insider transactions, institutional holders) requires Pro/Ultra plan.

Gotchas

  • Symbol search first if unsure of exact ticker.
  • Forex/crypto symbols use slash format: EUR/USD, not EURUSD.
  • Large outputsize values (5000 data points) can be slow — start with smaller values.
  • Calendar endpoints (dividends, earnings, IPO, splits) accept date ranges, default to current day.
  • Market movers endpoint uses path parameter: market_movers/stocks, market_movers/forex, etc.

Tools in this Server (46)

Twelve Data Convert Currency

Convert an amount from one currency to another using real-time exchange rates. Supports forex pairs (USD/EUR) and crypto (BTC/USD). Use for currency c...

Twelve Data Get Balance Sheet

Get balance sheet data: total assets, liabilities, equity, cash, debt, current ratio. Available annually or quarterly. Use for solvency analysis and u...

Twelve Data Get Bonds

Get a list of available bonds / fixed income instruments. Filter by exchange or country. Use to discover bond symbols for yield and price analysis.

Twelve Data Get Cash Flow

Get cash flow statement: operating, investing, and financing cash flows, free cash flow, capex. Available annually or quarterly. Use for cash generati...

Twelve Data Get Commodities

Get a list of available commodity pairs: precious metals (gold, silver), energy (oil, gas), grains, livestock, and softs. Use to discover commodity sy...

Twelve Data Get Cross Listings

Get all exchanges where a security is cross-listed (traded on multiple exchanges). Use to find alternative trading venues for a symbol.

Twelve Data Get Crypto

Get available cryptocurrency trading pairs. Filter by exchange. Use to discover crypto symbols before fetching prices or time series data.

Twelve Data Get Crypto Exchanges

Get a list of supported cryptocurrency exchanges (e.g. Binance, Coinbase, Kraken). Use to find valid exchange names for filtering crypto pair listings...

Twelve Data Get Dividends

Get dividend history for a stock: payment dates, amounts, and ex-dividend dates. Use for income investing analysis, dividend growth tracking, and yiel...

Twelve Data Get Dividends Cal

Get a calendar of upcoming and past dividend events across all stocks. Returns ex-dividend dates, payment dates, and amounts. Use to track dividend sc...

Twelve Data Get Earliest Ts

Get the earliest available data timestamp for a symbol at a given interval. Use to determine how far back historical data goes before requesting time ...

Twelve Data Get Earnings

Get earnings data: EPS actual vs estimate, revenue, and surprise percentage. Use to analyze earnings beats/misses and forecast accuracy over recent qu...

Twelve Data Get Earnings Cal

Get a calendar of upcoming and past earnings announcements. Returns company, date, EPS estimate and actual, and surprise percentage. Use to plan aroun...

Twelve Data Get Earnings Est

Get analyst earnings estimates (EPS) for upcoming quarters and annual periods. Returns number of analysts, average/low/high estimates, and year-ago EP...

Twelve Data Get Eod Price

Get end-of-day closing price for a symbol. Returns the official closing price from the most recent trading session. Use for daily portfolio valuations...

Twelve Data Get Etfs

Get available ETFs (Exchange-Traded Funds). Filter by exchange or country. Use to discover ETF symbols for portfolio construction or market analysis.

Twelve Data Get Exchange Rate

Get the real-time exchange rate for a currency pair. Supports fiat forex pairs (USD/EUR) and crypto pairs (BTC/USD). Use for currency conversion, fore...

Twelve Data Get Exchanges

Get a list of stock exchanges worldwide with name, country, and timezone. Use to discover available exchanges or find the right exchange code for a sp...

Twelve Data Get Exchange Sched

Get exchange trading schedules including open/close times, pre-market, after-hours, and holidays. Use to know when specific exchanges are open for tra...

Twelve Data Get Forex Pairs

Get available forex currency pairs. Filter by base or quote currency. Use to discover tradable forex pairs before fetching exchange rates or time seri...

Twelve Data Get Fund Holders

Get mutual fund holders of a stock: fund names, shares held, value, and percent ownership. Use to see which mutual funds own shares and their relative...

Twelve Data Get Funds

Get a list of available mutual funds / investment funds with symbol, name, exchange, and country. Filter by exchange, country, or type. Use to discove...

Twelve Data Get Growth Est

Get consensus analyst growth estimates for a company: current quarter, next quarter, current year, next year, next 5 years, and past 5 years growth ra...

Twelve Data Get Income Stmt

Get income statement data: revenue, cost of goods, gross profit, operating expenses, operating income, net income, EPS. Available annually or quarterl...

Twelve Data Get Indicators List

Get a catalog of all available technical indicators with names, descriptions, and parameter specs. Use to discover which indicators are available befo...

Twelve Data Get Insider Txns

Get insider transactions (buys/sells by executives and directors). Returns insider name, position, transaction date, shares, and value. Use to gauge i...

Twelve Data Get Inst Holders

Get institutional holders of a stock: entity names, shares held, value, and percent ownership. Shows pension funds, insurance companies, and investmen...

Twelve Data Get Ipo Calendar

Get a calendar of upcoming and past IPOs (Initial Public Offerings). Returns company names, IPO dates, and offering details. Use to track new listings...

Twelve Data Get Key Executives

Get key executives for a company: names, titles, roles, compensation, and age. Use to understand leadership structure and executive compensation.

Twelve Data Get Logo

Get the official logo URL for a company, cryptocurrency, or forex pair. Returns downloadable logo links. Use to add visual branding to financial repor...

Twelve Data Get Market Cap

Get historical market capitalization data for a company over a specified time period. Returns a time series of market cap values. Use to track company...

Twelve Data Get Market Movers

Get top gaining or losing assets for the current trading day. Returns ranked list with price, change, percent change, and volume. Supports stocks, ETF...

Twelve Data Get Market State

Get current open/closed status of stock exchanges worldwide. Use to determine if markets are currently trading before making time-sensitive queries.

Twelve Data Get Press Releases

Get official press releases and corporate announcements for a company. Returns titles, dates, and content. Use to stay informed about company news and...

Twelve Data Get Price

Get the latest real-time price for a symbol. Fastest and cheapest way to get just the current price. Use when you only need the price number without a...

Twelve Data Get Price Target

Get analyst price target consensus: high, low, median, and average targets. Use to gauge upside/downside potential relative to current price.

Twelve Data Get Profile

Get a company profile including name, description, sector, industry, employees, CEO, address, website, and phone. Use to understand what a company doe...

Twelve Data Get Quote

Get a comprehensive real-time quote for a symbol including current price, open/high/low/close, volume, 52-week range, change, percent change, and mark...

Twelve Data Get Recommendations

Get analyst recommendations (buy/hold/sell) and consensus rating for a stock. Returns monthly breakdown of strong buy, buy, hold, sell, strong sell co...

Twelve Data Get Splits

Get historical stock split events for a company: split date, ratio, and factors. Use to adjust historical price data or understand share structure cha...

Twelve Data Get Splits Cal

Get a calendar of upcoming and past stock split events across all companies. Returns company names, split dates, ratios, and factors. Use to track sha...

Twelve Data Get Statistics

Get key financial statistics for a stock: market cap, enterprise value, P/E ratios (trailing & forward), PEG ratio, price-to-book, EV/EBITDA, profit m...

Twelve Data Get Stocks

Get a list of available stocks with symbol, name, exchange, country, and currency. Filter by exchange or country. Use to discover available symbols on...

Twelve Data Get Tech Indicator

Compute a technical indicator for a symbol. Supports SMA, EMA, RSI, MACD, Bollinger Bands, Stochastic, ADX, ATR, CCI, OBV, VWAP, SuperTrend, and more....

Twelve Data Get Time Series

Get historical OHLCV (open/high/low/close/volume) price data for any symbol. Use for charting, trend analysis, backtesting, or comparing price history...

Twelve Data Search Symbol

Search for financial instruments by name, ticker, or ISIN. Returns matching symbols with exchange, instrument type, and country. Use to find the corre...

Frequently Asked Questions

What is the Twelve Data MCP server?

Twelve Data provides real-time and historical market data for stocks, forex, crypto, ETFs, mutual funds, commodities, bonds, and indices across 50+ countries. Access OHLCV time series, quotes, technical indicators, fundamentals (income statements, balance sheets, cash flow), analyst estimates, insider transactions, institutional holdings, and more. It provides 46 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Twelve Data to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/twelve-data. Authentication is handled automatically.

How many tools does Twelve Data provide?

Twelve Data provides 46 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Twelve Data require?

Twelve Data uses API Key. Twelve Data requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Twelve Data to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/twelve-data

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to use Twelve Data?

Sign in to connect your credentials and start running tools from the chat.

Twelve Data MCP Server & Skill — 46 Tools