What is Twelve Data MCP?

It's an MCP (Model Context Protocol) server that connects Twelve Data to your AI, giving the agent tools to act on your data — through a single remote link.

Which AI clients does it work with?

Any MCP-compatible client: Claude (web, desktop and mobile), Cursor, ChatGPT with connectors, OpenClaw and other agents.

No. Paste the remote URL into your client, authenticate once, and you're done — no packages to install, no code to write.

Is it secure? Can the AI change my data?

Access is authorized by you and can be revoked anytime. Permissions follow what Twelve Data exposes; you approve them when connecting.

How much does it cost?

You start free and upgrade when you need more usage. Billing and limits are managed in your mcp.ai account.

Can I cancel anytime?

Yes. Plans are monthly and can be cancelled at any time, with no lock-in.

Twelve Data MCP Server and REST API

Twelve Data

Connect your Twelve Data account and use 107 tools for analytics straight from your AI agent. Connect with your own API key. Twelve Data provides a comprehensive financial data API offering real-time and historical market data for stocks, forex, cryptocurrencies, ETFs, and indices.

Install in your client

MCP server URL

https://api.mcp.ai/p_twelve_data

Secure connection via OAuth 2.0

Tools (107)

For developers

API & agent docs

Machine-readable docs to plug this server into an agent or call it over REST.

Skill (how to use)

Markdown: use via MCP or via the direct REST API.

Open

llms.txt

Agent-readable spec of this server.

Open

For agents

Install prompt — paste into Claude, ChatGPT, Cursor or any MCP agent and it sets itself up.

Open

Postman collection

Import the REST API into Postman.

Download

FAQ

Twelve Data

Tools (107)

API & agent docs

Frequently asked questions

Example prompts

Related tags

Twelve Data

Tools (107)

twelve_data_batch_get_quotesFetch quotes for 1-8 symbols in one batch, returning success or error for every symbol; partial child failures do not fail successful quotes. Each symbol consumes one API credit.

twelve_data_cash_flowTool to get company cash flow statement. Use when you need operating, investing, and financing cash flow details after selecting a company.

twelve_data_cash_flow_consolidatedTool to get raw consolidated cash flow statements. Use when you need detailed cash flow data for a company.

twelve_data_commodities_listTool to retrieve a list of supported commodities. Use when you need all available commodities after obtaining a valid API key.

twelve_data_convert_currencyConvert an amount from the base to the quote currency using a current or historical forex or cryptocurrency rate. Costs one API credit.

twelve_data_correlTool to fetch Pearson correlation coefficient between two series over a period. Use after selecting identifiers and interval.

twelve_data_countries_listTool to retrieve a list of countries with ISO codes, names, capitals, and currencies. Use when you need country metadata after obtaining a valid API key.

twelve_data_cross_listingsTool to retrieve cross-listed symbols for a security across multiple exchanges. Use when you need to list all market listings of a given instrument.

twelve_data_cryptocurrenciesTool to list all supported cryptocurrencies. Use when you need the complete set of crypto symbols. Use after obtaining a valid API key.

twelve_data_cryptocurrency_exchanges_list_getTool to list supported cryptocurrency exchanges. Use when you need a list of available crypto trading platforms.

twelve_data_currency_conversionTool to convert an amount from one currency to another. Use after confirming currency codes to retrieve real-time conversion.

twelve_data_dividendsTool to retrieve dividend payout history for a specified symbol. Use when you need historical dividends over multiple years.

twelve_data_earningsTool to retrieve earnings data including EPS estimates and actuals. Use when you need detailed earnings history for a selected stock symbol.

twelve_data_eps_revisionsTool to provide analysts’ revisions of a company’s future EPS over the last week and month. Use after confirming the stock symbol.

twelve_data_eps_trend_actionTool to retrieve EPS trend estimates for a specified company. Use after selecting a stock symbol to view how EPS estimates have changed over time. Returns EPS estimates for next quarter, current year,

twelve_data_etfs_directoryTool to fetch a daily updated list of exchange-traded funds sorted by total assets. Use when you need a directory of ETFs by exchange or country.

twelve_data_etfs_familyTool to fetch a comprehensive list of ETFs by family. Use when you need to list ETFs managed by a specific investment company.

twelve_data_etfs_typeTool to retrieve ETF categories by market, including types like 'Equity Precious Metals'. Use after confirming API key is set; no parameters are needed. Returns a dictionary mapping country names to l

twelve_data_etfs_worldTool to fetch comprehensive ETF analytics (summary, performance, risk, composition). Use when you need a detailed overview of an ETF's metrics and holdings.

twelve_data_etfs_world_compositionTool to fetch global ETF composition details including sector, country, asset allocations, top holdings, and bond metrics. Use after selecting an ETF to analyze its composition.

twelve_data_etfs_world_riskTool to get global ETF risk metrics. Use when you need to analyze volatility and valuation ratios for an ETF.

twelve_data_exchangesTool to retrieve a list of supported exchanges. Use when you need all available stock and forex exchanges.

twelve_data_forex_pairsTool to retrieve a list of all supported forex currency pairs. Use when exploring available forex pairs before making other forex data requests.

twelve_data_get_adTool to retrieve Accumulation/Distribution (AD) indicator data for a financial instrument. The AD line uses closing price, price range, and trading volume to identify buying or selling pressure and as

twelve_data_get_api_usageTool to retrieve your current plan and remaining API credits. Use when monitoring your subscription usage in real-time.

twelve_data_get_apoTool to calculate the Absolute Price Oscillator (APO) for a financial instrument. The APO measures the difference between two moving averages to identify price trends and momentum changes. Use when yo

twelve_data_get_aroonTool to retrieve Aroon Indicator data for identifying market trends. Returns Aroon Up and Aroon Down values showing time elapsed since highest high and lowest low. Use when analyzing trend direction a

twelve_data_get_balance_sheetTool to retrieve a company's balance sheet (assets, liabilities, equity). Use when you need annual or quarterly financial position data for a given symbol or identifier.

twelve_data_get_balance_sheet_consolidatedTool to get raw consolidated balance sheet data (assets, liabilities, equity) for a company. Use when you need detailed historical balance sheet by period.

twelve_data_get_bbandsTool to calculate Bollinger Bands (BBANDS) for a financial instrument. Returns upper band, lower band, and simple moving average (SMA) to assess market volatility and identify potential price reversal

twelve_data_get_bondsTool to retrieve a daily updated list of available bonds (fixed income securities). Use when you need to fetch bonds with optional filtering by symbol, exchange, or country.

twelve_data_get_cciTool to retrieve Commodity Channel Index (CCI) values for a specified security. Use when you need to detect potential price reversals by identifying overbought or oversold conditions through momentum

twelve_data_get_ceilTool to retrieve the Ceiling (CEIL) transformation for a time series. Rounds each value in the input data series up to the nearest whole number. Use when you need ceiling-adjusted price data for a sym

twelve_data_get_cmoTool to retrieve Chande Momentum Oscillator (CMO) data for a security. Use when you need to analyze momentum and identify overbought or oversold conditions. Requires at least one instrument identifier

twelve_data_get_dpoTool to calculate the Detrended Price Oscillator (DPO) for a specified financial instrument. Use when you need to identify short-term price cycles and potential overbought or oversold conditions witho

twelve_data_get_earliest_timestampTool to return the first available timestamp for a symbol and interval. Use after selecting instrument identifiers and interval to discover the earliest data point.

twelve_data_get_eodTool to retrieve end of day (EOD) closing price and metadata for a financial instrument. Use when you need daily historical data for stocks, ETFs, or other securities to track performance over time.

twelve_data_get_etfs_world_performanceTool to get global ETF performance metrics (trailing and annual returns). Use when you need detailed performance analytics for an ETF.

twelve_data_get_exchange_rateReturn the current or historical exchange rate for one forex or cryptocurrency pair. Costs one API credit.

twelve_data_get_exchange_scheduleTool to get trading sessions and hours for exchanges. Use when you need pre-market, main, and post-market hours for a given exchange and date.

twelve_data_get_fund_holdersTool to retrieve mutual fund holders for a company. Use when you need details about mutual fund ownership including shares held and percentage of outstanding shares.

twelve_data_get_fundsTool to fetch a daily updated list of available investment funds. Use when you need a directory of funds with optional filtering by symbol, country, exchange, or other identifiers.

twelve_data_get_heikinashi_candlesTool to retrieve Heikin Ashi candlestick data that smooths price action by averaging values. Use when you need to identify trends with reduced market noise for technical analysis.

twelve_data_get_hlc3Tool to calculate the High, Low, Close Average (HLC3) for a security over a specified period. Use when you need to assess average price trends quickly.

twelve_data_get_ht_sineTool to fetch Hilbert Transform Sine Wave (HT_SINE) data for an instrument. The HT_SINE provides sine and cosine wave components derived from the dominant market cycle, helping traders pinpoint potent

twelve_data_get_ichimokuTool to retrieve Ichimoku Kinko Hyo indicator data for analyzing trend direction, support/resistance levels, and trading opportunities. Use when you need to evaluate market trends and identify strateg

twelve_data_get_income_statementTool to retrieve a company's income statement data (annual or quarterly). Use when you need detailed income metrics for a given symbol or identifier.

twelve_data_get_insider_transactionsREQUIRES PRO, ULTRA, OR ENTERPRISE PLAN. Retrieve insider trading transactions for a company including officer/trader names, transaction types (Buy/Sell), dates, share counts, and amounts. Use when yo

twelve_data_get_intervalsTool to retrieve a list of available time intervals supported by the API. Use when you need to know which interval values are valid for time series queries.

twelve_data_get_keltnerTool to retrieve Keltner Channel indicator data for volatility-based technical analysis. Use when you need to identify potential overbought/oversold conditions, assess trend direction, or analyze pric

twelve_data_get_key_executivesREQUIRES ULTRA OR ENTERPRISE PLAN. Retrieve company leadership data including executive names, titles, ages, and compensation. Use when you need detailed management info by symbol or other identifier.

twelve_data_get_last_changeTool to retrieve the latest update timestamps for a fundamentals dataset. Use when checking recent changes (e.g., dividends, splits).

twelve_data_get_latest_priceReturn only the latest available price for one market symbol; use Get Quote when OHLC, volume, change, or market status is needed. Costs one API credit.

twelve_data_get_linear_reg_interceptTool to calculate the y-intercept of a linear regression line for a given dataset. Returns the value where the regression line crosses the y-axis over a specified period.

twelve_data_get_linear_regslopeTool to calculate the linear regression slope for a given dataset over a specified period. Returns the slope of a linear regression line, reflecting the rate of change in the data trend. Use when you

twelve_data_get_linearregangleTool to calculate the linear regression angle for a given time series of stock prices. Returns the slope of the trend line expressed in degrees, which helps identify the direction and steepness of a t

twelve_data_get_log10Tool to compute the base-10 logarithm (LOG10) of a specified input value. Returns the power to which 10 must be raised to obtain the input value. Use when you need to transform data into a logarithmic

twelve_data_get_logoTool to retrieve official logo URLs for a symbol. Use when displaying company, crypto, or forex pair logos in UIs.

twelve_data_get_macdTool to calculate the Moving Average Convergence Divergence (MACD) for a specified financial instrument. Returns the MACD line, signal line, and histogram values to identify potential trend reversals

twelve_data_get_mamaTool to fetch MESA Adaptive Moving Average (MAMA) indicator data. Use when you need to calculate an adaptive moving average that adjusts to market cycles for trend identification and reversal analysis

twelve_data_get_market_moversTool to retrieve a snapshot of top gainers or losers for a specified market. Use when you need to quickly see market movers after choosing a market type.

twelve_data_get_market_stateTool to report current open/closed status for exchanges. Use when you need real-time market status updates after selecting exchanges.

twelve_data_get_maxTool to calculate and return the highest value within a specified data series over a given period. Use when identifying potential resistance levels or detecting extreme price movements in financial da

twelve_data_get_mc_ginley_dynamicTool to calculate the McGinley Dynamic indicator, which provides a refined moving average that adapts to market volatility. Use when tracking price movements with reduced lag and identifying support o

twelve_data_get_medpriceTool to calculate and retrieve the Median Price (MEDPRICE) technical indicator for a security. MEDPRICE represents the average of high and low prices over a specified period, providing a simplified vi

twelve_data_get_minus_diTool to calculate and return the Minus Directional Indicator (MINUS_DI) for a security. Use when analyzing bearish trends and assessing downward price movement strength.

twelve_data_get_mutual_funds_world_performanceTool to get global mutual fund performance metrics (trailing, annual, quarterly, load-adjusted returns). Use when you need detailed performance analytics for a mutual fund.

twelve_data_get_mutual_funds_world_riskTool to fetch global mutual fund risk metrics. Use when you need detailed risk analytics (standard deviation, beta, Sharpe ratio) for a specific mutual fund identifier.

twelve_data_get_mutual_funds_world_summaryTool to retrieve a global mutual fund summary snapshot. Use when you need a high-level overview of a fund’s key identifiers and attributes.

twelve_data_get_mutual_funds_world_sustainabilityTool to get global mutual fund sustainability and ESG metrics. Use when you need fund ESG scores and pillar breakdowns.

twelve_data_get_plus_diTool to fetch the Plus Directional Indicator (PLUS_DI) time series data for a security. Use when you need to assess the strength and intensity of upward price movements over a specified period.

twelve_data_get_priceTool to retrieve the latest market price for a specified financial instrument. Use when you need to get the current price after identifying a symbol.

twelve_data_get_price_targetTool to fetch analysts' price target dataset for equities. Use when you need the latest and historical price forecasts for a symbol.

twelve_data_get_profileTool to retrieve company profile. Use when you need company details like industry, sector, and identifiers after selecting a symbol.

twelve_data_get_quoteReturn the latest quote for one symbol, including OHLC, volume when available, change, market-open status, and 52-week range. Costs one API credit.

twelve_data_get_recommendationsRetrieve aggregated analyst recommendations for a stock. Returns buy/sell/hold consensus ratings across multiple time periods (current month, previous month, 2 and 3 months ago). Use this to understan

twelve_data_get_rocTool to retrieve Rate of Change (ROC) indicator data for a security. ROC calculates the percentage change in price over a defined period, returning a time series of values that help track momentum. Us

twelve_data_get_rocpTool to calculate and return the Rate of Change Percentage (ROCP) for a financial security. Use when you need to identify shifts in price momentum and potential trend reversals.