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.
1 maintainer
Metadata
1 maintainer
Release files for mcp-server-twelve-data 0.2.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mcp_server_twelve_data-0.2.5.tar.gz | 749.0 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_server_twelve_data-0.2.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 862.1 kB
Release files / mcp_server_twelve_data-0.2.5.tar.gz
| Download URL | mcp_server_twelve_data-0.2.5.tar.gz |
|---|---|
| Size | 749.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
198471c5be0c466fccaa5552c90a752e8f7946da635c1afed3d0399354b39763
|
|
BLAKE2b-256 checksum How to use checksums |
2f00a93dc6163793eda6bc8e5e8665fae377c5f79b2f07044322bd3d3cea4599
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.14
|
Release files / mcp_server_twelve_data-0.2.5-py3-none-any.whl
| Download URL | mcp_server_twelve_data-0.2.5-py3-none-any.whl |
|---|---|
| Size | 113.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b17f02912e961fed7394ee55b4507c333b6c10c268c6b1fb39112280c885b752
|
|
BLAKE2b-256 checksum How to use checksums |
78b6b19acd08e6ec4c5d8f292fb16a68cbc4e3661dbad58f71b19249ec285ae1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.7.14
|
Security for mcp-server-twelve-data 0.2.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
