Twelve Data MCP Server
Seamless AI-powered access to financial market data via the Twelve Data API.
Key Features
Use Cases
README
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.
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:
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",
"-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
- Local testing: Utilize the MCP Inspector as described in Debugging.
- Claude Desktop:: Update
claude_desktop_config.jsonto 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.
Star History
Repository Owner
Organization
Repository Details
Programming Languages
Tags
Topics
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Dappier MCP Server
Real-time web search and premium data access for AI agents via Model Context Protocol.
Dappier MCP Server enables fast, real-time web search and access to premium data sources, including news, financial markets, sports, and weather, for AI agents using the Model Context Protocol (MCP). It integrates seamlessly with tools like Claude Desktop and Cursor, allowing users to enhance their AI workflows with up-to-date, trusted information. Simple installation and configuration are provided for multiple platforms, leveraging API keys for secure access. The solution supports deployment via Smithery and direct installation with 'uv', facilitating rapid setup for developers.
- ⭐ 35
- MCP
- DappierAI/dappier-mcp
Hive Intelligence MCP Server
Unified MCP server delivering advanced cryptocurrency and Web3 analytics.
Hive Intelligence MCP Server provides comprehensive cryptocurrency, DeFi, and Web3 analytics via the Model Context Protocol. It enables AI assistants to access and orchestrate over 200 specialized tools covering market data, on-chain analytics, portfolio tracking, and security analysis. The server offers both dynamic and category-specific analytics through a unified MCP interface, facilitating intelligent tool orchestration for diverse crypto data needs.
- ⭐ 7
- MCP
- hive-intel/hive-crypto-mcp
Marketaux MCP Server
MCP server integrating Marketaux news search API for contextual information retrieval.
Marketaux MCP Server implements a Model Context Protocol (MCP) server that connects to the Marketaux news API, enabling contextual search based on entities, countries, industries, and symbols. It provides a standardized interface for AI models to retrieve news content relevant to various input parameters using the Marketaux API. The tool supports configurable options such as symbols, industries, language, and publication timestamps, delivering dynamic news search results. Environment configuration is enabled through API keys and customizable server setup.
- ⭐ 4
- MCP
- Zolo-Ryan/MarketAuxMcpServer
Exa MCP Server
Fast, efficient web and code context for AI coding assistants.
Exa MCP Server provides a Model Context Protocol (MCP) server interface that connects AI assistants to Exa AI’s powerful search capabilities, including code, documentation, and web search. It enables coding agents to retrieve precise, token-efficient context from billions of sources such as GitHub, StackOverflow, and documentation sites, reducing hallucinations in coding agents. The platform supports integration with popular tools like Cursor, Claude, and VS Code through standardized MCP configuration, offering configurable access to various research and code-related tools via HTTP.
- ⭐ 3,224
- MCP
- exa-labs/exa-mcp-server
FinData MCP Server
Open-source MCP server for LLM access to professional financial data.
FinData MCP Server offers standardized financial data access to large language models by implementing the Model Context Protocol. It supports multiple data providers such as Tushare and Wind, and enables retrieval of both market and macroeconomic data via Stdio or SSE transports. The server is configurable and integrates into AI systems, providing tools for market, fundamental, and financial data queries.
- ⭐ 45
- MCP
- zlinzzzz/finData-mcp-server
AgentQL MCP Server
MCP-compliant server for structured web data extraction using AgentQL.
AgentQL MCP Server acts as a Model Context Protocol (MCP) server that leverages AgentQL's data extraction capabilities to fetch structured information from web pages. It allows integration with applications supporting MCP, such as Claude Desktop, VS Code, and Cursor, by providing an accessible interface for extracting structured data based on user-defined prompts. With configurable API key support and streamlined installation, it simplifies the process of connecting web data extraction workflows to AI tools.
- ⭐ 120
- MCP
- tinyfish-io/agentql-mcp
Didn't find tool you were looking for?