Twelve Data MCP Server

Overview

The Twelve Data MCP Server provides a seamless integration with the Twelve Data API to access financial market data. It enables retrieval of historical time series, real-time quotes, and instrument metadata for stocks, forex pairs, and cryptocurrencies.

Note: This server is currently in early-stage development; features and tools may evolve alongside updates to the Twelve Data API.

Obtaining Your API Key

To use Twelve Data MCP Server, you must first obtain an API key from Twelve Data:

Visit Twelve Data Sign Up.
Create an account or log in if you already have one.
Navigate to your Dashboard and copy your API key.

Important: Access to specific endpoints or markets may vary depending on your Twelve Data subscription plan.

Tools

time_series Fetch historical price data for a symbol.
- Inputs:
  - symbol (string): Ticker, e.g. AAPL
  - interval (string): Data interval, e.g. 1min, 1day
  - start_date (string, optional): ISO-8601 start timestamp
  - end_date (string, optional): ISO-8601 end timestamp
- Returns: Array of OHLCV bars.
price Get the latest price for a symbol.
- Inputs:
  - symbol (string)
- Returns: Latest price quote.
stocks List available stock instruments.
- Inputs:
  - exchange (string, optional): Exchange code to filter by
- Returns: Array of stock metadata.
forex_pairs List available forex pairs.
- Inputs: none
- Returns: Array of forex pair metadata.
cryptocurrencies List available cryptocurrencies.
- Inputs: none
- Returns: Array of cryptocurrency metadata.

Installation

Using UV (recommended)

Directly run without local installation using uvx:

uvx mcp-server-twelve-data --help

Using pip

Install the server via pip:

pip install mcp-server-twelve-data
python -m mcp_server_twelve_data --help

Configuration

Claude Desktop integration

Add the following snippet to your claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "uvx",
      "args": ["--reinstall", "mcp-server-twelve-data", "--apikey", "YOUR_API_KEY"]
    }
  }
}

or this one, to use our remote http server

{
  "mcpServers": {
    "twelvedata-remote": {
      "command": "npx",
      "args":    [
        "mcp-remote", "https://mcp.twelvedata.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "apikey YOUR_API_KEY"
      }
    }
  }
}

See how easy it is to connect Claude Desktop to Twelve Data MCP Server:

Example usage with Claude Desktop

VS Code integration

Automatic setup (with UV)

Manual setup

For manual configuration, add to your User Settings (JSON):

{
  "mcp": {
    "servers": {
      "twelvedata": {
        "command": "uvx",
        "args": ["mcp-server-twelve-data", "-t", "streamable-http"]
      }
    }
  }
}

Debugging

Use the MCP Inspector for troubleshooting:

npx @modelcontextprotocol/inspector uvx mcp-server-twelve-data

Development guide

Local testing: Utilize the MCP Inspector as described in Debugging.
Claude Desktop:: Update claude_desktop_config.json to reference local source paths.

Docker usage

Build and run the server using Docker:

docker build -t mcp-server-twelve-data .
docker run --rm mcp-server-twelve-data --apikey YOUR_API_KEY

License

This MCP server is licensed under the MIT License. See the LICENSE file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

Provides integration with Twelve Data API to access financial market data including historical time series, real-time quotes, and instrument metadata for stocks, forex pairs, and cryptocurrencies.

Related MCP Servers

Cryptocurrency Market Data MCP Server
Nayshins
A
security
A
license
A
quality
Provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information.
Last updated -
7
26
Python
MIT License
PolyMarket MCP Server
berlinbra
A
security
A
license
A
quality
Enables interaction with the PolyMarket API to fetch prediction market data such as market information, prices, and historical data, with robust error handling and rate limit management.
Last updated -
4
21
Python
MIT License
Alpha Vantage Stock Analysis MCP Server
ranveer0323
A
security
A
license
A
quality
Allows Claude and other MCP clients to access real-time and historical stock market data from Alpha Vantage API, including intraday and daily stock data with customizable intervals.
Last updated -
3
3
TypeScript
MIT License
Asset Price MCP Server
mk965
A
security
A
license
A
quality
A server that provides tools for retrieving real-time price information for various assets including precious metals and cryptocurrencies, allowing language models to access and display current asset price data.
Last updated -
1
56
1
JavaScript
MIT License

View all related MCP servers

Twelve Data MCP Server