Connectez votre IA à 33 000+ déclarations multi-marchés
Notre serveur MCP (Model Context Protocol) donne à Claude, Cursor, VS Code, Windsurf et à tout agent IA compatible l'accès temps réel aux signaux d'initiés, fondamentaux Yahoo, backtests historiques et déclarations sur 28 régulateurs (AMF, SEC, BaFin, SIX SER, RNS, SEDI, Consob, CNMV, AFM, FSMA, Oslo, Helsinki, Stockholm, Copenhagen, ASX, FMA, Dublin). Zéro setup local : une URL, une clé, c'est en ligne.
MCP (Model Context Protocol)est le standard ouvert publié par Anthropic en 2024 pour connecter des agents IA à des sources de données externes. Pensez USB-C : votre IA se branche une fois sur le serveur et accède à tout ce qu'il expose, sans glue code.
Sur Insiders Trades Sigma, le serveur MCP convertit nos 14 endpoints REST en 29 outils richement documentés (avec schémas JSON Schema), optimisés pour la consommation par un LLM :
Descriptions en français qui expliquent précisément quand appeler chaque outil.
Schémas d'entrée stricts (type + contraintes min/max) pour que le modèle ne passe jamais de paramètres invalides.
Outils composites qui combinent plusieurs endpoints en un appel (ex : get_company_full_profile renvoie identité + derniers trades + stats backtest d'un seul coup).
Métadonnées temporelles sur chaque réponse (latencyMs, generatedAt) pour que l'agent raisonne sur la fraîcheur.
Tout ce que fait l'API REST (voir docs) est aussi exposé en MCP. Mais en plus, vous y gagnez 6 outils composites qui enchaînent plusieurs requêtes, optimisés pour les prompts vagues du style« donne-moi tout sur LVMH ».
Architecture
Flux de communication
Le serveur tourne à POST https://insiders-trades.com/api/mcp. Transport HTTP classique (pas de stdio), enveloppe JSON-RPC 2.0, CORS ouvert (Access-Control-Allow-Origin: *).
Côté client, rien à coder : Claude Desktop / Cursor / Windsurf / VS Code (+ extension Continue) gèrent nativement JSON-RPC MCP. Il suffit d'ajouter l'URL à leur fichier de config.
JSON-RPC 2.0
Enveloppe de protocole
Méthodes supportées
Méthode
Type
Auth requise
Description
initialize
request
non
Handshake initial · échange des versions de protocole et capacités
initialized
notification
non
Confirmation client (aucune réponse, HTTP 204)
tools/list
request
oui
Retourne le catalogue d'outils avec leur inputSchema JSON Schema
tools/call
request
oui
Exécute un outil et retourne le résultat dans content[0].text
resources/list
request
oui
Liste les resources statiques (strategy://, markets://, audits://, glossary://)
resources/templates/list
request
oui
Templates URI (audits://{slug})
resources/read
request
oui
Lit le contenu d'une resource par URI
prompts/list
request
oui
Liste les prompts MCP (templates LLM reutilisables)
prompts/get
request
oui
Resout un prompt en messages avec arguments interpoles
Le résultat est une chaîne JSON dans content[0].text(convention MCP, les modèles parsent nativement le texte). L'objet parsé contient toujours un champ meta avec la latence.
Sécurité
Authentification
Chaque appel tools/list et tools/call doit inclure votre clé API Insiders Trades. Trois formats acceptés, par ordre de priorité :
Authorization: Bearer <key> · préféré, supporté par les clients MCP modernes (Claude Desktop ≥ 3.7, Cursor, Windsurf).
X-Api-Key: <key> · alternative header.
?apiKey=<key> · dans l'URL (fallback pour clients MCP simples qui ne supportent pas les headers, rare).
Ne partagez jamais votre clé en clair dans une config versionée.Utilisez les variables d'environnement ou un gestionnaire de secrets. La plupart des clients MCP acceptent l'injection via ${{env:VAR}}.
Pour générer une clé, rendez-vous sur /account/api-keys (5 secondes). La clé s'affiche une seule fois, copiez-la immédiatement. Elle partage le même quota que l'API REST (5 000 requêtes/jour en beta).
Catalogue
29 outils disponibles
Groupés en 4 familles selon leur usage. Chaque outil retourne un JSON auto-suffisant avec des métadonnées de latence.
Discovery
8 outils · retournent des listes
Votre premier point d'entrée. Utilisés par l'IA quand l'utilisateur formule une question floue ('y a-t-il des mouvements chez LVMH ?').
search_companiesrequires: query
Recherche fuzzy de sociétés cotées françaises par nom, ticker Yahoo, ou ISIN. Retourne nom, slug, ISIN, marché, capitalisation, cours, nombre de déclarations.
search_insidersrequires: query
Recherche fuzzy de dirigeants (PDG, CFO, administrateurs) par nom. Retourne nom, slug, nb de déclarations, nb de sociétés liées.
search_declarations
Recherche avancée de déclarations d'initiés sur 28 régulateurs (AMF, SEC Form 4, BaFin, SIX SER, RNS, SEDI, Consob, CNMV, AFM, FSMA, Oslo Børs, Nasdaq Helsinki, Nasdaq Stockholm, Nasdaq Copenhagen, ASX, FMA, Euronext Dublin) avec 12 filtres combinables: période, score min/max, direction (BUY/SELL), cluster, montant, société, dirigeant, ISIN, marché, tri.
search_globalrequires: query
Recherche cross-entités en un seul appel : sociétés + dirigeants en même temps. Utile quand la requête utilisateur est ambiguë.
search_top_signals
Top signaux scorés (BUY ou SELL) sur une fenêtre glissante. Filtré par défaut sur l'univers EU strict (8 places: XPAR, XAMS, XWBO, XBRU, XHEL, XOSL, XSTO, XETR) conformément à V14e. Passer marketUniverse='all' pour interroger les 28 marchés (hors univers validé). La sortie canonique pour répondre à 'Quelles sont les meilleures opportunités en ce moment ?'
get_winning_strategy_signals
★ STRATÉGIE SIGMA + V14e EU stack · OOS strict 2025-01-01 to 2026-05-21 (14 buckets) : Sharpe annualisé 1.36 (CI95 [-0.46, +4.20]), CAGR +38.5 % NET, max-DD -10.6 %, hits 55.0 %. Sharpe déflaté Bailey-Lopez de Prado +0.43. Univers EU restreint (8 places). Cohorte in-sample Sigma v1.0 (n=196) : win rate 77 %, rendement T+90 +13.2 %, Sharpe cross-sectional 1.87 (dispersion trades, PAS Sharpe portefeuille). 6 filtres : cluster, mid-cap 200M-1B€, PDG/CFO/directeur, déclaration ≤ 7j après transaction, acquisition pure, score V14e ≥ 40. Horizon de détention conseillé : T+90 jours (fenêtre de sortie idéale T+270). Point d'entrée quand l'utilisateur demande 'quelles actions acheter' ou 'que faire avec mon capital'.
search_blog_articles
Recherche full-text dans les articles de blog publies (FR + EN). Filtre par categorie (regulation, methodology, market-deep-dive, etc.) et locale.
get_top_insiders
Classement des dirigeants les plus actifs ou avec le meilleur score moyen sur une fenetre. Tri par count, avgScore ou maxScore.
Enrichment
6 outils · une entité, données complètes
Approfondissent une entité identifiée. Typiquement appelés après un outil Discovery (slug → get_company).
get_companyrequires: slug
Fiche complète d'une société : identité, fondamentaux Yahoo (P/E, ROE, D/E), consensus analystes (reco, target), technicals (52-week, 50/200 DMA, dividend yield), dernière date de fraîcheur par bloc.
get_company_declarationsrequires: slug
Historique complet des déclarations d'initiés multi-marchés (AMF, SEC, BaFin, SIX SER, RNS, SEDI, Consob, CNMV, AFM, FSMA, Oslo, Helsinki, Stockholm, Copenhagen, ASX, FMA, Dublin) d'une société, triées par date desc.
get_insiderrequires: slug
Profil complet d'un dirigeant : sociétés auxquelles il/elle est rattaché(e) avec sa fonction, scores moyen/max historiques, genre inféré.
get_insider_declarationsrequires: slug
Historique de toutes les transactions d'un dirigeant, toutes sociétés confondues.
get_declarationrequires: amfId
Détail d'une déclaration unique par amfId, avec son backtest complet (retours T+30/60/90/160/365/730) si calculé.
explain_signal_scorerequires: amfId
Decomposition du signalScore d'une declaration : valeurs des sous-composants utilises par V14e (cluster, role, marketCap bucket, pubDelay, acquisition). Reponse formattee pour explication LLM.
System
9 outils · état plateforme + audits + glossaire
Santé, fraîcheur, stats globales, usage de la clé courante. L'IA les utilise quand on lui demande 'les données sont-elles à jour ?' ou 'combien me reste-t-il de crédits ?'
get_site_stats
Compteurs globaux : nb déclarations (total, 24h, 7j, 30j), nb sociétés, nb dirigeants, nb backtests, score moyen.
get_system_health
État de la base : reachability, latence DB, horodatage de chaque étape de la pipeline (dernière publication d'initié multi-marchés, dernier scoring, dernier backtest, dernier enrich Yahoo).
get_backtest_stats
Statistiques backtest agrégées : retours moyens T+30/60/90/160/365/730, win rate à T+90 pour BUY et SELL. Filtrable par direction, score min, période.
get_account_usage
Usage de la clé API utilisée pour cet appel : nb requêtes totales, aujourd'hui, date de création, dernier appel.
get_strategy_proof
Live STRATEGY_PROOF stats : 4 ans yearly returns, Sharpe (cross-sectional + annualized + deflated Bailey-Lopez de Prado), win rate avec IC95 Wilson, max drawdown, taille univers vs sous-ensemble filtré. Equivalent du resource strategy://proof mais accessible aux clients qui ne consomment que tools/call.
get_market_overview
Statistiques agrégées par marché (MIC) : nombre de sociétés couvertes, nombre de déclarations 30j, score moyen, top secteurs. Filtrable par MIC unique ou tous marchés.
list_audits
Index des audits methodologiques (docs/method-review/*.md). Retourne slug + titre + numero. Utilisez get_audit pour recuperer le contenu d'un document.
get_auditrequires: slug
Recupere le contenu integral d'un audit methodologique (markdown ou JSON). Le slug est le basename du fichier sans extension (ex: '88-v13.5-prod-audit-2026-05-20').
get_glossary
Glossaire bilingue FR + EN. Retourne toutes les entrees avec definition, formule, exemple, sources. Filtrable par slug pour recuperer une entree unique.
Composite
6 outils · cross-sources en 1 appel
Optimisés pour les prompts vagues ou les analyses multi-étapes. Chaque outil compose 3 à 6 requêtes internes et renvoie un JSON agrégé.
get_company_full_profilerequires: slug
PROFIL 360° d'une société en 1 appel : identité + fondamentaux + 10 dernières déclarations + scores agrégés + stats backtest. Utilisé pour 'donne-moi tout sur X'.
get_insider_activity_summaryrequires: slug
Résumé d'activité d'un dirigeant : toutes ses sociétés (avec fonction occupée), total achats/ventes, montant cumulé, score moyen, dernière transaction.
compare_companiesrequires: slugs
Comparaison côte-à-côte de 2 à 5 sociétés sur : capitalisation, P/E, consensus analyste, activité insider (derniers 90j), score moyen. Utilisé pour 'LVMH vs Hermès'.
find_clustered_trades
Trouve les sociétés où ≥ 2 dirigeants ont tradé dans une fenêtre ±30 jours (cluster). Signal fort en analyse insider trading.
analyze_declarationrequires: amfId
Analyse contextualisée d'une déclaration : détail + backtest + 5 autres trades récents sur la même société + fondamentaux actuels + cluster status.
watch_isinsrequires: isins
Surveillance d'un portefeuille : pour une liste d'ISINs, retourne toute l'activite insider des N derniers jours, triee par fraicheur et score.
Setup
Guide d'installation
5 minutes, 3 étapes, aucun code :
ÉTAPE 1
Copiez l'URL MCP
Ci-dessous
ÉTAPE 2
Générez une clé API
/account/api-keys
ÉTAPE 3
Collez dans votre IA
Claude, Cursor, …
L'URL à copier
URL du serveur MCP
https://insiders-trades.com/api/mcp
Tutoriel par client
Claude Desktop
NATIF MCP
Application desktop Anthropic (Mac & Windows) · support MCP natif depuis Claude 3.7+. La version web ne le supporte pas.
Une fois le serveur configuré, posez cette question à votre IA :
« Quels outils MCP Insiders Trades as-tu ? Liste-les avec leur rôle. »
L'IA doit lister 29 outilsgroupés en 4 familles (Discovery, Enrichment, System, Composite). Si ce n'est pas le cas :
Vérifiez que le serveur MCP est bien activé dans les settings du client.
Relancez complètement l'application (pas juste un reload fenêtre).
Vérifiez la clé API : curl https://insiders-trades.com/api/mcp doit renvoyer un JSON d'accueil ; ajouter l'auth et appeler tools/list doit renvoyer le catalogue.
Consultez les logs du client IA (Claude Desktop les expose via View logs).
Prompts d'exemple qui déclenchent des outils
Prompt
Outil attendu
"Donne-moi les 5 meilleurs signaux d'achat du mois"
search_top_signals
"C'est quoi LVMH ? Montre les fondamentaux"
get_company_full_profile
"Compare Bouygues et Vinci côté insider activity"
compare_companies
"Quelles sociétés ont plusieurs dirigeants qui achètent ces 30 derniers jours ?"
find_clustered_trades
"J'ai ces ISINs dans mon portefeuille : FR0000121014, FR0000120271… quelles alertes ?"
watch_isins
"Le système est-il à jour ? Quand le dernier cron ?"
get_system_health
Codes d'erreur
JSON-RPC error codes
Code
Nom
Cause
-32700
Parse error
Corps de la requête non parseable en JSON
-32600
Invalid Request
Enveloppe JSON-RPC invalide (manque jsonrpc ou method)
-32601
Method not found
Méthode MCP inconnue (autre que initialize, tools/list, tools/call, ping)
-32602
Invalid params
Paramètre manquant ou nom d'outil inconnu
-32603
Internal error
Erreur interne serveur (à reporter)
-32000
Unauthorized
Clé API manquante, invalide ou révoquée (spécifique à notre implémentation)
Questions
FAQ
C'est quoi exactement le MCP ?
MCP (Model Context Protocol) est le standard ouvert lancé par Anthropic en 2024 pour connecter les IA à des sources de données externes. Comme un port USB-C universel : votre IA s'y branche une fois et accède à tout ce que le serveur expose. Notre serveur expose 29 outils de lecture sur la BDD Insiders Trades.
Ai-je besoin d'une clé API Insiders Trades ?
Oui. Contrairement à la documentation Swagger que nous publions aussi librement, le MCP consomme votre quota. Générez une clé depuis /account/api-keys (gratuit en beta, 5 000 requêtes/jour).
Quels clients sont compatibles ?
Claude Desktop ≥ 3.7 (natif), Cursor (natif), Windsurf (natif), VS Code via Continue, et tout framework agentique Python/JS supportant MCP (LangChain, LlamaIndex). ChatGPT n'a pas encore de support MCP natif. Utilisez notre API REST via Custom GPT Actions.
Les données sont-elles à jour en temps réel ?
Chaque appel MCP interroge la BDD Postgres en direct. Les déclarations d'initiés (AMF, SEC, BaFin, SIX, RNS, SEDI, Consob, CNMV, AFM, FSMA, Oslo, Helsinki, Stockholm, Copenhagen, ASX, FMA, Dublin) sont synchronisées toutes les heures (cron horaire), les fondamentaux Yahoo tous les jours à 04:00 UTC. Appelez get_system_health pour voir la fraîcheur exacte à l'instant T.
Y a-t-il un risque de fuite de données sensibles ?
Non. Tous les outils sont strictement READ-ONLY sur la BDD Postgres. Aucune action d'écriture n'est possible via MCP. De plus, les données elles-mêmes sont publiques (règlement MAR 596/2014 pour l'UE, équivalents SEC/Form 4 aux US).
Mon IA appelle-t-elle tous les outils sur chaque question ?
Non. Les LLMs modernes (Claude 3.5 Sonnet+, GPT-4o…) sont bons en tool-routing : ils ne sollicitent que les outils pertinents. En pratique on observe 1-4 appels par conversation. Chaque appel compte dans votre quota journalier.
Puis-je self-host le serveur ?
Le code source du serveur MCP (/api/mcp + src/lib/mcp/) est dans le même repo Next.js que le site. Si vous déployez votre propre instance, la connexion à la BDD Postgres reste nécessaire · la valeur du service vient des données, pas du code du serveur MCP.
CORS & navigateur : puis-je appeler depuis un JS front ?
Oui techniquement · le serveur émet Access-Control-Allow-Origin: *. Mais cela exposerait votre clé API dans le bundle JS. À réserver aux environnements trusted (agent backend) ou passer par un proxy.
Quel est le coût par appel ?
0 € en beta. Chaque appel tools/call consomme 1 requête de votre quota journalier (5 000/jour). Les méthodes initialize et ping sont gratuites et ne comptent pas.
Branchez votre IA en 5 minutes
Une URL, une clé, c'est en ligne. Votre agent IA préféré accède instantanément aux 33 000+ déclarations multi-marchés, signaux scorés et backtests.