Reported issues for sec-edgar-mcp

Pod holds 13 of 13 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to sec-edgar-mcp.

Most discussed

Need to update quick start documentation

Hey Stefano and team, great project!

Just want to call out that the most recent version of Claude Desktop requires the -i flag in order to keeps STDIN open even if not attached (interactive mode). This is essential for MCP servers as they need to receive JSON-RPC messages through standard input.

I used the following config to set up your MCP server in Claude Desktop:

{
  "mcpServers": {
    "sec-edgar-mcp": {
      "command": "docker",
      "args": [
        "run", 
        "--rm", 
  

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/40) · 2025-09-27 · closed · outside contributor · 2 comments

### Unable to access a company's business segment data

The following user request is provided to an LLM agent with the necessary MCP configurtion:

  "Break down Microsoft's revenue for fiscal 2024 by business segment""

The response from the agent after its interaction with locally running sec-edgar-mcp server:

"The revenue breakdown by business segment for Microsoft in fiscal 2024 is not available in the    latest SEC filing. If you have any other questions or need further assistance, feel free to ask! "

Same result seen when ticker and/or year 

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/39) · 2025-09-23 · closed · external user · 2 comments

### Does not support Mac M1 chip? Docker cannot start

```bash
Unable to find image 'stefanoamorelli/sec-edgar-mcp:latest' locally
latest: Pulling from stefanoamorelli/sec-edgar-mcp
3da95a905ed5: Pull complete 
e76888448fef: Pull complete 
29fc64be7341: Pull complete 
0fe95cb712c4: Pull complete 
1c7cd453172f: Pull complete 
3be40aad913a: Pull complete 
c9b9894bd588: Pull complete 
Digest: sha256:f8d84a3121c5af7d1d38cb04d306b5553df5e15a2a2c9b299f5f31e50a48e4a0
Status: Downloaded newer image for stefanoamorelli/sec-edgar-mcp:latest
WARNING: The reque

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/21) · 2025-08-05 · closed · external user · 2 comments

### How to properly integrate with Dify? Container auto-exits and missing service endpoint URL

I'm trying to integrate SEC EDGAR MCP with Dify but encountering two main issues:

1.Container Auto-Exit
When running via Docker (docker run -d --name sec-edgar-mcp-server -e SEC_EDGAR_USER_AGENT="..." stefanoamorelli/sec-edgar-mcp:latest), the container starts but immediately exits with status 0 (clean exit). The logs only show:
                    INFO     Identity of the Edgar REST client set   core.py:182
                             to [jason (lijiajun@frontis.cn)]           
No errors,

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/20) · 2025-07-29 · closed · external user · 4 comments

### Claude app not found

Hi there,

I'm trying to run the app inside and outside of docker, but I get the error "Claude app not found" - I don't see anything in the docs on this, so not sure what I'm doing wrong as I get the impression I should be able to just spin up this image in docker.
I've tried launching it through Claude, but it doesn't work.
I've tried launching it from the command line as stated "docker run -e SEC_EDGAR_USER_AGENT="My Name (my.email@domain.com)" stefanoamorelli/sec-edgar-mcp:latest"

Thanks

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/13) · 2025-06-25 · closed · external user · 6 comments

### How long is the context length obtained for each query? Does it consume a lot of tokens?

Thanks for developing such a great tool, I wonder how tokens are consumed for each query since the project needs to consider the cost of each query when using the API.

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/11) · 2025-06-09 · closed · external user · 5 comments

### Claude app not found

# Claude app not found

I received this message while trying to run the image on docker. 

```pwsh
PS H:\User\sec-edgar-mcp> docker run -e SEC_EDGAR_USER_AGENT="blah blah (blahblah@domain.com)" stefanoamorelli/sec-edgar-mcp:latest
Claude app not found

Does this mean that I will have to install Claude app to test this MCP server? I am trying to test it with Cline.bot.

Read the thread · 2025-05-24 · closed · external user · 2 comments

Rate Limits

Is there any rate limits to using this MCP?

Read the thread · 2025-05-19 · closed · external user · 2 comments

Most recent

analyze_8k: strptime(date_of_report) fails on datetime.date — crashes in v1.0.8, silently nulls the field on main

Summary

analyze_8k mishandles date_of_report, which current edgartools returns as a datetime.date rather than a "%B %d, %Y" string:

v1.0.8 (released / uvx-installed): every analyze_8k call hard-crashes.
main (current): no crash, but date_of_report is always null — the parse fails on the date object and is silently swallowed.

Reproduction (v1.0.8)

analyze_8k(identifier="BW",   accession_number="0001104659-26-082840")
analyze_8k(identifier="INTT", acce

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/160) · 2026-08-10 · open · external user · 0 comments

### Several tools return empty results or raise exceptions (compare_periods, get_company_facts, get_key_metrics, discover_company_metrics, insider Form-4 parsers)

Hi! Thanks for maintaining this server — the core filing/XBRL extraction tools are solid (`get_financials`, `get_filing_content`, `get_filing_sections`, `get_segment_data`, `analyze_8k`, `discover_xbrl_concepts`, `get_xbrl_concepts`, `get_recent_filings`, `get_cik_by_ticker`, `get_company_info`, `get_recommended_tools` all work correctly).

While auditing the full tool surface, I hit several reproducible bugs that I verified across **7 large-cap tickers spanning every sector** to confirm they ar

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/111) · 2026-05-03 · open · external user · 0 comments

### FastMCP misses f-strings

I have found that some of the tool docstrings are missing.

# Reproduction
Since I need an HTTP MCP server, I changed the dockerfile like so:

-CMD ["python", "sec_edgar_mcp/server.py"] +ENV SEC_EDGAR_USER_AGENT=my_address@gmail.com +EXPOSE 8000 +CMD ["python", "sec_edgar_mcp/server.py", "--transport", "streamable-http", "--host", "0.0.0.0", "--port", "8000"]


I then ran:

curl -X POST localhost:8000/mcp
-H "Content-Type: application/json" -H "Accept: application/json, text/even

Read the thread · 2026-04-12 · open · external user · 1 comment

EdgarTools does not recognize count parameter during get_recent_filings call

Repro Steps

Open Claude Desktop, connected to sec-edgar-mcp using Docker
Ask "Please show me all SC TO filings from the last 5 days" or "Please show me all 8K filings recently" (important to not include company or CIK)
Claude errors and you can find the below log

Error From MCP Log

2025-12-22T02:33:36.411Z [sec-edgar-mcp] [info] Message from client: {"method":"tools/call","params":{"name":"get_recent_filings","arguments":{"days":5,"form_type":"SC TO"}},"jsonrpc":"2.0","id":

[Read the thread](https://github.com/stefanoamorelli/sec-edgar-mcp/issues/45) · 2025-12-22 · closed · outside contributor · 1 comment

### Docker instructions

In order to run with docker I found it necessary to use the following in the claude settings.json: 

`docker pull stefanoamorelli/sec-edgar-mcp:latest`

Then add:

    "sec-edgar-mcp": {
        "command": "docker",
        "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "SEC_EDGAR_USER_AGENT=Your Name (name@domain.com)",
            "stefanoamorelli/sec-edgar-mcp:latest"
        ],
        "env": {

Read the thread · 2025-08-27 · closed · outside contributor · 0 comments

The remaining reports are on the project's issue tracker.