FilingLens MCP server
Commit Nov 15, 2026Compare SEC financial facts across different filing cutoffs using local data and source evidence.
Also known as f-tiger/agi-site, filinglens
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 15, 2026
- License
- —
What is FilingLens MCP?
FilingLens is an MCP server. Compare SEC financial facts across different filing cutoffs using local data and source evidence.
Summary generated from the project's README
About FilingLens MCP server
FilingLens Local SEC Fact Comparison allows developers to analyze changes in SEC financial data by comparing the same concept across two different filing cutoffs. This server operates locally via stdio and requires Node.js 22 or higher to run. It functions as a read-only toolset that uses a single official SEC companyconcept JSON object provided by the host. Because it operates without network calls, file reads, or telemetry, it maintains a strict focus on the data supplied by the client.
Users interact with the server through three specific tools: filinglens_example, filinglens_periods, and filinglens_compare. The system handles specific financial concepts such as Assets, Liabilities, NetIncomeLoss, and EarningsPerShareDiluted. It uses integer arithmetic for absolute decimal differences and provides source references in the metadata for verification. This tool is designed for internal evaluation and does not provide investment recommendations or restatement classifications.
What you can do with it
- 1Identify period availabilityAsk the client to list all valid start and end date combinations for a specific financial period.
- 2Compare financial values across cutoffsRequest a comparison of a specific financial concept between two different filing dates to see how the reported value changed.
- 3Verify reported data sourcesRetrieve the metadata containing source references to check the original SEC filings for a specific fact.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablef-tiger/agi-site is public and reachablegithub.com/f-tiger/agi-site ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-14github.com/f-tiger/agi-site ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubFilingLens MCP — internal evaluation beta
Compare the same SEC financial fact for the exact same period at two filing cutoffs. Three read-only tools: filinglens_example, filinglens_periods, filinglens_compare. Prompt: review_filing_change; resource: filinglens://contract.
Requires Node.js 22+. Extract the published archive, verify its SHA-256, then run npm ci --ignore-scripts --no-audit --no-fund and npm test. Run node scripts/evaluate.mjs for the ten independent protocol scenarios. Configure an MCP host with command node and absolute argument /path/filinglens-mcp/src/server.mjs. A plain terminal waits on stdio; it is not a chat interface.
The host supplies one official SEC companyconcept JSON object. No file reads, network, storage, model calls or telemetry occur in this package. Host fees and data policies apply. The browser site has a separate, cached official SEC lookup. Source documentation: https://www.sec.gov/search-filings/edgar-application-programming-interfaces and https://www.sec.gov/search-filings/edgar-search-assistance/accessing-edgar-data . Respect SEC fair access rules when obtaining data.
filinglens_periods returns exact start/end/unit combinations, with pagination. filinglens_compare accepts {data, options:{unit,start:null|"YYYY-MM-DD",end,before,after}}. before must precede after. It picks the latest eligible filing date at each cutoff; same-day value conflicts are incomplete. A missing baseline is not zero. It never combines fiscal labels, quarter frames, concept tags or units. Absolute decimal differences use integer arithmetic; unsafe numbers are rejected. Source references are supplied metadata and must be checked in original filings. Fictional example records have no source links.
Supported concepts: Assets, Liabilities, StockholdersEquity, Revenues, RevenueFromContractWithCustomerExcludingAssessedTax, NetIncomeLoss, EarningsPerShareDiluted, NetCashProvidedByUsedInOperatingActivities. Custom dimensions and tags are outside scope. No restatement classification, alerts, trading or investment recommendation. A reported-value change does not prove an accounting error, its cause or an investment opportunity.
The free beta license permits internal evaluation only. The proposed €19/month workspace is not built or for sale. No revenue or customer proof is claimed. Validation includes adversarial fixtures and a real SDK stdio client, not a benchmark of host-model reasoning or every desktop host.
FilingLens MCP questions
What financial concepts are supported?
Supported concepts include Assets, Liabilities, StockholdersEquity, Revenues, NetIncomeLoss, and EarningsPerShareDiluted, among others.
Does this server access the internet or store data?
No, the package performs no network calls, file reads, storage, or telemetry; it relies on the host to supply the SEC companyconcept JSON object.
Can I use this for investment recommendations?
No, the tool does not provide restatement classification, alerts, trading, or investment recommendations.