Skip to main content
Glama

Twelve Data MCP Server

Official
by twelvedata
GitHub
Python
MIT License
34
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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:

  1. Visit Twelve Data Sign Up.

  2. Create an account or log in if you already have one.

  3. 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.

U-tool

u-tool is an AI-powered universal router for the Twelve Data API that transforms how you access financial data. Instead of navigating 100+ individual endpoints and complex documentation, simply describe what you need in plain English.

How it works: 🧠 Natural Language Processing: Understands your request in conversational English 🔍 Smart Routing: Uses vector search to find the most relevant endpoints from Twelve Data's entire API catalog 🎯 Intelligent Selection: Leverages OpenAI GPT-4o to choose the optimal method and generate correct parameters ⚡ Automatic Execution: Calls the appropriate endpoint and returns formatted results

What you can ask: 📈 "Show me Apple stock performance this week" 📊 "Calculate RSI for Bitcoin with 14-day period" 💰 "Get Tesla's financial ratios and balance sheet" 🌍 "Compare EUR/USD exchange rates over 6 months" 🏦 "Find top-performing tech ETFs"

Supported data categories:

  • Market data & quotes • Technical indicators (100+)

  • Fundamental data & financials • Currencies & crypto

  • Mutual funds & ETFs • Economic calendars & events

One tool, entire Twelve Data ecosystem. No API documentation required.

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 one of the following snippets to your claude_desktop_config.json: (1) local stdio server configured with utool

{ "mcpServers": { "twelvedata": { "command": "uvx", "args": ["mcp-server-twelve-data@latest", "-k", "YOUR_TWELVE_DATA_API_KEY", "-u", "YOUR_OPEN_AI_APIKEY"] } } }

(2) local stdio server only with 10 the most popular endpoints

{ "mcpServers": { "twelvedata": { "command": "uvx", "args": ["mcp-server-twelve-data@latest", "-k", "YOUR_TWELVE_DATA_API_KEY", "-n", "10"] } } }

(3) twelve data remote mcp server

{ "mcpServers": { "twelvedata-remote": { "command": "npx", "args": [ "mcp-remote", "https://mcp.twelvedata.com/mcp", "--header", "Authorization:${AUTH_HEADER}", "--header", "X-OpenAPI-Key:${OPENAI_API_KEY}" ], "env": { "AUTH_HEADER": "apikey YOUR_TWELVE_DATA_API_KEY", "OPENAI_API_KEY": "YOUR_OPENAI_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)

Install with UV in VS Code

Manual setup

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

{ "mcp": { "servers": { "twelvedata": { "command": "uvx", "args": [ "mcp-server-twelve-data", "-k", "YOUR_TWELVE_DATA_API_KEY", "-u", "YOUR_OPENAI_API_KEY" ] } } } }

Debugging

Use the MCP Inspector for troubleshooting:

npx @modelcontextprotocol/inspector uvx mcp-server-twelve-data@latest -k YOUR_TWELVE_DATA_API_KEY

Development guide

  1. Local testing: Utilize the MCP Inspector as described in Debugging.

  2. 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 \ -k YOUR_TWELVE_DATA_API_KEY \ -u YOUR_OPENAI_API_KEY \ -t streamable-http

License

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

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

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.

  1. Overview
    1. Obtaining Your API Key
      1. U-tool
        1. Installation
          1. Using UV (recommended)
          2. Using pip
        2. Configuration
          1. Claude Desktop integration
          2. VS Code integration
        3. Debugging
          1. Development guide
            1. Docker usage
              1. License

                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
                  54
                  MIT License
                  • Apple

                • Tiger MCP

                  luxiaolei
                  -
                  security
                  F
                  license
                  -
                  quality
                  Enables trading and market analysis through Tiger Brokers API integration. Provides real-time market data, portfolio management, order execution, and technical analysis tools with a comprehensive web dashboard for monitoring.
                  Last updated -
                  1

                • Stock Analysis MCP Server

                  jwangkun
                  -
                  security
                  F
                  license
                  -
                  quality
                  Enables real-time stock market analysis through AKShare API integration. Supports retrieving live stock prices, historical data, technical indicators (MA, MACD, RSI), market sentiment analysis, stock search, and financial news.
                  Last updated -
                  4

                • Yahoo Finance MCP Server

                  citizenhicks
                  -
                  security
                  F
                  license
                  -
                  quality
                  Enables AI assistants to access real-time financial data, historical stock prices, company information, financial statements, options data, market news, and analyst recommendations through Yahoo Finance. Built with FastMCP v2 for efficient HTTP streaming and comprehensive market analysis tools.
                  Last updated -
                  1

                View all related MCP servers

                Appeared in Searches

                New MCP Servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/twelvedata/mcp'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server