Skip to main content
Glama

Server Details

XBRL filings index MCP — wraps the filings.xbrl.org JSON:API index run by

Glama couldn't complete the latest health check. If this server requires authentication, missing or expired test credentials may be the cause. A test profile lets Glama authenticate for health checks and discover tools; it is separate from your personal connections.

If you are the author, claim ownership, then add or update a test profile under Admin → Test Profile.

Status
Unhealthy
Uptime
0.2% over 23 days
Last Tested
Transport
Streamable HTTP
URL
Repository
pipeworx-io/mcp-esef-filings
GitHub Stars
1
Server Listing
esef-filings

TDQS

A3.7/5.0

Scored across 39 tools

Disambiguation2/5

The ask_pipeworx family is a serious overlap problem: ask_pipeworx_beta is explicitly documented as currently identical to ask_pipeworx, and ask_pipeworx_grounded is the same router with an extra extraction pass. The prediction-market cluster (polymarket_edges, polymarket_edge_tracker, polymarket_fill_risk, polymarket_arbitrage, bet_research, polymarket_kalshi_spread, release_calendar_markets) also has several tools with adjacent purposes that can lead an agent to the wrong one.

Naming Consistency3/5

Naming is uniformly snake_case (no camelCase mixing), and the esef_* and polymarket_* families are internally consistent. However, the overall convention is mixed: some tools lead with verbs (ask_pipeworx, scan_dependency, validate_claim, list_subscriptions) while others are noun-led (entity_profile, recent_changes, resolution_audit, release_calendar_markets), so no clear verb_noun pattern governs the set.

Tool Count2/5

At 39 tools this exceeds the 25+ 'too many' threshold and feels bloated for a server nominally about ESEF filings. Several tools are near-duplicates (ask_pipeworx_beta), and others are unrelated to the server's stated domain (generate_llms_txt, scan_dependency, ai_visibility_check), suggesting a kitchen-sink packaging rather than a scoped surface.

Completeness3/5

The ESEF core is reasonably complete: search_filings → entity_filings → filing_facts covers discovery, per-company listing, and data extraction. Subscriptions (subscribe/unsubscribe/list/recent_alerts) and memory (remember/recall/forget) have full lifecycle coverage. However, the sprawling unrelated tools fragment the surface and no coherent overall domain exists to assess against, leaving notable gaps like no direct single-filing fetch outside esef_filing_facts.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 10 tool updates
    • Changedask_pipeworx3 fields changed
      • addedInput schema / properties / ask
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / message
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • changedInput schema / properties / question / description
        Previous value: -"Your question or request in natural language. Accepts query, q, prompt, text, input as aliases."New value: +"Your question or request in natural language. Accepts query, q, prompt, text, input, ask, message as aliases."
    • Changedask_pipeworx_beta3 fields changed
      • addedInput schema / properties / ask
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / message
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • changedInput schema / properties / question / description
        Previous value: -"Your question or request in natural language. Accepts query, q, prompt, text, input as aliases."New value: +"Your question or request in natural language. Accepts query, q, prompt, text, input, ask, message as aliases."
    • Changedask_pipeworx_grounded3 fields changed
      • addedInput schema / properties / ask
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / message
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • changedInput schema / properties / question / description
        Previous value: -"Your question in natural language. Accepts query, q, prompt, text, input as aliases."New value: +"Your question in natural language. Accepts query, q, prompt, text, input, ask, message as aliases."
    • Changeddeep_research8 fields changed
      • addedInput schema / properties / ask
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / input
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / message
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / prompt
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / q
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • addedInput schema / properties / query
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
      • changedInput schema / properties / question / description
        Previous value: -"The research question, in natural language. Broad/multi-part is fine — decomposition is the point."New value: +"The research question, in natural language. Broad/multi-part is fine — decomposition is the point. Accepts query, q, prompt, text, input, ask, message as aliases."
      • addedInput schema / properties / text
        Added value: +{
        +  "description": "Alias for question.",
        +  "type": "string"
        +}
    • Changedesef_entity_filings1 field changed
      • changedInput schema / examples
        Previous value: -[
        -  {
        -    "entity": "Nokia"
        -  },
        -  {
        -    "entity": "549300P8N0P6KDGTJ206"
        -  }
        -]New value: +[
        +  {
        +    "entity": "Nokia"
        +  },
        +  {
        +    "entity": "549300P8N0P6KDGTJ206"
        +  },
        +  {
        +    "entity": "259400A8SZP10GB5IB19"
        +  }
        +]
    • Changedesef_filing_facts2 fields changed
      • changedInput schema / examples
        Previous value: -[
        -  {
        -    "entity": "Citycon",
        -    "year": 2022
        -  },
        -  {
        -    "concept": "ProfitLoss",
        -    "fxo_id": "549300P8N0P6KDGTJ206-2022-12-31-ESEF-FI-0"
        -  },
        -  {
        -    "concept": "Assets",
        -    "entity": "Vodafone",
        -    "limit": 10
        -  }
        -]New value: +[
        +  {
        +    "entity": "Citycon",
        +    "year": 2022
        +  },
        +  {
        +    "concept": "ProfitLoss",
        +    "fxo_id": "549300P8N0P6KDGTJ206-2022-12-31-ESEF-FI-0"
        +  },
        +  {
        +    "concept": "Assets",
        +    "entity": "Vodafone",
        +    "limit": 10
        +  },
        +  {
        +    "concept": "Revenue",
        +    "entity": "Jeronimo Martins",
        +    "limit": 5,
        +    "year": 2025
        +  },
        +  {
        +    "concept": "ProfitLoss",
        +    "fxo_id": "cmvm-1355933",
        +    "limit": 5
        +  }
        +]
      • changedInput schema / properties / fxo_id / description
        Previous value: -"Filing identifier from esef_search_filings or esef_entity_filings, e.g. \"549300P8N0P6KDGTJ206-2022-12-31-ESEF-FI-0\". Most precise way to name a filing."New value: +"Filing identifier from esef_search_filings or esef_entity_filings, e.g. \"549300P8N0P6KDGTJ206-2022-12-31-ESEF-FI-0\", \"cmvm-1355933\" for a Portuguese filing read from CMVM, \"cnmv-20912\" for a Spanish filing read from CNMV, \"newsweb-668785-321602\" for a Norwegian filing read from Oslo Børs NewsWeb, \"fi-61807\" for a Swedish filing read from Finansinspektionen, or \"fsma-5c08f790-404c-4121-bd0b-0cf3350455da\" for a Belgian filing read from FSMA STORI. Most precise way to name a filing."
    • Changedesef_search_filings4 fields changed
      • changedInput schema / examples
        Previous value: -[
        -  {
        -    "country": "FI",
        -    "entity_name": "Citycon"
        -  },
        -  {
        -    "country": "GB",
        -    "limit": 10,
        -    "sort": "period_desc",
        -    "year": 2024
        -  },
        -  {
        -    "limit": 5,
        -    "regime": "UAIFRS",
        -    "year": 2021
        -  }
        -]New value: +[
        +  {
        +    "country": "FI",
        +    "entity_name": "Citycon"
        +  },
        +  {
        +    "country": "GB",
        +    "limit": 10,
        +    "sort": "period_desc",
        +    "year": 2024
        +  },
        +  {
        +    "limit": 5,
        +    "regime": "UAIFRS",
        +    "year": 2021
        +  },
        +  {
        +    "country": "PT",
        +    "limit": 50,
        +    "year": 2025
        +  }
        +]
      • changedInput schema / properties / period_end / description
        Previous value: -"Exact reporting period end date, ISO format, e.g. \"2023-12-31\". Takes precedence over `year`."New value: +"Exact reporting period end date, ISO format, e.g. \"2023-12-31\". Takes precedence over `year` and over `period_end_from`/`period_end_to`."
      • addedInput schema / properties / period_end_from
        Added value: +{
        +  "description": "Only filings whose reporting period end is on or after this ISO date, e.g. \"2024-01-01\". Combine with `period_end_to` for a range; either bound may be used alone. Ignored if `period_end` (exact) is also set; takes precedence over `year`.",
        +  "type": "string"
        +}
      • addedInput schema / properties / period_end_to
        Added value: +{
        +  "description": "Only filings whose reporting period end is on or before this ISO date, e.g. \"2024-12-31\". Combine with `period_end_from` for a range; either bound may be used alone. Ignored if `period_end` (exact) is also set; takes precedence over `year`.",
        +  "type": "string"
        +}
    • Changedforget4 fields changed
      • addedInput schema / properties / k
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
      • changedInput schema / properties / key / description
        Previous value: -"Memory key to delete"New value: +"Memory key to delete. Accepts name, k, label as aliases."
      • addedInput schema / properties / label
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
      • addedInput schema / properties / name
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
    • Changedrecall4 fields changed
      • addedInput schema / properties / k
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
      • changedInput schema / properties / key / description
        Previous value: -"Memory key to retrieve (omit to list all keys)"New value: +"Memory key to retrieve (omit to list all keys). Accepts name, k, label as aliases."
      • addedInput schema / properties / label
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
      • addedInput schema / properties / name
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
    • Changedremember9 fields changed
      • addedInput schema / properties / content
        Added value: +{
        +  "description": "Alias for value.",
        +  "type": "string"
        +}
      • addedInput schema / properties / data
        Added value: +{
        +  "description": "Alias for value.",
        +  "type": "string"
        +}
      • addedInput schema / properties / k
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
      • changedInput schema / properties / key / description
        Previous value: -"Memory key (e.g., \"subject_property\", \"target_ticker\", \"user_preference\")"New value: +"Memory key (e.g., \"subject_property\", \"target_ticker\", \"user_preference\"). Accepts name, k, label as aliases."
      • addedInput schema / properties / label
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
      • addedInput schema / properties / name
        Added value: +{
        +  "description": "Alias for key.",
        +  "type": "string"
        +}
      • addedInput schema / properties / text
        Added value: +{
        +  "description": "Alias for value.",
        +  "type": "string"
        +}
      • addedInput schema / properties / v
        Added value: +{
        +  "description": "Alias for value.",
        +  "type": "string"
        +}
      • changedInput schema / properties / value / description
        Previous value: -"Value to store (any text — findings, addresses, preferences, notes)"New value: +"Value to store (any text — findings, addresses, preferences, notes). Accepts content, text, data, v as aliases; a non-string value is stored as JSON."
  2. 22 tool updates
    • Changedai_visibility_check1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "entity": "Tesla"
        +  }
        +]
    • Changedask_pipeworx_beta1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "question": "What is the current US unemployment rate?"
        +  }
        +]
    • Changedask_pipeworx_grounded1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "question": "What was Apple's fiscal 2023 revenue?"
        +  }
        +]
    • Changedcompany_facts5 fields changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "attribute": "revenue",
        +    "company": "AAPL",
        +    "period": {
        +      "fiscal_year": 2023,
        +      "type": "annual"
        +    }
        +  }
        +]
      • addedInput schema / properties / as_of
        Added value: +{
        +  "description": "Past ISO timestamp with timezone. Replay the latest answer actually recorded by that instant; no invented history or live fallback.",
        +  "type": "string"
        +}
      • addedInput schema / properties / exclude_publishers
        Added value: +{
        +  "description": "Publisher ids forbidden for fact retrieval: sec, fmp, alphavantage. Case and surrounding whitespace are normalized; unknown ids are refused. Excluding sec currently leaves no eligible fact source and returns unavailable/sources_excluded with the selection reasons. Identity and fiscal-calendar lookups may still use SEC; no excluded financial concept is fetched.",
        +  "items": {
        +    "type": "string"
        +  },
        +  "type": "array"
        +}
      • addedInput schema / properties / freshness
        Added value: +{
        +  "description": "cached (default) permits an eligible stored answer; fresh requires an upstream refresh and never silently falls back to stale data.",
        +  "enum": [
        +    "cached",
        +    "fresh"
        +  ],
        +  "type": "string"
        +}
      • addedInput schema / properties / max_age
        Added value: +{
        +  "description": "Maximum age in seconds of the upstream publication, not our fetch. Older or undated facts are withheld.",
        +  "maximum": 3155760000,
        +  "minimum": 0,
        +  "type": "number"
        +}
    • Changedcompare_entities1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "type": "company",
        +    "values": [
        +      "AAPL",
        +      "MSFT"
        +    ]
        +  }
        +]
    • Changeddeep_research1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "depth": "quick",
        +    "question": "What is the current US unemployment rate and how has it changed over the past year?"
        +  }
        +]
    • Changedentity_profile1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "type": "company",
        +    "value": "AAPL"
        +  }
        +]
    • Changedgenerate_llms_txt1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "url": "https://pipeworx.io"
        +  }
        +]
    • Changedpipeworx_feedback1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "message": "Fleet #2184 smoke test: verifying pipeworx_feedback example call returns non-empty.",
        +    "type": "other"
        +  }
        +]
    • Changedpipeworx_trending1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "window": "7d"
        +  }
        +]
    • Changedpolymarket_arbitrage1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "topic": "Fed rate decision"
        +  }
        +]
    • Changedpolymarket_edge_tracker1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "days": 14,
        +    "window": "1wk"
        +  }
        +]
    • Changedpolymarket_edges3 fields changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "limit": 5,
        +    "window": "1wk"
        +  }
        +]
      • changedInput schema / properties / min_edge_pp / description
        Previous value: -"Minimum |edge| in percentage points to include (default 0.5). Edge is evaluated NET of slippage."New value: +"Minimum |edge| in percentage points to include (default 0.5). Edge is evaluated NET of slippage and Polymarket's own taker fee."
      • changedInput schema / properties / slippage_pp / description
        Previous value: -"Assumed execution slippage in percentage points per leg (default 0.3). Subtracted from raw |edge| before ranking and Kelly sizing. Polymarket has zero trading fees as of 2024 but bid/ask + thin depth typically eats 20-50bp per trade. Bump for very thin partitions; drop to 0 if you have a smarter fill model."New value: +"Assumed execution slippage in percentage points per leg (default 0.3), for bid/ask + thin depth cost that a last-trade price does not show. Subtracted from raw |edge| before ranking and Kelly sizing, ON TOP OF Polymarket's own taker fee — which is NOT zero (rate 0.04-0.07 depending on category, read off each market's own published fee schedule; see fees_pp_applied on every row and fees.ts for the full schedule). Bump slippage for very thin partitions; drop to 0 if you have a smarter fill model — the fee still applies regardless."
    • Changedpolymarket_fill_risk1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "market": "will-the-fed-increase-interest-rates-by-25-bps-after-the-december-2026-meeting-20260729232808636",
        +    "side": "buy_yes",
        +    "size_usd": 1000
        +  }
        +]
    • Changedrecent_changes1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "since": "30d",
        +    "type": "company",
        +    "value": "AAPL"
        +  }
        +]
    • Changedremember1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "key": "target_ticker",
        +    "value": "AAPL"
        +  }
        +]
    • Changedresolve_entity1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "type": "company",
        +    "value": "AAPL"
        +  }
        +]
    • Changedscan_competitor_ai_presence1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "entities": [
        +      "Pipeworx",
        +      "Zapier"
        +    ]
        +  }
        +]
    • Changedscan_dependency1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "package": "left-pad"
        +  }
        +]
    • Changedsearch_within1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "query": "supply-chain risk",
        +    "text": "Apple Inc. reported fiscal 2023 revenue of $383.285 billion, driven by strong iPhone and Services growth. Net income was $96.995 billion. The company faced supply-chain risk in China during the quarter."
        +  }
        +]
    • Changedsuggest_questions1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "topic": "finance"
        +  }
        +]
    • Changedvalidate_claim1 field changed
      • addedInput schema / examples
        Added value: +[
        +  {
        +    "claim": "Apple's fiscal 2023 revenue was $383 billion"
        +  }
        +]
  3. 39 tool updates
    • First observedai_visibility_check
    • First observedask_pipeworx
    • First observedask_pipeworx_beta
    • First observedask_pipeworx_grounded
    • First observedbet_research
    • First observedcompany_facts
    • First observedcompare_entities
    • First observeddeep_research
    • First observeddiscover_tools
    • First observedentity_profile
    • First observedesef_entity_filings
    • First observedesef_filing_facts
    • First observedesef_search_filings
    • First observedforget
    • First observedgenerate_llms_txt
    • First observedkalshi_weather_edge
    • First observedlist_subscriptions
    • First observedpipeworx_feedback
    • First observedpipeworx_trending
    • First observedpolymarket_arbitrage
    • First observedpolymarket_edge_tracker
    • First observedpolymarket_edges
    • First observedpolymarket_fill_risk
    • First observedpolymarket_kalshi_spread
    • First observedrecall
    • First observedrecent_alerts
    • First observedrecent_changes
    • First observedrelease_calendar_markets
    • First observedremember
    • First observedresolution_audit
    • First observedresolution_diff
    • First observedresolve_entity
    • First observedscan_competitor_ai_presence
    • First observedscan_dependency
    • First observedsearch_within
    • First observedsubscribe
    • First observedsuggest_questions
    • First observedunsubscribe
    • First observedvalidate_claim

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides structured US SEC/EDGAR filing data, including filings index, XBRL-derived earnings, and Form 4 insider transactions, as clean JSON via MCP. Supports x402 payments (USDC on Base) and Stripe subscription for access.
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables querying FDIC-insured institutions, their Call Report financials, peer comparisons, failure records, and deposit market share via MCP, over stdio or Streamable HTTP.
    391 npm
    1
    Apache 2.0
  • A
    license
    A
    quality
    B
    maintenance
    An MCP server that wraps SEC EDGAR APIs to provide company financial data, screening metrics, and disclosure signals for investment diligence, with every figure traced to its source filing.
    8
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.