Twelve Data
Twelve Data MCP (Model Context Protocol) Server provides seamless, real-time access to financial market data via WebSocket, enabling reliable streaming of price quotes, market metrics, and events directly into your applications.
What is Twelve Data?
Twelve Data is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to twelve data mcp (model context protocol) server provides seamless, real-time access to financial market data via websocket, enabling reliable streaming of price quotes, market metrics, and events dire...
Twelve Data MCP (Model Context Protocol) Server provides seamless, real-time access to financial market data via WebSocket, enabling reliable streaming of price quotes, market metrics, and events directly into your applications.
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Twelve Data MCP (Model Context Protocol) Server provides sea
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx twelve-data-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Twelve Data
The Twelve Data MCP Server connects AI assistants to Twelve Data's financial market data API, giving them real-time and historical access to stock quotes, forex rates, cryptocurrency prices, ETFs, mutual funds, 100+ technical indicators, and fundamental financial data. Its primary feature is a U-tool — an AI-powered universal router that uses GPT-4o to translate natural language requests into the correct Twelve Data API endpoint and parameters, making it possible to ask complex market questions in plain English. Traders, analysts, and developers use it to embed live financial intelligence directly into their AI-assisted workflows.
Prerequisites
- Python 3.9 or later with pip or uv installed
- A free or paid Twelve Data API key from twelvedata.com
- An OpenAI API key (required for the U-tool natural language routing feature)
- An MCP-compatible client such as Claude Desktop or VS Code with MCP support
Install the package
Install mcp-server-twelve-data using uv (recommended) or pip.
# Using uv (recommended)
uvx mcp-server-twelve-data --help
# Using pip
pip install mcp-server-twelve-dataObtain your API keys
Sign up at twelvedata.com for a Twelve Data API key. Also obtain an OpenAI API key from platform.openai.com — it is required by the U-tool for natural language parameter generation.
Test the server from the command line
Run the server manually to confirm both API keys are accepted. Replace the placeholders with your real keys.
uvx mcp-server-twelve-data -k YOUR_TWELVE_DATA_API_KEY -u YOUR_OPENAI_API_KEYAdd to your MCP client configuration
Edit your MCP client config file and add the twelve-data entry. Pass your API keys as command-line arguments.
{
"mcpServers": {
"twelvedata": {
"command": "uvx",
"args": [
"mcp-server-twelve-data",
"-k", "YOUR_TWELVE_DATA_API_KEY",
"-u", "YOUR_OPENAI_API_KEY"
]
}
}
}Restart your MCP client and verify
Fully restart the client so it launches the new server. Ask a financial question to confirm the connection to Twelve Data is live.
Twelve Data Examples
Client configuration
Configuration block for Claude Desktop's claude_desktop_config.json using uvx.
{
"mcpServers": {
"twelvedata": {
"command": "uvx",
"args": [
"mcp-server-twelve-data",
"-k", "YOUR_TWELVE_DATA_API_KEY",
"-u", "YOUR_OPENAI_API_KEY"
]
}
}
}Prompts to try
The U-tool routes these natural language queries to the right Twelve Data endpoints automatically.
- "Show me Apple's stock price and 52-week range."
- "Calculate the 14-day RSI for Bitcoin."
- "Get Tesla's revenue growth and price-to-earnings ratio."
- "What are the top-gaining S&P 500 stocks today?"
- "Plot EUR/USD exchange rate over the last 30 days."Troubleshooting Twelve Data
The server starts but returns 'Invalid API key' errors.
Double-check that your Twelve Data API key is correct and has not exceeded its plan's rate limit. Free-tier keys are limited to 8 requests per minute.
The U-tool fails to route requests or returns 'OpenAI error'.
Verify your OpenAI API key is valid and has available credits. The U-tool requires GPT-4o access, so ensure your account has access to that model.
uvx command not found.
Install uv with: curl -LsSf https://astral.sh/uv/install.sh | sh — then restart your terminal. Alternatively use pip install mcp-server-twelve-data and replace 'uvx' with 'python -m mcp_server_twelve_data' in the config.
Frequently Asked Questions about Twelve Data
What is Twelve Data?
Twelve Data is a Model Context Protocol (MCP) server that twelve data mcp (model context protocol) server provides seamless, real-time access to financial market data via websocket, enabling reliable streaming of price quotes, market metrics, and events directly into your applications. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Twelve Data?
Follow the installation instructions on the Twelve Data GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Twelve Data?
Twelve Data works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Twelve Data free to use?
Yes, Twelve Data is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Twelve Data Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Twelve Data? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Twelve Data in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Twelve Data?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.