Skip to content
MCP server

Twelvedata

Market data MCP server for stocks, ETFs, forex, crypto and indices via Twelve Data

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Twelvedata

Twelvedata is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

The Pipeworx gateway wraps Twelve Data's market endpoints as MCP tools, so an AI client can pull OHLC history, live and end-of-day quotes, forex rates and currency conversions without a separate integration. Symbol discovery tools let a client list or validate stock, ETF, forex pair, crypto and index identifiers before querying prices.

Beyond prices, the server exposes earnings history and an earnings calendar, dividend and split histories, and company profiles for stocks. A technical indicator tool covers common studies such as RSI, moving averages, MACD and Bollinger Bands, as listed on the product page.

The README says the endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx, so a connection exposes more than the pack's own tools. Anonymous use is capped daily, and a free registered account raises the limit. It is aimed at developers and analysts building agents that need current or historical market data.

Install

Run in a terminal

claude mcp add --transport http twelvedata https://gateway.pipeworx.io/twelvedata/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/twelvedata/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "twelvedata": {
      "url": "https://gateway.pipeworx.io/twelvedata/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "twelvedata": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/twelvedata/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "twelvedata": {
      "serverUrl": "https://gateway.pipeworx.io/twelvedata/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "twelvedata": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/twelvedata/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (16)

Taken from the project documentation; the running server may differ.

time_series
OHLC time series for a stock, forex, crypto, or ETF symbol.
quote
Real-time quote snapshot for a symbol.
price
Latest trade price for a single symbol.
eod
End-of-day closing quote for a symbol.
exchange_rate
Live forex exchange rate for a currency pair.
currency_conversion
Converts an amount using the current forex pair rate.
stocks
Lists supported stock symbols with exchange and country metadata.
forex_pairs
Lists supported forex currency pairs.
cryptocurrencies
Lists supported cryptocurrency symbols.
etfs
Lists supported ETF symbols, paged.
indices
Lists non-US market index symbols, paged.
earnings
Earnings history and upcoming dates for a stock symbol.
earnings_calendar
Broad earnings calendar across covered symbols.
dividends
Historical dividends for a stock or ETF symbol.
splits
Historical stock splits for a symbol.
profile
Company profile for a stock symbol.

What it does

Historical OHLC series
Returns timestamped open, high, low, close and volume for stock, forex, crypto and ETF symbols at chosen intervals.
Live and end-of-day quotes
Offers intraday quote snapshots, latest trade prices and daily closing quotes for a single symbol.
Forex conversion
Provides live exchange rates for currency pairs and converts an amount at the current rate.
Symbol discovery lists
Lists supported stocks, ETFs, forex pairs, cryptocurrencies and non-US indices to validate tickers before querying.
Earnings and dividends
Covers earnings history, a broad earnings calendar, dividend history and stock split records.
Technical indicators
Computes indicator series such as RSI, moving averages, MACD, Bollinger Bands and ADX for a symbol.

Good for

  • Pulling intraday or daily price history for a stock or crypto symbol into an analysis agent
  • Checking current forex rates or converting an amount between currencies
  • Tracking upcoming earnings dates and reported EPS against estimates
  • Reviewing dividend and split history for income or price-adjustment analysis
  • Validating ticker symbols before running price queries

Pricing

Freemium, from $49 a month

Free anonymous tier (50 calls/day) and free account (200 calls/day); paid credits and $49/$99 monthly plans above that.

Prices change. Check pipeworx.io before you buy.

Twelvedata FAQ

Do I need an API key to use it?

The README says calls work anonymously with a daily cap. An optional Pipeworx API key raises that cap, and the registry lists it as an optional secret variable.

Are US indices like SPX covered?

No. The README states US indices such as SPX, DJI and IXIC are not in Twelve Data's reference list for this pack, and quoting them requires a higher-tier key passed via _apiKey.

Which transports does the MCP server support?

The registry entry lists stdio via the npm package @pipeworx/mcp-twelvedata and a streamable-http remote at the Pipeworx gateway.

Is the server free?

The pricing page describes a free anonymous tier and a free registered account with a higher daily allowance. Pay-as-you-go and subscription rates apply beyond that, and bring-your-own upstream keys are not marked up.

Is Twelvedata free?

Twelvedata has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Twelvedata to Claude Code?

Run this command in your terminal: claude mcp add --transport http twelvedata https://gateway.pipeworx.io/twelvedata/mcp

What are the best alternatives to Twelvedata?

The closest alternatives to Twelvedata are Twelve Data, ApexTick Market Data & Options MCP, Taiwan Stocks, TickerLayer Market Data and mkts Market Data.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers