Twelve Data

by twelvedata

312 downloads
Not rated
GitHub

About

Interact with [Twelve Data](https://twelvedata.com) APIs to access real-time and historical financial market data for your AI agents.

Details

Author
twelvedata
Downloads
312
Categories
Cloud Service, Finance, API, Other, Developer Tools, Search

- Fetch historical OHLCV time series data.
- Get the latest price quote for any symbol.
- List available stock instruments.
- List available forex pairs.
- List available cryptocurrencies.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Twelve Data
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via uvx (recommended) or pip. Configure with your Twelve Data API key using the --apikey argument, then add the server to your MCP client configuration (e.g., Claude Desktop or VS Code). You can also run the server using Docker.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "twelve data": {
            "twelvedata": {
                "command": "npx",
                "args": [
                    "mcp-remote",
                    "https://mcp.twelvedata.com/mcp/"
                ]
            }
        }
    }
}

McpServers

{
    "twelvedata": {
        "command": "npx",
        "args": [
            "mcp-remote",
            "https://mcp.twelvedata.com/mcp/"
        ]
    }
}

- Get real-time and historical prices— retrieve current or past price data for stocks, ETFs, forex, crypto, and commodities usingget_price.
- Compute technical indicators— request RSI, MACD, SMA, Bollinger Bands, ATR, and 60+ other indicators viaget_technical_indicator.
- Pull company fundamentals— access financial statements, earnings, dividends, splits, market cap, and key stats withget_fundamentals.
- Fetch ETF and mutual fund data— look up fund profiles, performance, holdings, and risk metrics throughget_fund.
- Retrieve company news— get the latest news and press releases for a given symbol usingget_news.
- Access market intelligence— find market movers, exchange rates, analyst ratings, and price targets withget_market_movers.

Connect Claude, ChatGPT, and other AI assistants to theTwelve Datafinancial API — real-time and historical prices, 60+ technical indicators, fundamentals, earnings, dividends, ETFs, company news, market movers, and more.

You need a Twelve Data account. Sign up attwelvedata.com.

There are two ways to use it.Most people should use the cloud server (Option 1)— there is nothing to install.

Option 1 — Use our cloud server (recommended)

Connect your AI assistant to our hosted server:

That's it. No installation, no API key to copy and paste. When you connect, a browser window opens and you log in with your Twelve Data account — your personal API key is linked automatically and stays tied to your account.

Claude (Desktop / Web) and ChatGPTsupport custom connectors / MCP servers:
- Open your assistant'sConnectors(orIntegrations/MCP servers) settings.
- Add a new connector with the URLhttps://mcp.twelvedata.com/mcp.
- When prompted, clickConnect / Log in— a Twelve Data login page opens in your browser.
- Authorize, and you're done. Ask things like"What's the RSI for AAPL?"or"Show me TSLA's latest earnings."

The exact menu names differ between apps and versions, but the flow is always the same: add the URL, then log in via the browser popup.

Option 2 — Run it locally with your API key

Prefer to run the server on your own machine (e.g. for Claude Desktop over stdio)? You only need yourTwelve Data API key— no OAuth setup.

Log in attwelvedata.com→ your dashboard →API Keys. Copy your key.

RequiresPython 3.10+(3.12 recommended; on macOSbrew install python@3.12ormake python-install).

Create a.envfile in the project root with your key:

Add to~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "twelvedata": { "command": "/path/to/twelve-data-mcp/.venv/bin/python", "args": ["/path/to/twelve-data-mcp/src/server.py"] } } }

Use the.venv/bin/pythonpath (not the system Python — macOS ships 3.9, and this server needs 3.10+). Restart Claude Desktop after editing the config.

That's all — the server reads your API key from.envand every request uses it. No login step needed.

- Prices— stocks, ETFs, forex, crypto, commodities (real-time & historical)
- Technical indicators— RSI, MACD, SMA, BBANDS, ATR, and 60+ more
- Fundamentals— financial statements, earnings, dividends, splits, company profiles, market cap, key stats, IPO calendar
- Funds— ETF & mutual fund profiles, performance, holdings, risk
- News— company news & press releases
- Market intelligence— movers, exchange rates, analyst ratings, price targets
- Regulatory— SEC/EDGAR filings, insider transactions, institutional holdings

Symbol formats: stocksAAPL, cryptoBTC/USD, forexEUR/USD.

Running your own public instance or setting up a dedicated OAuth login? That's a partner arrangement — reach out to us attwelvedata.comand we'll provide the setup guide and OAuth credentials.

Access real-time and historical stock market data from the Alpha Vantage API.

Access real-time financial data, including stock prices, forex rates, and cryptocurrencies from Alpha Vantage.

An MCP server for Zuora, powered by the CData JDBC Driver. Requires a separate driver and configuration file for connection.

An MCP server for retrieving financial data using the financialdatasets API.

Provides access to real-time and historical stock data from the Alpha Vantage API.

Real-time financial indicators for AI assistants

Enrich banking data using the Ntropy API.

Access real-time mortgage rate data from the RateSpot.io API.

Provides real-time US stock market data and company financial information using the Alpha Vantage API.

US/HK markets — 110 tools: real-time quotes, options, orders, fundamentals, alerts, DCA & portfolio

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.