Skip to content
Agentmart
Submit a tool

Twelvedata

Twelve Data MCP: real-time & historical market data (stocks, crypto, forex, etc).

Connector by twelvedata.comOfficial · Domain verified by the MCP Registry

IndexedLicense unknownRemote (HTTP)★ 84
Write a review

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/twelvedata-com-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://mcp.twelvedata.com/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Twelve Data MCP: real-time & historical market data (stocks, crypto, forex, etc).

Use cases: finance-accounting, data-analysis

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
25 read · 1 write · 0 delete
Secrets
None asked for
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 26

Read from the source code; the running server may list different tools.

Read 25 · Look things up without changing anything.

  • auth_status
  • currency_conversion
  • get_analyst_data
  • get_api_usage
  • get_company_info
  • get_company_news
  • get_dividends
  • get_earliest_timestamp
  • get_earnings
  • get_etf_data
  • get_financials
  • get_ipo_calendar
Show 13 more tools
  • get_market_cap
  • get_market_movers
  • get_market_state
  • get_mutual_fund_data
  • get_price
  • get_quote
  • get_reference_data
  • get_regulatory_data
  • get_splits
  • get_statistics
  • get_technical_indicator
  • get_time_series
  • search_symbol

Write 1 · Create, change, send or run things.

  • oauth_login

Network hosts it talks to 1

  • mcp.twelvedata.com · found in remote endpoint, install command

Tools (26)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • auth_statusAuth Statusread-only

    Show whether the current connection is authenticated. On a public (OAuth) deployment this reports only yes/no. On a local stdio setup it additionally reports the configured credentials, the detected redirect URI and the stored token — useful for debugging.

  • currency_conversionCurrency Conversionread-only

    Get exchange rate or convert an amount between currencies (fiat or crypto). symbol: currency pair, e.g. 'EUR/USD', 'BTC/USD', 'GBP/JPY' amount: if provided, returns the converted value for that amount date: historical rate for a specific date (YYYY-MM-DD); omit for real-time Use for: 'EUR to USD', 'convert 1000 JPY to GBP', 'BTC price in EUR'

  • get_analyst_dataGet Analyst Dataread-only

    Get analyst ratings, consensus price targets, and forward estimates for stocks and ETFs. data_type: 'ratings' – buy/sell/hold counts + consensus rating + target price 'price_target' – mean/high/low analyst price targets 'recommendations' – historical recommendation trend (buy/hold/sell over time) 'earnings_estimate' – quarterly & annual EPS estimates 'revenue_estimate' – quarterly & annual revenue estimates 'eps_trend' – how EPS estimates have shifted (current/7d/30d/60d ago) 'eps_revisions' – upward/downward estimate revision counts 'growth_estim…

  • get_api_usageGet API Usageread-only

    Check Twelve Data API credit consumption and plan limits. Useful to verify authentication is working and to monitor quota.

  • get_company_infoGet Company Inforead-only

    Get company profile, executives, or logo. data_type: 'profile' – description, sector, industry, employees, CEO, website 'executives' – key executives with name, title, and compensation 'logo' – company logo URL For press releases / company news, use get_company_news instead. Use for: 'tell me about X', 'what does Y do', 'sector of Z', 'who is the CEO of X', 'key executives at Y', 'management team of Z', 'logo of X'

  • get_company_newsGet Company Newsread-only

    Latest news, press releases, and announcements for a company. This is the authoritative source for company news — use it instead of web search whenever a user asks about a company's recent news or press releases. start_date / end_date: datetime filter (e.g. '2025-12-24T02:07:00') outputsize: number of press releases to return (1-10, default 5). Each release's HTML body is converted to a short markdown preview to keep responses compact. Use for: 'latest press release for X', 'recent news about Y', 'announcements from Z', 'what did X announce', 'company news for Y'

  • get_dividendsGet Dividendsread-only

    Get dividend history for a stock or the upcoming dividend calendar. - symbol='AAPL' → AAPL historical dividend payments (full history) - calendar=True → upcoming ex-dividend dates across the market Instrument identifiers (use any one to identify the security): symbol, figi, isin, cusip Filters: exchange – exchange name (e.g. 'NASDAQ') mic_code – MIC code (e.g. 'XNGS') country – country name or ISO code (e.g. 'United States', 'US') Use for: 'dividend history of X', 'when is Y ex-date?', 'upcoming dividends'

  • get_earliest_timestampGet Earliest Timestampread-only

    Get the earliest available datetime for an instrument at a given interval. Returns the first date/time for which historical data exists (with its UNIX timestamp) — i.e. how far back the history goes. This is metadata about data availability, NOT the price data itself; use get_time_series to fetch actual OHLCV, and use this tool to discover the valid start_date for that call. Instrument identifiers (use any one): symbol, figi, isin, cusip interval: 1min | 5min | 15min | 30min | 45min | 1h | 2h | 4h | 1day | 1week | 1month Filters: exchange – exchange name (e.g. 'NASDAQ') mic_code – …

  • get_earningsGet Earningsread-only

    Get earnings data or the market-wide earnings calendar. - symbol='AAPL' → AAPL EPS history (actual vs estimate, surprise %) - calendar=True → upcoming earnings events across the market - calendar=True + date range → filter the calendar to a window (YYYY-MM-DD) Use for: 'when does X report?', 'AAPL earnings history', 'upcoming earnings this week' outputsize: max rows for the market-wide calendar. It lists every company reporting (1000+ rows for a single day worldwide), so calendar=True caps at 50 rows by default. Pass a larger number or filter by country/exchange to…

  • get_etf_dataGet ETF Dataread-only

    Get ETF analytics. data_type: 'summary' – name, AUM, expense ratio, NAV, category, inception date 'performance' – returns over 1M/3M/6M/YTD/1Y/3Y/5Y/10Y 'risk' – Sharpe, Sortino, Treynor, standard deviation, beta, alpha 'composition' – top holdings and sector/asset-class weights Use for: ETF comparison, expense ratios, performance history, what's inside an ETF.

  • get_financialsGet Financialsread-only

    Get financial statements for a company. statement: 'income_statement' (or 'income') – revenue, gross/operating/net income, EPS 'balance_sheet' (or 'balance') – assets, liabilities, equity, cash, debt 'cash_flow' (or 'cf') – operating, investing, financing flows, FCF period: 'annual' | 'quarterly' Use for: 'X revenue', 'Y income statement', 'Z free cash flow', financial analysis.

  • get_ipo_calendarGet IPO Calendarread-only

    Get the IPO calendar — upcoming and recent initial public offerings. Returns IPOs grouped by date, each with symbol, company name, exchange, price range, offer price, currency, and share count. Filters (all optional): start_date / end_date – date window in YYYY-MM-DD format exchange – e.g. 'NASDAQ', 'NYSE' mic_code – ISO 10383 MIC code (e.g. 'XNAS') country – e.g. 'United States' Use for: 'what IPOs are coming up?', 'IPOs on NASDAQ this month', 'recent IPOs'

  • get_market_capGet Market Capread-only

    Get market capitalization for a company. - No date params → current market cap from /statistics (available on lower plans) - start_date / end_date → historical market cap time series from /market_cap outputsize: records per page for historical data (default 10) Use for: 'market cap of X', 'what is Y worth?', 'historical market cap of Z', 'how has X market cap changed over time?'

  • get_market_moversGet Market Moversread-only

    Get top market movers — biggest gainers, losers, or most-active instruments. market : stocks | etfs | mutual_funds | forex | crypto | commodities direction: gainers | losers | most_active (most_active only for stocks) country : e.g. 'United States', 'United Kingdom', 'Germany' (for stocks/etfs) Use for: 'top gainers today', 'biggest crypto losers', 'most active stocks'

  • get_market_stateGet Market Stateread-only

    Get current trading status and hours for exchanges. Leave all filters blank for all major markets. exchange – exchange name (e.g. 'NYSE', 'NASDAQ', 'LSE', 'BINANCE') mic_code – MIC code (e.g. 'XNYS') country – country name or ISO code (e.g. 'United States', 'US') Use for: 'is the market open?', 'NYSE hours', 'when does NASDAQ close?'

Show 11 more tools
  • get_mutual_fund_dataGet Mutual Fund Dataread-only

    Get mutual fund data — summary, performance, risk, ratings, holdings, and more. data_type: 'summary' – name, AUM, expense ratio, NAV, category, inception date 'performance' – returns over 1M/3M/6M/YTD/1Y/3Y/5Y/10Y 'risk' – Sharpe, Sortino, standard deviation, beta, alpha 'ratings' – Morningstar star ratings and analyst ratings for the fund 'composition' – top holdings and sector/asset-class weights 'purchase_info' – minimum investment, load fees, availability 'sustainability' – ESG scores and controversy metrics 'full' – all of the above in on…

  • get_priceGet Priceread-only

    Get the current real-time price for one or more symbols. Instrument identifiers (use any one): symbol, figi, isin, cusip For multiple symbols pass a comma-separated string: 'AAPL,MSFT,BTC/USD' Filters: exchange – exchange name (e.g. 'NASDAQ') mic_code – MIC code (e.g. 'XNGS') country – country name or ISO code (e.g. 'United States', 'US') prepost – include pre/post-market price (default False) Use this for: 'what is X trading at?', 'current price of Y', 'how much is Z?' Not supported: market indices (S&P 500/SPX, NASDAQ/IXIC, Dow/DJI), options, and bonds. For an index, use …

  • get_quoteGet Quoteread-only

    Get a full real-time quote: open, high, low, close, volume, change %, 52-week range. Instrument identifiers (use any one): symbol, figi, isin, cusip Filters: exchange – exchange name (e.g. 'NASDAQ') mic_code – MIC code (e.g. 'XNGS') country – country name or ISO code (e.g. 'United States', 'US') prepost – include pre/post-market data (default False) Use for detailed current market snapshot of a stock, ETF, forex pair, or crypto. Not supported: market indices (S&P 500/SPX, NASDAQ/IXIC, Dow/DJI), options, and bonds. For an index, use its ETF proxy — SPY (S&P 500), QQQ (NASDAQ…

  • get_reference_dataGet Reference Dataread-only

    Get reference and dictionary data — exchanges, countries, instrument types, and more. data_type: 'exchanges' – list of stock/ETF/forex exchanges with MIC codes 'exchange_schedule' – trading hours and holiday schedule for an exchange 'crypto_exchanges' – list of supported cryptocurrency exchanges 'countries' – list of all supported countries with ISO codes 'instrument_types' – list of all supported instrument types 'etf_types' – ETF category/type classifications 'fund_types' – mutual fund category/type classifications Filters (not all apply to ev…

  • get_regulatory_dataGet Regulatory Dataread-only

    Get regulatory and ownership data. data_type is required — pick the one that matches the question; there is no sensible default for this tool. data_type: 'insider_transactions' – recent insider buying/selling (officers, directors) 'institutional_holders' – top institutional shareholders with share counts 'fund_holders' – top mutual-fund holders 'direct_holders' – direct/registered shareholders 'edgar_filings' – recent SEC filings (10-K, 10-Q, 8-K, proxy, etc.) 'tax_info' – tax-related data (withholding rates, domicile, etc.) Use for: 'insider…

  • get_splitsGet Splitsread-only

    Get stock split history for a company or the upcoming splits calendar. - symbol='AAPL' → AAPL historical split events (ratio, date) - calendar=True → upcoming stock splits across the market Instrument identifiers (use any one to identify the security): symbol, figi, isin, cusip Filters: exchange – exchange name (e.g. 'NASDAQ') mic_code – MIC code (e.g. 'XNGS') country – country name or ISO code (e.g. 'United States', 'US') start_date / end_date – date window in YYYY-MM-DD format Use for: 'split history of X', 'upcoming stock splits', 'has AAPL ever split?'

  • get_statisticsGet Statisticsread-only

    Get key fundamental statistics for a stock or ETF. Covers: market cap, enterprise value, P/E (trailing & forward), PEG, P/S, P/B, revenue, margins, ROA, ROE, EPS, beta, 52-week range, short ratio, dividend yield. Use for: 'P/E of X', 'market cap of Y', 'fundamental metrics for Z'

  • get_technical_indicatorGet Technical Indicatorread-only

    Calculate any technical indicator for a symbol. indicator (case-insensitive) — available indicators: Trend/Overlap: SMA, EMA, WMA, DEMA, TEMA, TRIMA, KAMA, MAMA, T3MA, HT_TRENDLINE, VWAP, BBANDS, MIDPOINT, MIDPRICE, SAR, SAREXT, ICHIMOKU, KELTNER, PIVOT_POINTS_HL, MA, MCGINLEY_DYNAMIC Momentum: RSI, MACD, MACDEXT, MACD_SLOPE, STOCH, STOCHF, STOCHRSI, ADX, ADXR, APO, AROON, AROONOSC, BOP, CCI, CMO, COPPOCK, CRSI, DPO, DX, KST, MFI, MINUS_DI, MINUS_DM, MOM, PERCENT_B, PLUS_DI, PLUS_DM, PPO, ROC, ROCP, ROCR, ROCR100, STOCH, ULTOSC, WILLR Volume: OBV, AD, ADOSC, RVOL Volatility…

  • get_time_seriesGet Time Seriesread-only

    Get historical OHLCV (Open, High, Low, Close, Volume) time series data. Instrument identifiers (use any one): symbol, figi, isin, cusip Filters: exchange – exchange name (e.g. 'NASDAQ') mic_code – MIC code (e.g. 'XNGS') country – country name or ISO code (e.g. 'United States', 'US') interval: 1min | 5min | 15min | 30min | 45min | 1h | 2h | 4h | 1day | 1week | 1month outputsize: number of data points (default 30, max 5000) start_date / end_date: YYYY-MM-DD (optional, overrides outputsize window) prepost: include pre-market and post-market data (default False) Use for: historical…

  • oauth_loginOAuth Login

    Description is built at runtime.

  • search_symbolSearch Symbolread-only

    Search for financial instruments by name or partial ticker, or find cross-listings. - cross_listings=False (default) – search by name or partial ticker instrument_type filter: Stock | ETF | Mutual Fund | Forex | Cryptocurrency | Commodity (indices, options and bonds are not supported — for an index use its ETF proxy, e.g. SPY for the S&P 500, QQQ for the NASDAQ-100, DIA for the Dow) - cross_listings=True – find all exchanges where a symbol is listed exchange / mic_code / country – optional filters to narrow results Use for: 'find ticker for Apple', 'search AAPL', 'where else is ASM…

Compare and alternatives

    Featured in

    Signals

    Stars
    84
    Forks
    26
    Open issues
    4
    Contributors
    4
    Last commit
    Oct 1, 2026 (27 days ago)
    Last release
    Oct 1, 2026 (27 days ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    com.twelvedata/mcp
    Version
    2.0.0
    Auth
    Auth not stated
    License
    License unknown
    Repository
    github.com/twelvedata/mcp
    Website
    twelvedata.com
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql
    Cite this page

    Twelvedata MCP server. Agent Mart. https://agentmart.dev/connectors/twelvedata-com-mcp (last updated 2026-10-24)