# 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](https://twelvedata.com/register?utm_source=github&utm_medium=repository&utm_campaign=mcp_repo).
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`](https://docs.astral.sh/uv/guides/tools/):
```bash
uvx mcp-server-twelve-data --help
```
### Using **pip**
Install the server via pip:
```bash
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
```json
{
"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 30 the most popular endpoints
```json
{
"mcpServers": {
"twelvedata": {
"command": "uvx",
"args": ["mcp-server-twelve-data@latest", "-k", "YOUR_TWELVE_DATA_API_KEY", "-n", "30"]
}
}
}
```
(3) twelve data remote mcp server
```json
{
"mcpServers": {
"twelvedata-remote": {
"command": "npx",
"args": [
"mcp-remote", "https://mcp.twelvedata.com/mcp/",
"--header",
"Authorization:${AUTH_HEADER}",
"X-OpenAPI-Key:${AUTH_HEADER}"
],
"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)
[](https://insiders.vscode.dev/redirect/mcp/install?name=twelvedata&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-twelve-data%22%2C%22-k%22%2C%22YOUR_TWELVE_DATA_API_KEY%22%2C%22-u%22%2C%22YOUR_OPENAI_API_KEY%22%5D%7D)
#### Manual setup
For manual configuration, add to your **User Settings (JSON)**:
```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:
```bash
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:
```bash
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](../../LICENSE) file for details.
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-server-twelve-data",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": "Kopyev Eugene <kopyev.eugene@gmail.com>",
"keywords": "automation, data, llm, mcp, twelve",
"author": "Twelve Data, PBC.",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/23/c9/a5a1b1c78398cb484e314baafc23ecc348977838e0bf62fe50783c51165c/mcp_server_twelve_data-0.1.31.tar.gz",
"platform": null,
"description": "\n# Twelve Data MCP Server\n\n## Overview\n\nThe 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.\n\n> Note: This server is currently in early-stage development; features and tools may evolve alongside updates to the Twelve Data API.\n\n## Obtaining Your API Key\n\nTo use Twelve Data MCP Server, you must first obtain an API key from Twelve Data:\n\n1. Visit [Twelve Data Sign Up](https://twelvedata.com/register?utm_source=github&utm_medium=repository&utm_campaign=mcp_repo).\n2. Create an account or log in if you already have one.\n3. Navigate to your Dashboard and copy your API key.\n\nImportant: Access to specific endpoints or markets may vary depending on your Twelve Data subscription plan.\n\n## U-tool\nu-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.\n\nHow it works:\n\ud83e\udde0 Natural Language Processing: Understands your request in conversational English\n\ud83d\udd0d Smart Routing: Uses vector search to find the most relevant endpoints from Twelve Data's entire API catalog\n\ud83c\udfaf Intelligent Selection: Leverages OpenAI GPT-4o to choose the optimal method and generate correct parameters\n\u26a1 Automatic Execution: Calls the appropriate endpoint and returns formatted results\n\nWhat you can ask:\n\ud83d\udcc8 \"Show me Apple stock performance this week\"\n\ud83d\udcca \"Calculate RSI for Bitcoin with 14-day period\" \n\ud83d\udcb0 \"Get Tesla's financial ratios and balance sheet\"\n\ud83c\udf0d \"Compare EUR/USD exchange rates over 6 months\"\n\ud83c\udfe6 \"Find top-performing tech ETFs\"\n\nSupported data categories:\n- Market data & quotes \u2022 Technical indicators (100+)\n- Fundamental data & financials \u2022 Currencies & crypto\n- Mutual funds & ETFs \u2022 Economic calendars & events\n\nOne tool, entire Twelve Data ecosystem. No API documentation required.\n\n## Installation\n\n### Using **UV** (recommended)\n\nDirectly run without local installation using [`uvx`](https://docs.astral.sh/uv/guides/tools/):\n\n```bash\nuvx mcp-server-twelve-data --help\n```\n\n### Using **pip**\n\nInstall the server via pip:\n\n```bash\npip install mcp-server-twelve-data\npython -m mcp_server_twelve_data --help\n```\n\n## Configuration\n\n### Claude Desktop integration\n\nAdd one of the following snippets to your `claude_desktop_config.json`:\n(1) local stdio server configured with utool\n```json\n{\n \"mcpServers\": {\n \"twelvedata\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-twelve-data@latest\", \"-k\", \"YOUR_TWELVE_DATA_API_KEY\", \"-u\", \"YOUR_OPEN_AI_APIKEY\"]\n }\n }\n}\n```\n\n(2) local stdio server only with 30 the most popular endpoints\n```json\n{\n \"mcpServers\": {\n \"twelvedata\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-server-twelve-data@latest\", \"-k\", \"YOUR_TWELVE_DATA_API_KEY\", \"-n\", \"30\"]\n }\n }\n}\n```\n\n(3) twelve data remote mcp server\n\n```json\n{\n \"mcpServers\": {\n \"twelvedata-remote\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\", \"https://mcp.twelvedata.com/mcp/\",\n \"--header\",\n \"Authorization:${AUTH_HEADER}\",\n \"X-OpenAPI-Key:${AUTH_HEADER}\"\n ],\n \"env\": {\n \"AUTH_HEADER\": \"apikey YOUR_TWELVE_DATA_API_KEY\",\n \"OPENAI_API_KEY\": \"YOUR_OPENAI_API_KEY\"\n }\n }\n }\n}\n```\n\nSee how easy it is to connect Claude Desktop to Twelve Data MCP Server:\n\n\n\n### VS Code integration\n\n#### Automatic setup (with UV)\n\n[](https://insiders.vscode.dev/redirect/mcp/install?name=twelvedata&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22mcp-server-twelve-data%22%2C%22-k%22%2C%22YOUR_TWELVE_DATA_API_KEY%22%2C%22-u%22%2C%22YOUR_OPENAI_API_KEY%22%5D%7D)\n\n#### Manual setup\n\nFor manual configuration, add to your **User Settings (JSON)**:\n\n```json\n{\n \"mcp\": {\n \"servers\": {\n \"twelvedata\": {\n \"command\": \"uvx\",\n \"args\": [\n \"mcp-server-twelve-data\",\n \"-k\", \"YOUR_TWELVE_DATA_API_KEY\",\n \"-u\", \"YOUR_OPENAI_API_KEY\"\n ]\n }\n }\n }\n}\n```\n\n## Debugging\n\nUse the MCP Inspector for troubleshooting:\n\n```bash\nnpx @modelcontextprotocol/inspector uvx mcp-server-twelve-data@latest -k YOUR_TWELVE_DATA_API_KEY\n```\n\n## Development guide\n\n1. **Local testing:** Utilize the MCP Inspector as described in **Debugging**.\n2. **Claude Desktop:**: Update `claude_desktop_config.json` to reference local source paths.\n\n## Docker usage\n\nBuild and run the server using Docker:\n\n```bash\ndocker build -t mcp-server-twelve-data .\n\ndocker run --rm mcp-server-twelve-data \\\n -k YOUR_TWELVE_DATA_API_KEY \\\n -u YOUR_OPENAI_API_KEY \\\n -t streamable-http\n```\n\n## License\n\nThis MCP server is licensed under the MIT License. See the [LICENSE](../../LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Model Context Protocol server providing tools access Twelve Data.",
"version": "0.1.31",
"project_urls": null,
"split_keywords": [
"automation",
" data",
" llm",
" mcp",
" twelve"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ddae01b5d8fa182d0b824b313b0f4dda513e1a68a0cf48e3d77436495ebd97a0",
"md5": "d1e10f716a284eef7b658c1dd24a47d0",
"sha256": "156ed0ba092e52dd647e1458e87fee7fd28bd1a8de42d2578666ddc306581a87"
},
"downloads": -1,
"filename": "mcp_server_twelve_data-0.1.31-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1e10f716a284eef7b658c1dd24a47d0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 2313213,
"upload_time": "2025-07-12T13:37:00",
"upload_time_iso_8601": "2025-07-12T13:37:00.360479Z",
"url": "https://files.pythonhosted.org/packages/dd/ae/01b5d8fa182d0b824b313b0f4dda513e1a68a0cf48e3d77436495ebd97a0/mcp_server_twelve_data-0.1.31-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "23c9a5a1b1c78398cb484e314baafc23ecc348977838e0bf62fe50783c51165c",
"md5": "c1d8756975023572220dae1d45c1e9ac",
"sha256": "6bdf45d40d13d0136a3cd70f956bb70498edfea09437d0b43227a1d40f682207"
},
"downloads": -1,
"filename": "mcp_server_twelve_data-0.1.31.tar.gz",
"has_sig": false,
"md5_digest": "c1d8756975023572220dae1d45c1e9ac",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 6118775,
"upload_time": "2025-07-12T13:37:03",
"upload_time_iso_8601": "2025-07-12T13:37:03.642598Z",
"url": "https://files.pythonhosted.org/packages/23/c9/a5a1b1c78398cb484e314baafc23ecc348977838e0bf62fe50783c51165c/mcp_server_twelve_data-0.1.31.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 13:37:03",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mcp-server-twelve-data"
}
JSON