# Twelve Data MCP > Twelve Data connects real financial market data to your AI agent. Get instant access to current stock quotes, crypto prices, forex rates, and professional technical indicators like RSI, MACD, and Bollinger Bands through natural language conversation. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** market-data, stock-quotes, forex, cryptocurrency, technical-indicators ## Description Need to analyze what's happening in the markets? This MCP lets you ask your agent questions about stocks, crypto, or foreign exchange using plain English. You don't have to jump between charting software and data providers anymore. Your AI client pulls real-time quotes and historical candle data right into your workflow. Need to compare a stock against its 200-day average? Just ask for the Simple Moving Average (SMA). Want to know if an asset is overbought or oversold? You can run indicators like RSI, MACD, or Bollinger Bands instantly. It's designed to make financial analysis part of your conversation. Connecting this MCP via Vinkius means you get access to a massive catalog of tools, so once you're analyzing market data, you don't have to switch services. It simply adds the full depth of global market metrics and fundamental company profiles into your existing AI agent. ## Tools ### convert_currency Converts a specific amount of money from one currency to another. ### get_bollinger_bands Calculates Bollinger Bands, which help identify if prices are moving too far above or below their average range. ### get_company_profile Retrieves key fundamental data and general profile information for a listed company. ### get_crypto_list Lists available cryptocurrency pairs, allowing you to filter by the specific exchange. ### get_ema Calculates the Exponential Moving Average (EMA), giving more weight to recent price movements than simpler averages. ### get_exchange_rate Gets the current, real-time exchange rate between two specified currencies. ### get_forex_list Lists all available foreign exchange pairs for currency analysis. ### get_macd Calculates the Moving Average Convergence Divergence (MACD) to track momentum and potential trend changes. ### get_quote Retrieves a comprehensive, real-time quote including open, high, low, volume, and current price for any stock. ### get_rsi Calculates the Relative Strength Index (RSI), which shows if an asset is currently overbought or oversold. ### get_real_time_price Fetches only the current trading price for a stock, offering a quick check without full quote data. ### get_sma Calculates the Simple Moving Average (SMA) over common periods like 20 or 50 days. ### get_stochastic Computes the Stochastic Oscillator, helping determine if an asset is potentially reaching extreme value levels. ### get_stock_list Lists available stocks and allows filtering by exchange or partial symbol match. ### get_time_series Gets historical candlestick data (OHLCV) spanning time intervals from one minute up to one month. ### search_symbols Searches for financial instruments using criteria like instrument type and exchange name. ## Prompt Examples **Prompt:** ``` What's the current price of Apple stock? ``` **Response:** ``` AAPL is currently trading at $192.45, up 1.23% (+$2.34) from yesterday's close. Open: $190.50, High: $193.10, Low: $189.80. Volume: 52.3M shares. ``` **Prompt:** ``` Show me the RSI for Tesla on the daily chart. ``` **Response:** ``` TSLA RSI (14-period) on daily chart: 58.3 — neutral territory. Not overbought (>70) or oversold (<30). The RSI has been trending upward over the past 5 sessions. ``` **Prompt:** ``` Convert 1000 USD to EUR. ``` **Response:** ``` 1,000 USD = 921.50 EUR at the current exchange rate of 0.9215. Rate updated in real-time. ``` ## Capabilities ### Get Real-Time Pricing Retrieve current prices for stocks, crypto pairs, and forex instruments. ### Calculate Technical Indicators Compute complex metrics like RSI, MACD, EMA, and Bollinger Bands based on price history. ### Analyze Price History Pull detailed OHLCV candlestick data for any time period, from minutes to months. ### Manage Currencies Convert amounts between different currencies and fetch real-time exchange rates. ### Research Companies Access fundamental data, including market capitalization and P/E ratios, for specific companies. ## Use Cases ### Assessing crypto momentum A trader asks their agent: 'Show me the Bollinger Bands and RSI for Bitcoin right now.' The agent calls `get_bollinger_bands` and `get_rsi`, providing a single, immediate assessment of whether BTC is in an overbought or oversold condition. ### Comparing stocks across timeframes A researcher needs to compare Tesla's performance. They ask the agent to pull data for three different periods: 'Get me 1-month historical OHLCV data, then calculate the Simple Moving Average (SMA) and EMA.' This uses `get_time_series`, `get_sma`, and `get_ema` sequentially. ### Budgeting international projects A project manager needs to know the cost of goods in Euros. They ask: 'How many USD is 5,000 EUR worth right now?' The agent calls `get_exchange_rate` and presents the instant conversion using `convert_currency`. ### Due diligence on a public company A financial analyst asks: 'What is Apple's current market cap, P/E ratio, and what was its real-time price today?' The agent uses `get_company_profile` for fundamentals and `get_quote` for the live metrics. ## Benefits - You don't have to manually calculate technical metrics. Use functions like `get_rsi` or `get_macd` to instantly determine if an asset is overbought or oversold based on its current price action. - Get a full picture of market health by combining fundamental data with pricing tools. You can use `get_company_profile` alongside real-time quotes from `get_quote` for comprehensive analysis. - Stop tracking prices in multiple formats. The MCP handles everything, giving you historical OHLCV candle data via `get_time_series`, supporting intervals from 1 minute up to a full month. - Manage global finances without leaving your agent chat. Easily convert currencies using `convert_currency` and find the exact exchange rate with `get_exchange_rate` for any pair. - Speed matters in trading. If you only need a quick price check, use `get_real_time_price` instead of pulling full quote data to keep your prompts fast and concise. ## How It Works The bottom line is you get professional-grade financial analysis results without leaving your conversational workflow. 1. Subscribe to the Twelve Data MCP and provide your unique API key. 2. Tell your agent what you need—for example, 'What is the RSI for TSLA on a daily chart?' 3. Your AI client executes the necessary function calls and returns the calculated data or quote directly. ## Frequently Asked Questions **How do I use Twelve Data MCP to find the current price of Apple stock?** You can get a quick check using the `get_real_time_price` tool. For more detail, run `get_quote`. The quote provides volume, open, high, and low alongside the current price. **Can Twelve Data MCP help me with currency conversions?** Yes, you use the `convert_currency` tool. You just specify the amount and the two currencies, and it performs the conversion instantly using real-time rates from `get_exchange_rate`. **What is the best way to check historical data with Twelve Data MCP?** Use `get_time_series`. This tool lets you pull OHLCV candlestick data and supports a wide range of intervals, from 1-minute candles up through monthly summaries. **How does the MACD work with Twelve Data MCP?** The `get_macd` function calculates the Moving Average Convergence Divergence. It's used by your agent to help identify potential shifts in momentum and trends in an asset's price. **Do I need a specific tool for every indicator with Twelve Data MCP?** No, you just ask the question. The MCP routes it through the correct function call, whether it’s `get_rsi`, `get_sma`, or `get_macd`. You don't have to remember which one does what.