SEC Filings and Earnings Call

by athe-kunal

Not rated
GitHub

Description

The MCP server provides end-to-end workflows for SEC filings and earnings call transcripts—including ticker resolution, document retrieval, OCR, embedding, on-disk resource discovery, and semantic search—exposed via MCP and powered by the same olmOCR and embedding backends as…

About

The MCP server provides end-to-end workflows for SEC filings and earnings call transcripts—including ticker resolution, document retrieval, OCR, embedding, on-disk resource discovery, and semantic search—exposed via MCP and powered by the same olmOCR and embedding backends as the vLLM backends.

Details

Author
athe-kunal
Categories
Search, Other, Knowledge Base

Setup

Install SEC Filings and Earnings Call in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/athe-kunal/sec-filings-data

Follow the installation instructions in the repository README, then restart your MCP client.

The MCP server provides end-to-end workflows for SEC filings and earnings call transcripts—including ticker resolution, document retrieval, OCR, embedding, on-disk resource discovery, and semantic search—exposed via MCP and powered by the same olmOCR and embedding backends as the vLLM backends.

A Python-first toolkit for SEC filing ingestion, OCR-to-Markdown conversion, transcript collection, and retrieval acrosshybrid retrieval(dense + BM25) with reranking.

- Downloads SEC filings and stores filing metadata.
- Converts filing PDFs to Markdown via olmOCR.
- Chunks and indexes filings/transcripts in Chroma.
- Supports:

- Hybrid search(dense + BM25 reciprocal-rank-fusion + reranker).

- FastAPI (server.py).
- MCP server (mcp_server.py).

- finance_data/filings/: SEC download + helpers.
- finance_data/ocr/: olmOCR pipeline.
- finance_data/dataloader/: chunking, Chroma indexing, semantic + BM25 retrieval.
- finance_data/earnings_transcripts/: transcript fetch + persistence.
- finance_data/server_api/: API request/response models + batch helpers.
- server.py: FastAPI app.
- mcp_server.py: MCP entrypoint.
- docs/: setup and operations docs.

Use.envor environment variables. Common settings:

- SEC_API_ORGANIZATION,SEC_API_EMAIL
- OLMOCR_SERVER,OLMOCR_MODEL,OLMOCR_WORKSPACE
- EMBEDDING_SERVER,EMBEDDING_MODEL
- CHROMA_PERSIST_DIR
- MCP_HOST,MCP_PORT,MCP_NGROK_ALLOWED_HOSTS

Seefinance_data/settings.pyfor defaults.

make vllm-olmocr-serve make vllm-embd-serve make vllm-reranker-serve
uv run --group ocr-md --group mcp python mcp_server.py

- Hybrid (dense + BM25 + reranker):POST /vector_store/search_sec_filings

- Hybrid (dense + BM25 + reranker):POST /vector_store/search_transcripts

- Hybrid:search_sec_filings_tool,search_transcripts_tool

uv run python -m finance_data.filings.sec_data --ticker AMZN --year 2025 uv run python -m finance_data.ocr.olmocr_pipeline --pdf-dir sec_data/AMZN-2025
curl -s -X POST "http://127.0.0.1:8081/vector_store/embed_sec_filings" \ -H "Content-Type: application/json" \ -d '{"ticker":"AMZN","year":"2025","filing_type":"10-K","force":false}' curl -s -X POST "http://127.0.0.1:8081/vector_store/search_sec_filings" \ -H "Content-Type: application/json" \ -d '{"ticker":"AMZN","year":"2025","filing_type":"10-K","query":"operating income margin","top_k":5}'
uv run python -m finance_data.earnings_transcripts.transcripts AMZN 2025
curl -s -X POST "http://127.0.0.1:8081/vector_store/embed_transcripts" \ -H "Content-Type: application/json" \ -d '{"ticker":"AMZN","year":"2025","force":false}' curl -s -X POST "http://127.0.0.1:8081/vector_store/search_transcripts" \ -H "Content-Type: application/json" \ -d '{"ticker":"AMZN","year":"2025","query":"AWS revenue growth","top_k":5}'

- docs/README.md
- docs/setup-and-operations.md

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

An MCP server providing semantic search capabilities for APLCart data.

MCP server for Christian scholarship and research — scripture, Greek/Hebrew word data, cross-references, patristic texts, and semantic search,

Access and search EPUB ebook collections using semantic vector search.

local-first semantic search in Lojban dictionaries

Search 419,000+ space regulatory filings from the FCC, ITU, UNOOSA, and FAA-AST — semantic search, entity dossiers, spectrum holdings, launch licenses, and alerts.

Self-hosted web search for AI agents — multi-engine parallel search with embedding-based result reranking. Zero API keys, pip install.

MCP server that enables AI assistants to search Reddit conversations, explore subreddits, and access trending topics.

Provides semantic search across local files by creating vector embeddings from watched directories.

Embeddings, vector search, document storage, and full-text search with the open-source AI application database

Semantic search through Dickens' classic tale. Find passages by meaning, theme, or concept - not just keywords.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.