SEC Filing MCP Server

MCP

MCP has 2 components:

1. Server
2. Client

I added a third component: Ingest, where we ingest the data into pinecone

The server is the backbone. It is possible to have it locally hosted for a client such as Claude Desktop, or have it hosted on an ip, so a client like the Streamlit app can work with it.

Both examples are shown here. Instructions on how to run them are below.

Excuse my lack of using proper Software Engineering coding practises and structures. Was on a time crunch

SEC Filings Chatbot

There are 4 folders in this repo

1. ingest
2. data
3. server
4. client

Ingest

This is where the data is ingested into pinecone<br> First we summarize<br> There are two agents, stored in oai_agents.py:

1. Data Summarizer Agent
2. Data Verifier Agent

The Summarizer agent makes a summary of each of the sec filing documents.<br> The Verifier agent verifies the summary.<br> The prompts are stored int prompt.py<br> At the end of this step, which can be run by running python summarizer.py, we have a summary of each of the files for every company.<br> The quaterly file gets 10 bullet points, and the yearly gets 20 bullet points.

Then we ingest. Each file is chunked into 1024 with overlap of 128.<br> The sumamry of each file is added to the respective chunks.<br> Finally all of this is ingested to Pinecone.<br> This can be replicated by running python ingest.py

Data

This is where the SEC filings text files as well as the summary of each file lives

Server

This is the mcp Server.<br> prompt.py has all the prompts.<br> chatbot.py has all the chatbot logic, using OpenAI's responses api with structured outputs.<br> pc.py has all the logic to retrieve the docs from pinecone. It also has reranking, but that needs to be turned on<br> There are two servers:

1. server.py - This is a local server. You can run it on something like Claude Desktop.
2. server_host.py - This is a hosted server. You can run it with the front end client

To run the Claude Desktop server, simply add this json to claude_desktop_config.json

{
  "mcpServers": {
    "sec-filing-server": {
      "command": "/Users/sharhad/.pyenv/shims/python3", # Path to python executable
      "args": ["/Users/sharhad/mcp/server/server.py"] # Absolute path to server.pt
    }
  }
}

Restart Claude, and the tools and reseources should appear

Resources:

1. Greetings resource://greeting
2. List of companies resource://companies

Tools

1. get_sec_files - Takes a compny Ticker and returns the SEC files available for that company
2. query_sec - Takes the users query and answers the question

Client

This is a streamlit client that imulates a server, client relationship.<br> There is a Pydantic AI agent that uses the tools from the mcp server to make it run. Thats in client_runner.py<br> Streamlit app was completely vibecoded. To run the client, first run the server by running python server_host.py in the server folder Then run the client by running streamlit run app.py in the client folder