MCP

🚀 Twelve Data MCP Server

The Twelve Data MCP Server offers seamless integration with the Twelve Data API, enabling users to access financial market data effortlessly. It allows the retrieval of historical time - series, real - time quotes, and instrument metadata for stocks, forex pairs, and cryptocurrencies.

⚠️ Important Note

This server is currently in early - stage development. Features and tools may evolve alongside updates to the Twelve Data API.

🚀 Quick Start

Before using the Twelve Data MCP Server, you need to obtain an API key.

📦 Installation

There are two ways to install the Twelve Data MCP Server:

Using UV (recommended)

You can directly run the server 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

✨ Features

The Twelve Data MCP Server provides several useful tools:

1. time_series Fetch historical price data for a symbol.

   • Inputs:
     • symbol (string): Ticker, e.g. AAPL
     • interval (string): Data interval, e.g. 1min, 1day
     • start_date (string, optional): ISO - 8601 start timestamp
     • end_date (string, optional): ISO - 8601 end timestamp
   • Returns: Array of OHLCV bars.

2. price Get the latest price for a symbol.

   • Inputs:
     • symbol (string)
   • Returns: Latest price quote.

3. stocks List available stock instruments.

   • Inputs:
     • exchange (string, optional): Exchange code to filter by
   • Returns: Array of stock metadata.

4. forex_pairs List available forex pairs.

   • Inputs: none
   • Returns: Array of forex pair metadata.

5. cryptocurrencies List available cryptocurrencies.

   • Inputs: none
   • Returns: Array of cryptocurrency metadata.

📚 Documentation

Obtaining Your API Key

To use the Twelve Data MCP Server, you must first obtain an API key from Twelve Data:

1. Visit Twelve Data Sign Up.
2. Create an account or log in if you already have one.
3. Navigate to your Dashboard and copy your API key.

⚠️ Important Note

Access to specific endpoints or markets may vary depending on your Twelve Data subscription plan.

Configuration

Claude Desktop integration

Add the following snippet to your claude_desktop_config.json:

{
  "mcpServers": {
    "twelvedata": {
      "command": "uvx",
      "args": ["--reinstall", "mcp-server-twelve-data", "--apikey", "YOUR_API_KEY"]
    }
  }
}

Or use the following configuration to connect to the remote http server:

{
  "mcpServers": {
    "twelvedata-remote": {
      "command": "npx",
      "args":    [
        "mcp-remote", "https://mcp.twelvedata.com/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "apikey YOUR_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", "-t", "streamable-http"]
      }
    }
  }
}

Debugging

Use the MCP Inspector for troubleshooting:

npx @modelcontextprotocol/inspector uvx mcp-server-twelve-data

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:

docker build -t mcp-server-twelve-data .
docker run --rm mcp-server-twelve-data --apikey YOUR_API_KEY

📄 License

This MCP server is licensed under the MIT License. See the LICENSE file for details.