Twelve Data MCP Server

officiel

Interagissez avec les API Twelve Data pour accéder aux données en temps réel et historiques des marchés financiers pour vos agents IA.

Documentation

Serveur MCP Twelve Data

Connectez Claude, ChatGPT et d'autres assistants IA à l'API financière Twelve Data — prix en temps réel et historiques, plus de 60 indicateurs techniques, fondamentaux, bénéfices, dividendes, ETF, actualités des entreprises, valeurs en mouvement, et bien plus.

Vous avez besoin d'un compte Twelve Data. Inscrivez-vous sur twelvedata.com.

Il existe deux façons de l'utiliser. La plupart des gens devraient utiliser le serveur cloud (Option 1) — il n'y a rien à installer.


Option 1 — Utiliser notre serveur cloud (recommandé)

Connectez votre assistant IA à notre serveur hébergé :

https://mcp.twelvedata.com/mcp

C'est tout. Pas d'installation, pas de clé API à copier-coller. Lorsque vous vous connectez, une fenêtre de navigateur s'ouvre et vous vous connectez avec votre compte Twelve Data — votre clé API personnelle est liée automatiquement et reste attachée à votre compte.

Comment l'ajouter

Claude (Desktop / Web) et ChatGPT prennent en charge les connecteurs personnalisés / serveurs MCP :

  1. Ouvrez les paramètres Connecteurs (ou Intégrations / Serveurs MCP) de votre assistant.
  2. Ajoutez un nouveau connecteur avec l'URL https://mcp.twelvedata.com/mcp.
  3. Lorsque vous y êtes invité, cliquez sur Connecter / Se connecter — une page de connexion Twelve Data s'ouvre dans votre navigateur.
  4. Autorisez, et c'est terminé. Posez des questions comme "Quel est le RSI pour AAPL ?" ou "Montre-moi les derniers bénéfices de TSLA."

Les noms exacts des menus diffèrent selon les applications et les versions, mais le flux est toujours le même : ajoutez l'URL, puis connectez-vous via la fenêtre contextuelle du navigateur.


Option 2 — L'exécuter localement avec votre clé API

Vous préférez exécuter le serveur sur votre propre machine (par exemple pour Claude Desktop via stdio) ? Vous avez seulement besoin de votre clé API Twelve Data — pas de configuration OAuth.

1. Obtenez votre clé API

Connectez-vous sur twelvedata.com → votre tableau de bord → Clés API. Copiez votre clé.

2. Installation

Nécessite Python 3.10+ (3.12 recommandé ; sur macOS brew install [email protected] ou make python-install).

make install

3. Ajoutez votre clé API

Créez un fichier .env à la racine du projet avec votre clé :

TWELVE_DATA_API_KEY=your_api_key_here

4. Connectez-vous à Claude Desktop

Ajoutez à ~/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"]
    }
  }
}

Utilisez le chemin .venv/bin/python (pas le Python système — macOS est livré avec la version 3.9, et ce serveur nécessite la version 3.10+). Redémarrez Claude Desktop après avoir modifié la configuration.

C'est tout — le serveur lit votre clé API depuis .env et chaque requête l'utilise. Aucune étape de connexion nécessaire.


Ce que vous pouvez demander

  • Prix — actions, ETF, forex, crypto, matières premières (temps réel et historiques)
  • Indicateurs techniques — RSI, MACD, SMA, BBANDS, ATR, et plus de 60 autres
  • Fondamentaux — états financiers, bénéfices, dividendes, fractionnements, profils d'entreprise, capitalisation boursière, statistiques clés, calendrier des introductions en bourse
  • Fonds — profils d'ETF et de fonds communs de placement, performance, participations, risque
  • Actualités — actualités des entreprises et communiqués de presse
  • Intelligence de marché — valeurs en mouvement, taux de change, notations des analystes, objectifs de prix
  • Réglementaire — dépôts SEC/EDGAR, transactions d'initiés, participations institutionnelles

Formats des symboles : actions AAPL, crypto BTC/USD, forex EUR/USD.


Partenaires

Vous gérez votre propre instance publique ou mettez en place une connexion OAuth dédiée ? C'est un accord de partenariat — contactez-nous sur twelvedata.com et nous vous fournirons le guide de configuration et les identifiants OAuth.