io.github.pgeneralpl/edgar-entity-mcp

Est-ce que io.github.pgeneralpl/edgar-entity-mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.pgeneralpl/edgar-entity-mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 10 outils

• compare_companies≈ 378 tokens

  Compare one XBRL concept across ALL reporting companies for a calendar period (SEC frames API), e.g. rank by revenue for CY2024, or compare specific companies. Period: CY2024 (annual duration), CY2024Q2 (quarter), CY2024Q4I (instant, required for balance-sheet items like Assets). Pass companies to filter to specific tickers/CIKs; otherwise returns the top `limit` by value.

  Paramètres, retour & exemple (7)

  Paramètres

  • tag · string · requis
    e.g. 'Revenues', 'NetIncomeLoss', 'Assets'
  • unit · string · optionnel
    USD, USD-per-shares, shares, pure
  • limit · integer · optionnel
  • order · string · optionnel · desc | asc
  • period · string · requis
    CY2024, CY2024Q3, or CY2024Q4I
  • taxonomy · string · optionnel · us-gaap | ifrs-full | dei | srt
  • companies · array · optionnel
    Tickers or CIKs to include (default: all)

  Exemple d'appel

  {"name": "compare_companies", "arguments": {"tag": "texte", "period": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_company_profile≈ 210 tokens

  Company profile from SEC EDGAR submissions: legal name, tickers, exchanges, SIC code + industry, state of incorporation, fiscal year end, EIN, filer category, business/mailing addresses, former names, latest 10-K/10-Q. Use it to orient before deeper research.

  Paramètres, retour & exemple (1)

  Paramètres

  • company · string · requis
    Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure.

  Exemple d'appel

  {"name": "get_company_profile", "arguments": {"company": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_filing_document≈ 381 tokens

  Fetch an SEC filing's primary document (HTML converted to clean text, tables preserved as aligned rows). Identify it by `url` (any www.sec.gov/Archives document URL from list_filings) or by `company` + `accession`. Optionally extract one 10-K/10-Q item via `section` (e.g. '1' Business, '1A' Risk Factors, '7' MD&A, '7A' Market Risk, '8' Financial Statements; for 10-Q: '1' Financial Statements, '2' MD&A, '1A' Risk Factors). Long text is paged: use max_chars and the returned next_offset.

  Paramètres, retour & exemple (6)

  Paramètres

  • url · string · optionnel
    Document URL on www.sec.gov/Archives
  • offset · integer · optionnel
  • company · string · optionnel
    Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure.
  • section · string · optionnel
    Item id to extract, e.g. '1A', '7', 'Item 7A'
  • accession · string · optionnel
    Accession number, e.g. 0000320193-24-000123
  • max_chars · integer · optionnel

  Exemple d'appel

  {"name": "get_filing_document", "arguments": {"url": "texte", "offset": 1, "company": "texte", "section": "texte", "accession": "texte", "max_chars": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_financials≈ 470 tokens

  Key financial metrics normalized from SEC XBRL companyfacts, one row per fiscal period (deduped; as-filed values from the filing that reported the period). Metrics: revenue, gross_profit, operating_income, net_income, eps_basic, eps_diluted, operating_cash_flow, capex, total_assets, total_liabilities, stockholders_equity, cash, long_term_debt, shares_outstanding, free_cash_flow (derived). Revenue tries common tags in order (Revenues, RevenueFromContractWithCustomerExcludingAssessedTax, SalesRevenueNet, ...) and tags_used reports which was used. period_type 'quarterly' returns 3-month values (cash-flow quarters derived from YTD; Q4 derived as FY minus 9M). Values are raw (e.g. 391035000000 = $391.0B).

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Number of most recent periods
  • company · string · requis
    Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure.
  • metrics · array · optionnel
    Subset of metrics to return (default all)
  • period_type · string · optionnel · annual | quarterly

  Exemple d'appel

  {"name": "get_financials", "arguments": {"company": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_insider_trades≈ 436 tokens

  Recent insider transactions for a company (issuer) from SEC Form 4 / 4/A XML: reporter name, role and officer title, transaction date, code with plain-English meaning (P=open-market buy, S=sale, A=grant, M=option exercise, F=tax withholding, G=gift...), shares, price, value, acquired/disposed, shares owned after, direct/indirect, plus a summary of open-market buys vs sales. `limit` counts filings (each filing can hold several transactions).

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Number of most recent Form 4 filings to parse
  • company · string · requis
    Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure.
  • date_to · string · optionnel
    YYYY-MM-DD
  • date_from · string · optionnel
    YYYY-MM-DD
  • include_footnotes · boolean · optionnel
    Include footnote text (10b5-1 plan details, price ranges)
  • transaction_codes · array · optionnel
    Only these codes, e.g. ['P','S'] for open-market trades
  • include_amendments · boolean · optionnel

  Exemple d'appel

  {"name": "get_insider_trades", "arguments": {"company": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_xbrl_concept≈ 407 tokens

  All reported values of one XBRL concept for one company (SEC companyconcept API), newest first, deduped by period. Use for any tag not in get_financials, e.g. us-gaap:ResearchAndDevelopmentExpense, us-gaap:LongTermDebt, dei:EntityCommonStockSharesOutstanding. framed_only=true keeps only SEC's one-fact-per-calendar-period values (cleanest time series).

  Paramètres, retour & exemple (7)

  Paramètres

  • tag · string · requis
    Concept name, case-sensitive, e.g. 'ResearchAndDevelopmentExpense'. 'us-gaap:Tag' form also accepted.
  • unit · string · optionnel
    e.g. USD, shares, USD/shares, pure. Default: USD if present else first unit
  • forms · array · optionnel
    Only facts from these forms, e.g. ['10-K']
  • limit · integer · optionnel
  • company · string · requis
    Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure.
  • taxonomy · string · optionnel · us-gaap | ifrs-full | dei | srt | invest
  • framed_only · boolean · optionnel

  Exemple d'appel

  {"name": "get_xbrl_concept", "arguments": {"tag": "texte", "company": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_filings≈ 419 tokens

  List a company's EDGAR filings newest-first, filtered by form type and filing-date range. Each row has form, accession, filed date, report period, primary document URL and filing index URL. Amendments (e.g. 10-K/A) are included when filtering by the base form unless include_amendments=false. Older history pages are fetched automatically when needed. Common forms: 10-K, 10-Q, 8-K, DEF 14A, S-1, 4, 13D/G (SC 13D), 20-F, 6-K.

  Paramètres, retour & exemple (7)

  Paramètres

  • forms · array · optionnel
    Form types to include, e.g. ['10-K','10-Q']. Omit for all.
  • limit · integer · optionnel
  • offset · integer · optionnel
    Skip this many matching filings (pagination)
  • company · string · requis
    Ticker (AAPL), CIK (320193 or 0000320193), or company name. Names must resolve unambiguously; use search_company first if unsure.
  • date_to · string · optionnel
    Filed on/before (YYYY-MM-DD)
  • date_from · string · optionnel
    Filed on/after (YYYY-MM-DD)
  • include_amendments · boolean · optionnel

  Exemple d'appel

  {"name": "list_filings", "arguments": {"company": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_supported_states≈ 136 tokens

  List the state business-entity registries supported by lookup_business_entity, with dataset ids, coverage caveats, update frequency, and license/commercial-use terms.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_supported_states", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• lookup_business_entity≈ 436 tokens

  Search Secretary of State business-entity registries (official open data) by entity name and/or state entity id. Supported: NY, CO, OR, CT, PA (NY, OR and PA list active entities only; CO and CT include dissolved entities with status). Returns normalized name, entity id, status, type, formation date, jurisdiction, principal/mailing address, registered agent where available, and source URLs. Use for private companies, subsidiaries, LLCs, and verifying legal entity names. Call list_supported_states for coverage and licenses.

  Paramètres, retour & exemple (6)

  Paramètres

  • name · string · optionnel
    Entity name or fragment, e.g. 'Tiffany and Company'
  • limit · integer · optionnel
    Max results per state
  • match · string · optionnel · contains | starts_with | exact
  • states · array · optionnel
    Default: all supported states
  • entity_id · string · optionnel
    State entity id (NY DOS ID, CO entity id, OR registry number, CT account number, PA filing number). Usually combine with a single state.
  • active_only · boolean · optionnel
    Exclude dissolved/inactive entities (CO, CT)

  Exemple d'appel

  {"name": "lookup_business_entity", "arguments": {"name": "texte", "limit": 1, "match": "contains", "states": [], "entity_id": "texte", "active_only": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_company≈ 208 tokens

  Find SEC-registered public companies by ticker or name (fuzzy). Returns CIK (the SEC id used by every other tool), name, tickers, exchange and a match score (100 = exact ticker). Source: SEC company_tickers_exchange.json (companies with a listed ticker).

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
  • query · string · requis
    Ticker or company name, e.g. 'MSFT', 'berkshire', 'Tesla Inc'

  Exemple d'appel

  {"name": "search_company", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://edgar-entity-mcp.vercel.app/mcp