The MCP server is open source under the MIT license. It runs against the Twelve Data API, which has a free tier with limited requests and history; richer coverage, intraday depth, and higher rate limits require a paid Twelve Data plan.

u-tool is an AI-powered router that turns a plain-English request into the correct Twelve Data endpoint call so the agent doesn't have to choose among 100+ tools. It needs an OpenAI key; the individual endpoint tools work without it.

Twelve Data MCP server

OfficialTwelve Data67Config last verified Jun 1, 2026

Twelve Data's official MCP server gives agents real-time and historical market data, fundamentals, and 100+ technical indicators across global markets.

The Twelve Data MCP Server is the official server from Twelve Data that exposes the company's financial market data API to an AI agent. It covers a very broad surface: real-time and end-of-day prices and quotes, historical time series, symbol search and reference data across stocks, forex pairs, cryptocurrencies, ETFs, mutual funds, commodities, and bonds, plus a large fundamentals catalog — income statements, balance sheets, cash flow, earnings, dividends, splits, analyst ratings and price targets, insider and institutional holdings, and market-cap and statistics endpoints. On top of the raw data it registers more than a hundred technical-indicator tools (RSI, MACD, Bollinger Bands, EMA/SMA, ADX, VWAP, Stochastics, Ichimoku, SuperTrend, and many more), each as its own named tool, so an agent can pull a charted indicator directly without computing it locally.

Because exposing every endpoint as a separate tool can overwhelm a model, the server also ships a `u-tool` — an AI-powered universal router that takes a plain-English request, picks the right Twelve Data endpoint and parameters, and returns the result, plus a `get-documentation` helper for grounding. It runs locally over stdio via uvx (package `mcp-server-twelve-data`) authenticating with your Twelve Data API key, and Twelve Data also hosts a remote endpoint at https://mcp.twelvedata.com/mcp. Coverage and rate limits follow your Twelve Data plan, so freshness and history depth track whatever tier the API key is on.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json

json

{
  "mcpServers": {
    "twelvedata": {
      "type": "http",
      "url": "https://mcp.twelvedata.com/mcp",
      "headers": {
        "Authorization": "Bearer <AUTH_HEADER>"
      }
    }
  }
}

Or via CLI

bash

claude mcp add --transport http twelvedata https://mcp.twelvedata.com/mcp

Step-by-step guides

Available tools

Tool	Description
u-tool	AI-powered universal router: takes a natural-language request, selects the right Twelve Data endpoint and parameters, calls it, and returns the result (requires an OpenAI key).
get-documentation	Searches and returns Twelve Data API documentation to ground requests and parameter choices.
GetPrice	Returns the latest real-time price for a symbol.
GetQuote	Returns the latest quote (open, high, low, close, volume, change) for a symbol.
GetTimeSeries	Returns historical OHLCV time series for a symbol at a chosen interval.
GetEod	Returns the latest end-of-day price for a symbol.
GetExchangeRate	Returns the real-time exchange rate for a currency pair.
GetCurrencyConversion	Converts an amount from one currency to another at the live rate.
GetSymbolSearch	Searches for instruments by symbol or name across supported markets.
GetMarketState	Returns whether a given exchange or market is currently open or closed.
GetStocks	Lists available stock instruments with reference metadata.
GetForexPairs	Lists available forex pairs.
GetCryptocurrencies	Lists available cryptocurrencies.
GetEtf	Lists available ETFs.
GetFunds	Lists available mutual funds.
GetCommodities	Lists available commodities.
GetExchanges	Lists supported exchanges with their details.
GetProfile	Returns company profile information for a symbol.
GetLogo	Returns the company or instrument logo URL for a symbol.
GetStatistics	Returns key financial statistics and ratios for a symbol.
GetIncomeStatement	Returns the income statement for a company.
GetBalanceSheet	Returns the balance sheet for a company.
GetCashFlow	Returns the cash-flow statement for a company.
GetEarnings	Returns historical and upcoming earnings for a symbol.
GetEarningsCalendar	Returns the earnings calendar across symbols.
GetDividends	Returns dividend history for a symbol.
GetSplits	Returns stock split history for a symbol.
GetMarketCap	Returns the market capitalization for a symbol.
GetRecommendations	Returns analyst recommendations for a symbol.
GetPriceTarget	Returns analyst price targets for a symbol.
GetInsiderTransactions	Returns recent insider transactions for a company.
GetInstitutionalHolders	Returns institutional holders of a company.
GetMarketMovers	Returns the day's top gaining, losing, or most-active instruments.
GetIpoCalendar	Returns the IPO calendar of upcoming and recent listings.
GetTechnicalIndicators	Lists the technical indicators supported by the API.
GetTimeSeriesRsi	Returns the Relative Strength Index (RSI) indicator series for a symbol.
GetTimeSeriesMacd	Returns the MACD indicator series for a symbol.
GetTimeSeriesBBands	Returns the Bollinger Bands indicator series for a symbol.
GetTimeSeriesEma	Returns the Exponential Moving Average (EMA) series for a symbol.
GetTimeSeriesSma	Returns the Simple Moving Average (SMA) series for a symbol.
GetTimeSeriesAtr	Returns the Average True Range (ATR) indicator series for a symbol.
GetTimeSeriesAdx	Returns the Average Directional Index (ADX) indicator series for a symbol.
GetTimeSeriesVwap	Returns the Volume-Weighted Average Price (VWAP) series for a symbol.
GetTimeSeriesStoch	Returns the Stochastic Oscillator indicator series for a symbol.
GetTimeSeriesIchimoku	Returns the Ichimoku Cloud indicator series for a symbol.
GetTimeSeriesSuperTrend	Returns the SuperTrend indicator series for a symbol.
GetApiUsage	Returns your current Twelve Data API usage and remaining credits.

Required configuration

AUTH_HEADEROptional
For the remote endpoint: the Authorization header value, formatted as `apikey YOUR_TWELVE_DATA_API_KEY`.
OPENAI_API_KEYOptional
OpenAI API key used by the u-tool router for natural-language endpoint selection. Optional; the individual endpoint tools work without it.

What you can do with it

Answer market questions with live data

Ask the agent for a symbol's current quote, recent price action, or market cap and it calls GetQuote, GetTimeSeries, or GetMarketCap directly, so analysis runs on real numbers instead of stale training data.

Pull technical indicators on demand

Have the agent fetch RSI, MACD, Bollinger Bands, or any of the 100+ indicator tools for a ticker and interval, then reason about overbought or trend conditions without computing the math itself.

FAQ

Is it free?: The MCP server is open source under the MIT license. It runs against the Twelve Data API, which has a free tier with limited requests and history; richer coverage, intraday depth, and higher rate limits require a paid Twelve Data plan.
Does it support remote/OAuth?: Yes for remote, not OAuth. It runs locally over stdio via uvx with your Twelve Data API key, and Twelve Data also hosts a remote endpoint at https://mcp.twelvedata.com/mcp authenticated with an Authorization header (`apikey YOUR_KEY`).
What is the u-tool?: u-tool is an AI-powered router that turns a plain-English request into the correct Twelve Data endpoint call so the agent doesn't have to choose among 100+ tools. It needs an OpenAI key; the individual endpoint tools work without it.

← Browse all finance servers