SEC EDGAR MCP MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Ticker/nom → Résolution CIK ; point final des faits sur l'entreprise
Dépôts : récupération 10-K, 10-Q, 8-K et extraction de sections
Données financières XBRL analysées dans le bilan/compte de résultat/flux de trésorerie
Délits d’initiés – Opérations du formulaire 3/4/5
Chaque réponse cite l'URL de dépôt auprès de la SEC pour vérification

Démo en direct

Aperçu en pratique

sec-edgar-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "sec-edgar-mcp",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
        "stefanoamorelli/sec-edgar-mcp:latest"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "sec-edgar-mcp": {
      "command": {
        "path": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
          "stefanoamorelli/sec-edgar-mcp:latest"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : SEC EDGAR MCP

Faites une lecture rapide de 10 K avec des nombres et des citations exacts

👤 Analystes, investisseurs, journalistes couvrant les entreprises publiques ⏱ ~30 min intermediate

Quand l'utiliser : Vous devez lire un 10-K cet après-midi, pas cette semaine.

Prérequis

SEC_EDGAR_USER_AGENT défini avec votre nom et votre email — SEC nécessite un agent utilisateur joignable pour l'accès par programmation

Déroulement

Résoudre l'entreprise

Recherchez le CIK pour Microsoft.✓ Copié

→ CIK 0000789019 retourné
Tirez le dernier 10-K

Obtenez le dernier 10-K et extrayez la section Facteurs de risque.✓ Copié

→ Section Facteurs de risque renvoyée avec l'URL de dépôt
Tirez les chiffres

Extraire le bilan et le compte de résultat de l’exercice 2025.✓ Copié

→ Nettoyer les lignes avec les valeurs + unités + URL de dépôt

Résultat : Une lecture digeste de 10-K avec des liens vérifiables vers EDGAR.

Pièges

Années fiscales et civiles confuses — Imprimez toujours la période fiscale dans la réponse afin que les utilisateurs puissent vérifier l'intégrité

Combiner avec : yahoo-finance

Suivez les transactions d'initiés pour une liste de surveillance

👤 Les investisseurs suivent le sentiment des initiés ⏱ ~20 min intermediate

Quand l'utiliser : Vous souhaitez un briefing quotidien sur l'activité du Form 4 pour votre liste de surveillance.

Déroulement

Répertoriez les initiés pour chaque ticker

Pour AAPL, MSFT, NVDA : extrayez les transactions du formulaire 4 au cours des 30 derniers jours.✓ Copié

→ Lignes avec nom de l'initié, rôle, achat/vente, actions, prix, date
Agrégat

Résumez les achats nets d’initiés par rapport aux ventes par ticker.✓ Copié

→ Une ligne par ticker avec direction nette

Résultat : Un briefing impeccable sans gratter EDGAR à la main.

Pièges

Comptabiliser les transactions liées aux options comme des « achats » — Filtrer les codes de transaction ; P/S vs A/M/D comptent

Combiner avec : alpaca

Résumez les dépôts 8-K d'aujourd'hui sur une liste de surveillance

👤 Salles de rédaction, équipes de développement d'entreprise, relations avec les investisseurs ⏱ ~10 min beginner

Quand l'utiliser : Quelque chose d’important s’est produit ; vous voulez un résumé rapide en anglais simple.

Déroulement

Tirez les 8-K récents

Extrayez les dépôts 8-K d'aujourd'hui pour les tickers dans ma liste de surveillance.✓ Copié

→ Par dépôt : codes articles + lien
Résumer

Pour chacun, un résumé d'une phrase en anglais simple avec le code de l'article.✓ Copié

→ Résumé clair avec l'URL SEC

Résultat : Un résumé de liste de surveillance auquel vous pouvez faire confiance et à travers lequel vous pouvez créer des liens.

Combiner avec : fetch

Comparez côte à côte les données financières de deux entreprises

👤 Analystes actions, étudiants construisant des modèles ⏱ ~20 min intermediate

Quand l'utiliser : Vous avez besoin d’une comparaison rapide entre pommes et pommes.

Déroulement

Extraire le XBRL des deux sociétés

Obtenez les revenus, le bénéfice brut, le bénéfice d'exploitation, le bénéfice net pour AAPL et MSFT pour l'exercice 2024.✓ Copié

→ Tableau aligné avec les unités et les URL de dépôt
Différer les marges

Calculez et comparez les marges brutes et opérationnelles.✓ Copié

→ Marges côte à côte ; lien vers chaque dossier

Résultat : Une comparaison défendable avec les URL sources exactes.

Combiner avec : antv-chart

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

sec-edgar-mcp + yahoo-finance

Associez les fondamentaux de la SEC aux cotations actuelles du marché

Extrayez le dernier revenu net 10-K de MSFT et la capitalisation boursière actuelle ; calculer les multiples implicites.✓ Copié

sec-edgar-mcp + alpaca

Utiliser les signaux internes comme écran

Pour les tickers avec des achats nets d’initiés au cours des 30 derniers jours, indiquez les prix actuels d’Alpaca.✓ Copié

sec-edgar-mcp + antv-chart

Tracer les numéros XBRL extraits

Tirez 5 ans de revenus et tracez-les avec antv-chart.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
lookup_cik	ticker_or_name: str	Première étape pour toute requête d'entreprise	1 SEC request
get_company_facts	cik: str	Découvrez quels éléments de campagne sont signalés	1 SEC request
get_filings	cik: str, form_type: str, limit?: int	Extraire les dépôts 10-K / 10-Q / 8-K	1 SEC request
extract_section	accession_number: str, section: str	Lire une section spécifique (par exemple, facteurs de risque, rapport de gestion)	1 SEC request
get_financials	cik: str, period: str	États financiers structurés avec unités	1 SEC request
get_insider_transactions	cik: str, days?: int	Activité du formulaire 3/4/5	1 SEC request

Coût et limites

Coût d'exécution

Quota d'API: Limite de débit SEC : ~ 10 requêtes/s par IP – respectez-la
Tokens par appel: Petits pour les métadonnées, les dépôts peuvent être très volumineux (des dizaines de milliers de jetons)
Monétaire: Gratuit — EDGAR est public
Astuce: Utilisez extract_section au lieu de vider l'intégralité du dossier ; les sections du rapport de gestion ou des facteurs de risque suffisent généralement à elles seules.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : SEC_EDGAR_USER_AGENT vous identifie auprès de SEC ; utilisez un vrai nom et une adresse e-mail joignable. Ne confiez pas votre e-mail personnel à une configuration partagée.

Sortie de données : Tous les appels vont à sec.gov. Aucun service tiers dans la configuration par défaut.

Rien de ce qui est renvoyé par ce MCP ne constitue un conseil en investissement. Vérifiez toujours via le dépôt SEC lié avant d’agir.

Dépannage

Erreurs courantes et correctifs

403 de sec.gov

Votre User-Agent est manquant ou mal formé. SEC nécessite le format « Nom ([email protected]) ».

Vérifier : echo $SEC_EDGAR_USER_AGENT

Tarif limité (429)

Reculez à moins de 10 requêtes/s. Lot par CIK plutôt que d’émettre de nombreux appels parallèles.

Vérifier : Inspect headers on the failing response

Concept XBRL introuvable

L'entreprise peut ne pas signaler ce concept. Utilisez get_company_facts pour voir quels concepts existent.

Vérifier : get_company_facts(cik) and grep for the concept

Alternatives

SEC EDGAR MCP vs autres

Alternative	Quand l'utiliser	Compromis
yahoo-finance	Vous voulez des cotations + des fondamentaux de base sans précision au niveau de la SEC	Moins autoritaire; pas de dépôt direct
alpaca	Vous avez besoin de données sur le marché du courtage et du trading	Aucun dépôt ; forme de données différente

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills