disclosure-alpha 1.2.0

Open-source deterministic SEC filing analytics: parse, metrics, diff, score

Disclosure Alpha

Deterministic SEC filing analytics — parse, score, diff. No LLM required.

Open-source, deterministic SEC filing analytics for 10-K and 10-Q HTML. Reproducible JSON scores from text metrics, boolean risk flags, and section diffs. CLI, Python SDK, HTTP API, and MCP. 8-K supported via local --html or MCP Builder only (not --ticker, EDGAR, or HTTP ticker routes).

Not investment advice. See Scope and claims and Evidence & limitations.

Quick start

pip install "disclosure-alpha"
export SEC_USER_AGENT="YourName [e-mail]"   # required for --ticker / EDGAR only
disclosure-alpha score --ticker AAPL --fiscal-year 2025 --form 10-K

HTTP API + MCP: pip install "disclosure-alpha[api,mcp]"

from disclosure_alpha import score_filing_ticker
print(score_filing_ticker("AAPL", 2025, form_type="10-K").scores.overall_disclosure_risk_score)

Integration surfaces

Surface	Entry	Extra
CLI	disclosure-alpha	(base)
Python SDK	import disclosure_alpha	(base)
HTTP API	disclosure-alpha-api	[api]
MCP Analyst	disclosure-alpha-mcp-analyst	[mcp]
MCP Builder	disclosure-alpha-mcp-builder	[mcp]

Documentation

Full guides, methodology, and validation evidence: https://disclosure-alpha.readthedocs.io/en/latest/

• Installation
• Understanding scores
• HTTP API
• MCP

Links

• Repository: https://github.com/alwank/disclosure-alpha
• Changelog: https://github.com/alwank/disclosure-alpha/blob/main/docs/appendix/changelog.md
• Contributing: https://github.com/alwank/disclosure-alpha/blob/main/CONTRIBUTING.md

Apache-2.0. See LICENSE.