Public Company Reporting Window Finder
상장 기업 실적 발표일 및 보고 기간 찾기 MCP 서버
Mamba Labs의 Public Company Earnings Dates and Reporting Window Finder 액터를 위한 MCP 서버입니다.
도메인, 티커, ISIN, LEI 또는 CIK를 입력하면 해당 상장 기업이 언제 실적을 발표하는지와 그 전후에 연락하기 좋은 시기를 알려줍니다: 회계연도 종료일, 보고 주기, 다음 보고일, 이벤트까지 남은 일수, 그리고 사용자가 정의한 아웃리치 기간의 시작과 종료일.
타이밍 행은 미국 기업에만 적용됩니다. 신원, 거래소 및 분류는 전 세계 공개 가능한 기업에 대해 확인됩니다. 보고일은 미국 SEC 제출 이력에서 가져오며 미국 기업에만 존재합니다. 비미국 기업은 완전히 확인되지만 추정 날짜 대신
timing_unavailable_reason을 반환하며, 조회가 실행되었으므로 여전히 타이밍 행으로 청구됩니다.
다섯 가지 도구, 각 액터 모드별
도구 | 입력 | 반환값 |
| 식별자 | 신원 및 거래소, 44개 필드 |
| 식별자 | 상장 상태 판정 |
| 식별자 | 회계연도 종료일, 주기, 다음 이벤트, 아웃리치 기간, 75개 필드 |
| 필터 | 기업 목록 |
| 필터 | 주별 또는 월별 보고 부하 |
mode를 전달할 필요가 없습니다. 각 도구가 자체적으로 설정하며, 각 도구는 해당 모드가 실제로 사용하는 입력만 노출합니다.
build_company_universe와 get_reporting_season은 필터에서 목록을 작성하며 기업 식별자를 허용하지 않습니다. 두 도구 모두에서 limit을 명시적으로 설정하세요: 기본값은 1000이며 반환된 행당 요금이 부과됩니다.
Related MCP server: corporate-events-mcp
설치
{
"mcpServers": {
"mamba-public-company-reporting-window-finder": {
"command": "npx",
"args": ["-y", "@mambalabsdev/mcp-public-company-reporting-window-finder"],
"env": { "APIFY_TOKEN": "your-apify-token" }
}
}
}console.apify.com/account/integrations에서 토큰을 받으세요.
출력 읽기
날짜는 예측된 것이지 공식 발표된 것이 아닙니다. 제출 이력에서 파생된 날짜의 경우 next_event_is_estimate가 true입니다. confidence_band는 0.80과 0.50에 위치하며, 체인에서 가장 약한 연결고리를 기준으로 계산되므로 confidence_effective는 평균이 아닌 이벤트 신뢰도와 주기 신뢰도 중 최소값입니다.
window_status는 필터링할 필드입니다. 오늘 기준으로 open, not_yet, closed_passed 또는 no_event입니다. no_event는 보고 이벤트가 없어 기간을 구성할 수 없는 기업의 상태입니다.
알 수 없는 주기는 거부되며 추측하지 않습니다. 제출 이력이 너무 짧거나 불규칙한 기업은 임의의 날짜 대신 이유와 함께 null 주기를 반환합니다.
아무것도 확인되지 않은 행도 청구됩니다. 어떤 상장 기업과도 일치하지 않는 식별자는 다른 모든 필드가 null인 no_match의 match_method를 반환합니다. 이는 실제 답변이며 조회가 실행되어 생성된 것입니다.
비용
Apify에서 이벤트당 지불하며, 필터링된 행이 아닌 반환된 행에 대해 요금이 부과됩니다.
이벤트 | 가격 |
기업 확인 | $0.006 per row |
타이밍 행 반환 | $0.012 per row |
보고 시즌 집계 | $0.05 per row |
액터 시작 | $0.00005 per run |
Apify Bronze, Silver, Gold 요금제에서 5%, 10%, 15%의 볼륨 할인이 적용됩니다. 타이밍 행은 확인된 기업으로 추가 청구되지 않습니다.
Mamba Labs GTM 제품군의 일부
라이선스
MIT
Available Tools
5 toolsbuild_company_universeBuild Company UniverseAIdempotent
Build a list of listed companies from filters rather than from identifiers you already hold. Filter by exchange, country, region, sector, security type, public float band, fiscal year end month, reporting cadence, operating status and foreign private issuer status. Returns 44 fields per company, the same shape resolve_company returns. At least one filter is required, so a bare call cannot pull the whole universe. This tool does NOT accept company identifiers: use resolve_company, qualify_company or get_reporting_timing for specific companies. SET limit EXPLICITLY. It defaults to 1000 and you are charged per company row returned, so an unbounded call is an expensive call. Truncation is always reported, never silent. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Inputs: limit, regions, sectors, cadences, +13 more.
get_reporting_seasonGet Reporting SeasonAIdempotent
Show how reporting load is distributed over time, so you can find the busy weeks and the quiet ones. Returns aggregate rows per bucket, not per company: period start and end, event count, company count, estimated share and mean confidence. Bucket by week or month with season_group_by, and optionally split by sector, country or exchange with season_split_by. The window defaults to today through 180 days out; set season_from and season_to for another. At least one filter is required and company identifiers are not accepted. Use this to plan campaign timing across a market, not to time one account; for a single company use get_reporting_timing. Narrow the population with the same filters build_company_universe takes (exchange_codes, country_codes, regions, sectors, public_float_bands, cadences). Charged per aggregate row returned, which is far fewer rows than the companies behind them. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Inputs: limit, regions, sectors, cadences, +18 more.
get_reporting_timingGet Reporting TimingAIdempotent
Find when a public company next reports, and when to reach out around it. Returns 75 fields per input: fiscal year end, derived reporting cadence and its confidence, the next reporting event with its type, period and date, days to event, and the open and close of an outreach window you define with window_lead_days and window_lag_days, which default to 70 and 42. window_status is one of open, not_yet, closed_passed or no_event and is the field to filter on. Dates are PREDICTED from filing history, not announced: read next_event_is_estimate and confidence_band, whose thresholds sit at 0.80 and 0.50. TIMING ROWS COVER US COMPANIES ONLY. A non US company resolves fully for identity and returns a stated timing_unavailable_reason rather than a guessed date, and is still charged as a timing row because the work ran. Charged per timing row returned, never additionally as a resolved company. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Inputs: ciks, leis, isins, regions, +26 more.
qualify_companyQualify CompanyAIdempotent
Answer whether a company is publicly listed. Takes the same identifiers as resolve_company and returns a listed status verdict per input. Set listed_only to keep only the companies proven to be listed, or suppress_listed to remove them, which is what you want when selling only into private companies. By default an unmatched company returns is_listed null rather than false, because a non match may mean the company is private OR that the dataset does not hold its domain; set assume_unmatched_is_private to true to opt into reading a non match as private. Use this to split a prospect list into listed and private companies before outreach; use resolve_company when you need the full identity fields. Identify companies with company_domain, company_domains, tickers, isins, leis, ciks, or company_names; every other input is an optional filter shared with resolve_company (exchange, country, region, sector, security type, float band, fiscal year end, cadence, and data quality switches). Charged per company row returned. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Inputs: ciks, leis, isins, regions, +22 more.
resolve_companyResolve CompanyAIdempotent
Resolve a domain, ticker, ISIN, LEI, CIK or company name to a listed company identity. Returns 44 fields per input: legal name, primary ticker, ISIN, LEI, CIK, domain, primary exchange, country, currency, sector, security type, public float band, shares outstanding, and the provenance of each. Every input returns exactly one row, including the ones that match nothing, which come back with match_method set to no_match and every other field null. Read matched_on to see which identifier produced the row. Use this when you hold identifiers and need the listed identity behind them; use qualify_company for a yes or no on listed status, get_reporting_timing for dates, and build_company_universe when you hold filters rather than identifiers. The filter inputs (exchange_codes, country_codes, regions, sectors, and the rest) narrow which matched rows come back. Charged per company row returned, including a no_match row, because the lookup ran either way. Requires an APIFY_TOKEN and consumes Apify credits. Read only.
Inputs: ciks, leis, isins, regions, +19 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct input/output contract: build_company_universe takes filters only, resolve_company takes identifiers, qualify_company returns a listed-status verdict, get_reporting_timing returns per-company timing, and get_reporting_season returns aggregate season buckets. Descriptions explicitly cross-reference when to use each alternative, making misselection unlikely.
All five names use consistent snake_case with a verb_noun structure (build_, resolve_, qualify_, get_). The only slight length variation is build_company_universe, but it follows the same convention.
Five tools are well-scoped for a read-only reporting-data server; each covers a distinct query mode and none feels redundant. The count sits comfortably in the ideal 3-15 range.
The surface covers company enumeration, identity resolution, listed-status qualification, per-company timing, and aggregate season planning, which is a coherent lifecycle for the domain. Minor gap: get_reporting_timing is US-only, so non-US timing requests dead-end with timing_unavailable_reason and no alternative tool; bulk or historical event retrieval is also absent but agents can work around via batching or aggregation.
Maintenance
Related MCP Connectors
Earnings results, outlook, KPIs and call transcripts for ~400 US, Asian and European companies.
Earnings calls, news releases, decks, prices and shareholders for listed companies worldwide.
US earnings dates, confirmed or estimated, each with its SEC EDGAR or company source URL.
Institutional-grade financial data: earnings, estimates, guidance, stock prices, macro indicators.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceEnables deep analysis of SEC EDGAR filings through universal company search, document content extraction, and advanced filing search capabilities. Provides AI-ready access to business descriptions, risk factors, financial statements, and full-text search across any public company's SEC documents.-
- FlicenseNot gradedqualityDmaintenanceNormalizes and serves corporate events (earnings, dividends, splits, M\&A) from US, UK, Canada, and Australia via a programmatic MCP API.-
- AlicenseAqualityAmaintenanceEnables users and AI agents to resolve tickers, CIKs, or company names to official SEC entity data and retrieve recent EDGAR filings, XBRL financial facts, and optional filing-text excerpts. It delivers structured, source-linked rows for research and tooling, with schema-versioned output and machine-readable error codes.7MIT
- FlicenseNot gradedqualityAmaintenanceEnables natural-language research and structured, source-backed answers across SEC filings, earnings transcripts, company financials, stock and crypto market data, and prediction markets news and research.-