sec8k_material_today
Retrieve material SEC 8-K filings from today filtered by item codes such as earnings, officer changes, M&A, dilution, restatements, and delisting. Optionally filter by ticker symbol.
Instructions
Material SEC 8-K filings today filtered by item code: 2.02 (earnings), 5.02 (officer change), 2.01 (M&A), 3.02 (dilution), 4.02 (restatement), 3.01 (delisting).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | item codes (e.g. ['2.02','5.02']) | |
| ticker | No | filter by ticker symbol |
Implementation Reference
- falsifylab_alpha_mcp.py:197-198 (handler)The tool handler for sec8k_material_today. Dispatches to the backend API endpoint /api/sec8k/today via the _api_get helper function.
if name == "sec8k_material_today": return _api_get("/api/sec8k/today", args) - falsifylab_alpha_mcp.py:121-135 (schema)Input schema definition for sec8k_material_today. Accepts optional 'items' (array of item codes) and 'ticker' (string) parameters.
{ "name": "sec8k_material_today", "description": "Material SEC 8-K filings today filtered by item code: " "2.02 (earnings), 5.02 (officer change), 2.01 (M&A), " "3.02 (dilution), 4.02 (restatement), 3.01 (delisting).", "inputSchema": { "type": "object", "properties": { "items": {"type": "array", "items": {"type": "string"}, "description": "item codes (e.g. ['2.02','5.02'])"}, "ticker": {"type": "string", "description": "filter by ticker symbol"}, }, }, }, - falsifylab_alpha_mcp.py:121-135 (registration)Tool definition/registration as part of the TOOLS list exposed via tools/list and tools/call MCP methods.
{ "name": "sec8k_material_today", "description": "Material SEC 8-K filings today filtered by item code: " "2.02 (earnings), 5.02 (officer change), 2.01 (M&A), " "3.02 (dilution), 4.02 (restatement), 3.01 (delisting).", "inputSchema": { "type": "object", "properties": { "items": {"type": "array", "items": {"type": "string"}, "description": "item codes (e.g. ['2.02','5.02'])"}, "ticker": {"type": "string", "description": "filter by ticker symbol"}, }, }, }, - falsifylab_alpha_mcp.py:51-70 (helper)The _api_get helper function that actually makes the HTTP GET request to the backend API, used by the sec8k_material_today handler.
def _api_get(path: str, params: dict | None = None) -> dict: if params: from urllib.parse import urlencode path = f"{path}?{urlencode(params)}" req = urllib.request.Request( f"{API_BASE}{path}", headers={ "User-Agent": USER_AGENT, "Accept": "application/json", **({"Authorization": f"Bearer {API_KEY}"} if API_KEY else {}), }, ) try: with urllib.request.urlopen(req, timeout=20) as r: return json.loads(r.read()) except urllib.error.HTTPError as e: body = e.read().decode(errors="ignore")[:400] return {"error": f"HTTP {e.code}: {body}"} except Exception as e: return {"error": str(e)[:200]}