Twelve data MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Twelve Data MCP or direct API to fetch live stock prices, retrieve historical market data, analyze forex movements, and track cryptocurrency trends through natural language.

Twelve data logoTwelve data
Api Key

Twelve Data is a financial data API providing real-time and historical market data for stocks, forex, crypto, ETFs, and indices. It helps you access accurate, up-to-date financial information for analysis and automation.

97 Tools

Try Twelve data now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Twelve data
Try asking
TOOLS

Supported Tools

Every Twelve data action and event your agent gets out of the box.

Cash Flow

Tool to get company cash flow statement.

Consolidated Cash Flow

Tool to get raw consolidated cash flow statements.

List Commodities

Tool to retrieve a list of supported commodities.

Correlation Coefficient

Tool to fetch Pearson correlation coefficient between two series over a period.

List Countries

Tool to retrieve a list of countries with ISO codes, names, capitals, and currencies.

Cross Listings

Tool to retrieve cross-listed symbols for a security across multiple exchanges.

List Cryptocurrencies

Tool to list all supported cryptocurrencies.

List Cryptocurrency Exchanges

Tool to list supported cryptocurrency exchanges.

Currency Conversion

Tool to convert an amount from one currency to another.

Dividends

Tool to retrieve dividend payout history for a specified symbol.

Earnings

Tool to retrieve earnings data including EPS estimates and actuals.

EPS Revisions

Tool to provide analysts’ revisions of a company’s future EPS over the last week and month.

EPS Trend

Tool to retrieve EPS trend estimates for a specified company.

ETFS Directory

Tool to fetch a daily updated list of exchange-traded funds sorted by total assets.

ETFS Family

Tool to fetch a comprehensive list of ETFs by family.

Get ETF Types

Tool to retrieve ETF categories by market, including types like 'Equity Precious Metals'.

ETF World

Tool to fetch comprehensive ETF analytics (summary, performance, risk, composition).

ETF World Composition

Tool to fetch global ETF composition details including sector, country, asset allocations, top holdings, and bond metrics.

ETF World Risk

Tool to get global ETF risk metrics.

List supported exchanges

Tool to retrieve a list of supported exchanges.

List supported forex pairs

Tool to retrieve a list of all supported forex currency pairs.

Get AD Indicator

Tool to retrieve Accumulation/Distribution (AD) indicator data for a financial instrument.

Get API Usage

Tool to retrieve your current plan and remaining API credits.

Get APO (Absolute Price Oscillator)

Tool to calculate the Absolute Price Oscillator (APO) for a financial instrument.

Get Aroon Indicator

Tool to retrieve Aroon Indicator data for identifying market trends.

Balance Sheet

Tool to retrieve a company's balance sheet (assets, liabilities, equity).

Balance Sheet Consolidated

Tool to get raw consolidated balance sheet data (assets, liabilities, equity) for a company.

Get Bollinger Bands

Tool to calculate Bollinger Bands (BBANDS) for a financial instrument.

Get Bonds

Tool to retrieve a daily updated list of available bonds (fixed income securities).

Get CCI

Tool to retrieve Commodity Channel Index (CCI) values for a specified security.

Get Ceiling (CEIL)

Tool to retrieve the Ceiling (CEIL) transformation for a time series.

Get Chande Momentum Oscillator

Tool to retrieve Chande Momentum Oscillator (CMO) data for a security.

Get Detrended Price Oscillator

Tool to calculate the Detrended Price Oscillator (DPO) for a specified financial instrument.

Get Earliest Timestamp

Tool to return the first available timestamp for a symbol and interval.

Get End of Day Price

Tool to retrieve end of day (EOD) closing price and metadata for a financial instrument.

Global ETF Performance

Tool to get global ETF performance metrics (trailing and annual returns).

Get exchange schedule

Tool to get trading sessions and hours for exchanges.

Get Fund Holders

Tool to retrieve mutual fund holders for a company.

Get Funds

Tool to fetch a daily updated list of available investment funds.

Get Heikin Ashi Candles

Tool to retrieve Heikin Ashi candlestick data that smooths price action by averaging values.

Get HLC3 Average

Tool to calculate the High, Low, Close Average (HLC3) for a security over a specified period.

Get Hilbert Transform Sine Wave

Tool to fetch Hilbert Transform Sine Wave (HT_SINE) data for an instrument.

Get Ichimoku Cloud Indicator

Tool to retrieve Ichimoku Kinko Hyo indicator data for analyzing trend direction, support/resistance levels, and trading opportunities.

Income Statement

Tool to retrieve a company's income statement data (annual or quarterly).

Insider Transactions

REQUIRES PRO, ULTRA, OR ENTERPRISE PLAN.

Get Available Intervals

Tool to retrieve a list of available time intervals supported by the API.

Get Keltner Channel

Tool to retrieve Keltner Channel indicator data for volatility-based technical analysis.

Key Executives

REQUIRES ULTRA OR ENTERPRISE PLAN.

Get Last Change

Tool to retrieve the latest update timestamps for a fundamentals dataset.

Get Linear Regression Angle

Tool to calculate the linear regression angle for a given time series of stock prices.

Get Linear Regression Intercept

Tool to calculate the y-intercept of a linear regression line for a given dataset.

Get Linear Regression Slope

Tool to calculate the linear regression slope for a given dataset over a specified period.

Get Base-10 Logarithm (LOG10)

Tool to compute the base-10 logarithm (LOG10) of a specified input value.

Get Logo

Tool to retrieve official logo URLs for a symbol.

Get MACD

Tool to calculate the Moving Average Convergence Divergence (MACD) for a specified financial instrument.

Get MAMA

Tool to fetch MESA Adaptive Moving Average (MAMA) indicator data.

Market Movers

Tool to retrieve a snapshot of top gainers or losers for a specified market.

Get Market State

Tool to report current open/closed status for exchanges.

Get Maximum Value

Tool to calculate and return the highest value within a specified data series over a given period.

Get McGinley Dynamic Indicator

Tool to calculate the McGinley Dynamic indicator, which provides a refined moving average that adapts to market volatility.

Get Median Price

Tool to calculate and retrieve the Median Price (MEDPRICE) technical indicator for a security.

Get Minus Directional Indicator

Tool to calculate and return the Minus Directional Indicator (MINUS_DI) for a security.

Global Mutual Fund Performance

Tool to get global mutual fund performance metrics (trailing, annual, quarterly, load-adjusted returns).

Mutual Funds World Risk

Tool to fetch global mutual fund risk metrics.

Global Mutual Fund Summary

Tool to retrieve a global mutual fund summary snapshot.

Global Mutual Fund Sustainability

Tool to get global mutual fund sustainability and ESG metrics.

Get Plus Directional Indicator

Tool to fetch the Plus Directional Indicator (PLUS_DI) time series data for a security.

Get Price

Tool to retrieve the latest market price for a specified financial instrument.

Price Target

Tool to fetch analysts' price target dataset for equities.

Get Profile

Tool to retrieve company profile.

Recommendations

Retrieve aggregated analyst recommendations for a stock.

Get Rate of Change (ROC)

Tool to retrieve Rate of Change (ROC) indicator data for a security.

Get ROCP (Rate of Change Percentage)

Tool to calculate and return the Rate of Change Percentage (ROCP) for a financial security.

Get ROCR100

Tool to calculate the Rate of Change Ratio 100 (ROCR100) for a security.

Get Relative Volume

Tool to fetch relative volume (RVOL) data for a security.

Stock Splits

Tool to retrieve historical stock split events.

Splits Calendar

Tool to retrieve a calendar of stock split events.

Get Statistics

Tool to retrieve key company statistics including valuation and financial overview.

Get Stochastic RSI

Tool to calculate the Stochastic Relative Strength Index (Stochastic RSI) for a specified financial instrument.

Get Summation (SUM)

Tool to calculate the cumulative total (Summation) of a specified data series over a defined time period.

Get Technical Indicators List

Tool to retrieve a comprehensive list of available technical indicators.

Get TEMA (Triple Exponential Moving Average)

Tool to calculate the Triple Exponential Moving Average (TEMA) for a financial instrument.

Get Variance (VAR)

Tool to calculate the statistical variance of a financial data series.

Get Weighted Close Price

Tool to calculate and retrieve the Weighted Close Price (WCLPRICE) for a security.

Get Weighted Moving Average (WMA)

Tool to calculate and retrieve the Weighted Moving Average (WMA) for a security over a specified period.

List market indices

Tool to retrieve a list of market indices.

Institutional Holders

Tool to retrieve institutional holders positions for a company.

Mutual Funds Family

Tool to list all available mutual fund families.

Mutual Funds List

Tool to retrieve a daily updated list of mutual funds sorted by total assets.

Mutual Funds World Composition

Tool to fetch global mutual fund portfolio composition including sectors, asset allocation, top holdings, and bond metrics.

Options Chain

Tool to retrieve the options chain for a given symbol and optional expiration date.

Options Expiration

Tool to retrieve available option expiration dates.

Quote

Tool to retrieve the latest market data for a specified symbol.

List Stocks

Tool to retrieve a list of stocks.

Symbol Search

Tool to search for financial instruments by symbol or company name.

Technical Indicators

Tool to fetch time-series data for a specific technical indicator.

Time Series

Tool to retrieve historical and real-time time series data for a specified symbol.

SETUP GUIDE

Connect Twelve data MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Get the latest earnings data for AAPL' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Twelve data API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Twelve data Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Show me the latest dividend payouts for AAPL over the last 3 years.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Twelve data actions with your Agent

Why Use Composio?

AI Native Twelve data Integration

  • Supports both Twelve data MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Twelve data data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Twelve data access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Twelve data
  • Scoped, least privilege access to Twelve data resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Twelve data requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Twelve data.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Twelve data tool your agent needs.Free to start.

Start building