Twelve Data MCP Server

официальный

Взаимодействуйте с API Twelve Data для получения данных финансовых рынков в реальном времени и за прошлые периоды для ваших AI-агентов.

Документация

Twelve Data MCP Server

Подключите Claude, ChatGPT и других AI-ассистентов к финансовому API Twelve Data — котировки в реальном времени и исторические данные, 60+ технических индикаторов, фундаментальные показатели, отчёты о прибылях, дивиденды, ETF, новости компаний, лидеры рынка и многое другое.

Вам понадобится учётная запись Twelve Data. Зарегистрируйтесь на twelvedata.com.

Есть два способа использования. Большинству пользователей подойдёт облачный сервер (Вариант 1) — ничего устанавливать не нужно.


Вариант 1 — Использовать наш облачный сервер (рекомендуется)

Подключите вашего AI-ассистента к нашему хостируемому серверу:

https://mcp.twelvedata.com/mcp

Вот и всё. Никакой установки, не нужно копировать и вставлять API-ключ. При подключении откроется окно браузера, где вы войдёте в свою учётную запись Twelve Data — ваш персональный API-ключ будет привязан автоматически и останется связанным с вашей учётной записью.

Как добавить

Claude (Desktop / Web) и ChatGPT поддерживают пользовательские коннекторы / MCP-серверы:

  1. Откройте настройки Коннекторов (или Интеграций / MCP-серверов) вашего ассистента.
  2. Добавьте новый коннектор с URL https://mcp.twelvedata.com/mcp.
  3. При появлении запроса нажмите Подключить / Войти — в браузере откроется страница входа Twelve Data.
  4. Авторизуйтесь, и готово. Задавайте вопросы вроде «Какой RSI у AAPL?» или «Покажи последний отчёт о прибылях TSLA».

Точные названия меню различаются в зависимости от приложения и версии, но порядок действий всегда одинаков: добавьте URL, затем войдите через всплывающее окно браузера.


Вариант 2 — Запустить локально со своим API-ключом

Предпочитаете запускать сервер на своей машине (например, для Claude Desktop через stdio)? Вам понадобится только ваш API-ключ Twelve Data — настройка OAuth не требуется.

1. Получите API-ключ

Войдите на twelvedata.com → ваша панель управления → API Keys. Скопируйте ключ.

2. Установка

Требуется Python 3.10+ (рекомендуется 3.12; на macOS brew install [email protected] или make python-install).

make install

3. Добавьте API-ключ

Создайте файл .env в корне проекта с вашим ключом:

TWELVE_DATA_API_KEY=your_api_key_here

4. Подключите к Claude Desktop

Добавьте в ~/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"]
    }
  }
}

Используйте путь .venv/bin/python (не системный Python — в macOS поставляется версия 3.9, а этому серверу нужна 3.10+). После редактирования конфигурации перезапустите Claude Desktop.

Вот и всё — сервер считывает ваш API-ключ из .env, и каждый запрос использует его. Шаг входа не требуется.


Что можно спрашивать

  • Котировки — акции, ETF, форекс, криптовалюты, сырьевые товары (в реальном времени и исторические)
  • Технические индикаторы — RSI, MACD, SMA, BBANDS, ATR и ещё более 60
  • Фундаментальные показатели — финансовая отчётность, прибыли, дивиденды, сплиты, профили компаний, рыночная капитализация, ключевые показатели, календарь IPO
  • Фонды — профили ETF и взаимных фондов, доходность, состав портфеля, риски
  • Новости — новости компаний и пресс-релизы
  • Рыночная аналитика — лидеры роста/падения, курсы валют, рейтинги аналитиков, целевые цены
  • Регуляторная информация — отчётность SEC/EDGAR, инсайдерские сделки, институциональные держатели

Форматы символов: акции AAPL, криптовалюты BTC/USD, форекс EUR/USD.


Партнёрам

Запускаете собственный публичный экземпляр или настраиваете выделенный OAuth-вход? Это партнёрская схема — свяжитесь с нами через twelvedata.com, и мы предоставим руководство по настройке и OAuth-учётные данные.