Twelve Data MCP: market data for stocks, forex and crypto

Add Twelve Data to Claude, ChatGPT or Cursor

1. 1Click Connect Twelve Data free and sign in with your Twelve Data account.
2. 2All of this is read-only market data, so the question is focus. Keep the quote, time series and indicator tools, and switch off lists you won't need, such as mutual funds or commodities, so your AI app chooses from a shorter list.
3. 3Add ContextGate to your AI app as a connector or MCP server. The steps for each app are on the Works with page.
4. 4Ask your AI app for Apple's daily closing prices over the last three months, then open Activity to see the time series call.

Market data questions for Claude or ChatGPT

• Get a real-time quote or historical time series for a symbol.
• Fetch a technical indicator for a symbol and interval.
• Look up dividends, earnings, EPS trends and analysts' EPS revisions.
• Pull an options chain with greeks, or the available expiration dates.
• Convert currencies and search for symbols by company name.

Lookups you can trace

• Switch off tools outside your work; they're hidden from your AI app and refused if called.
• Activity keeps a record of every quote and series your AI apps pull.

What you get with Twelve Data and ContextGate

• Your AI apps can use Twelve DataClaude, Cursor, ChatGPT and other AI apps reach Twelve Data through the one ContextGate connection you add to them.
• You choose which tools they can useSwitch off any Twelve Data tool you don't want used. It's hidden from your AI apps and refused if called.
• Every call is checked and recordedYour policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.

ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.

Twelve Data tools

Examples of what your AI apps can do in Twelve Data. You'll see the exact list of tools after you connect it.

• List CommoditiesTool to retrieve a list of supported commodities. use when you need all available commodities after obtaining a valid api key.
• List CryptocurrenciesTool to list all supported cryptocurrencies. use when you need the complete set of crypto symbols. use after obtaining a valid api key.
• Currency ConversionTool to convert an amount from one currency to another. use after confirming currency codes to retrieve real-time conversion.
• DividendsTool to retrieve dividend payout history for a specified symbol. use when you need historical dividends over multiple years.
• EarningsTool to retrieve earnings data including eps estimates and actuals. use when you need detailed earnings history for a selected stock symbol.
• 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.
• List supported exchangesTool to retrieve a list of supported exchanges. use when you need all available stock and forex exchanges.
• List supported forex pairsTool to retrieve a list of all supported forex currency pairs. use when exploring available forex pairs before making other forex data requests.
• List market indicesTool to retrieve a list of market indices. use when you need to fetch available indices filtered by country.
• Mutual Funds ListTool to retrieve a daily updated list of mutual funds sorted by total assets. use when you need to enumerate available mutual funds for analysis.
• Options ChainTool to retrieve the options chain for a given symbol and optional expiration date. use when you need detailed option contract data and greeks. omitting date returns all expirations.
• Options ExpirationTool to retrieve available option expiration dates. use when exploring available expiration dates for a given options symbol.
• QuoteTool to retrieve the latest market data for a specified symbol. use when you need a quick real-time quote after selecting a symbol.
• List StocksTool to retrieve a list of stocks. use when you need to fetch securities with optional filtering by exchange, country, type, or symbol.
• Symbol SearchTool to search for financial instruments by symbol or company name. use when you need to discover available symbols before making further data requests.
• Technical IndicatorsTool to fetch time-series data for a specific technical indicator. use when you have a symbol, interval, and indicator name.
• Time SeriesTool to retrieve historical and real-time time series data for a specified symbol. use when you need to fetch price data over a time range after selecting a symbol.
• EPS RevisionsTool to provide analysts’ revisions of a company’s future eps over the last week and month. use after confirming the stock symbol.
• EPS TrendTool to retrieve historical eps trends for a specified company. use after selecting a stock symbol to view estimated vs actual eps and surprise indicators. returns a breakdown of eps actuals, estimate
• ETFS FamilyTool to fetch a comprehensive list of etfs by family. use when you need to list etfs managed by a specific investment company.