Skip to main content
Glama
777,379 tools. Updated 2026-11-13 16:15

"Nordic Semiconductor" matching MCP tools:

  • Query verified U.S. private construction spending ($ millions) for data centers and semiconductor/computer-electronics manufacturing plants, from the U.S. Census Bureau's Value of Construction Put in Place (C30). Use this for "how much is being spent BUILDING data centers (or chip fabs) in the US" questions — the construction buildout in dollars, not capacity or investment. Filter by `category` ("data_center" — Census's named subcategory under Office; or "computer_electronic_electrical" — the semiconductor/computer-electronics manufacturing line under Manufacturing), `basis` ("seasonally_adjusted" = a seasonally-adjusted ANNUAL RATE, or "not_seasonally_adjusted" = the NOT-adjusted MONTHLY LEVEL), `data_month` (one month, ISO first-of-month e.g. "2026-04-01") or the `data_month_from`/`data_month_to` range, `year`, and `revision_status` ("preliminary", "revised", or "final"). Group by any of `category`, `basis`, `data_month`, `year`, or `revision_status`. Pass each parameter as a top-level key of `params` (flat — not nested under a `filter`, `filters`, or `where` key). Example: `{"category": "data_center", "basis": "seasonally_adjusted", "data_month": "2026-04-01"}` for one month; add `"group_by": ["data_month"]` over a `data_month_from`/`data_month_to` range for a series. Returns JSON aggregates with citations and optional row-level records when `include_records` is true — every value cites the exact Census workbook, sheet, row, and column. The two categories are DISTINCT series and are never conflated: `data_center` is data-center buildings; `computer_electronic_electrical` is the chip/electronics-manufacturing (fab) line — the CHIPS-Act build-out. `basis` is the other fork: the seasonally-adjusted series is an ANNUAL RATE (what the current monthly pace annualizes to), while the not-seasonally-adjusted series is the actual MONTHLY LEVEL. `revision_status` carries Census's own preliminary/revised/final marking verbatim. Data is monthly; the data-center series begins 2014-01. The response `as_of` is the release vintage (Census revises monthly); pin `as_of` to an earlier vintage to reproduce what was served then. NOT additive: `construction_spending_musd` is a published per-(category, basis, month) reading, so a total that mixes the two bases (an annual rate + a monthly level), or that sums the seasonally-adjusted ANNUAL-RATE series across months, is not a real figure — such a result carries a `construction_aggregation` scope note and ranking remainders omit the metric. Filter to one `basis` and `group_by data_month` for a series over time. Does not determine total data-center INVESTMENT (servers, chips, cooling, equipment — this is construction put-in-place only; Census does not publish an investment total), data-center MW capacity, count, square footage, or location (use the power.* capabilities for capacity and the interconnection queue), which company or project is building (Census C30 has no operator breakdown), public or government construction (this is PRIVATE construction only), or construction outside these two categories.
    ConnectorNo auth
  • CONTRACT tool. Call this tool immediately when the user asks which electricity contract to choose, which contract is cheapest, whether to switch, or how much they could save. Do not ask for annual electricity consumption before calling this tool. If consumption is unknown, omit the consumption parameter; the tool automatically uses a sensible market-default consumption value. Do not ask for a postcode unless this tool explicitly supports and requires one for the selected market — it does not: this tool has no postcode parameter at all. Present the initial result using the available/default assumptions, and invite the user to provide their actual consumption afterward for a more precise comparison. Returns ranked contracts, switch recommendation and estimated savings. Includes current spot price — no need to call spot_price separately. Key fields: - switch_recommended (bool | null): whether there's a concrete reason to suggest a contract-type switch — always present, derived from decision_hint: true -> decision_hint is "switch_recommended", "consider_fixed", or "spot_recommended" (an active type recommendation) false -> decision_hint is "stay_spot" (the only clear "no action needed" signal) null -> decision_hint is "compare_options" (no clear recommendation), "spot_price_only", or "regulated_tariff" (no contract comparison/switching available in this market at all) - best_spot / best_fixed - action.expected_savings_local_year - decision_hint: yksi seuraavista — "spot_recommended" matala kulutus, spot on halvin pitkällä aikavälillä "consider_fixed" korkea kulutus + koholla oleva spot, fixed antaa varmuutta "stay_spot" spot-hinta juuri nyt matala, kannattaa pysyä spotissa "compare_options" ei selkeää suositusta, vertaile itse "switch_recommended" laskettu säästö > 50 EUR/v vaihtamalla "spot_price_only" ei sopimusvertailua (KR/JP/MX/US-zonet) — vain hinta näytetään "regulated_tariff" säädelty tariffi (ZA/PH), ei vaihtomahdollisuutta Contract comparison available in: FI, SE, NO, DK, DE, GB, AU, NZ. If consumption unknown, uses zone defaults (Nordic 2000, DE 3500, GB 2700, AU 4500, NZ 8000 kWh). Set heating="electric" for heat pumps/floor heating. Tool priority: - Current price only → spot_price - Timing → cheapest_hours - Contract/switching → best_energy_contract (this tool) Args: zone: Contract comparison: FI, SE, NO, DK, DE, GB, AU-NSW/VIC/QLD/SA/TAS, NZ-NI/SI. Spot price only for all other zones. consumption: Annual electricity consumption in kWh. heating: "district" or "electric" (default: district).
    ConnectorNo auth
  • "What Changed" — recent MOVEMENTS in Silicon Analysts' public data over a 7d/30d window, derived from the daily snapshot ledger. Each moved metric returns direction (up/down), magnitude (pct_delta for value metrics, pp_delta for percentage metrics), old/new values, the two snapshot dates compared (as_of, prior_as_of), window_days_actual (the REAL lookback — the ledger is young, so a 30d window clamps to available history), and per-record provenance. Domains (the datasetId values): wafer_pricing, chip_cost, gpu_secondary, margin_benchmark, foundry_capacity, defect_density, nre_cost, packaging_benchmark, chip_archetype, electricity_price, cloud_pricing, llm_pricing, memory_spot, foundry_economics, market_prints, fab_capacity, hbm_market. USE THIS for: "what moved in semiconductor costs this week?", "did any wafer prices change recently?", "what changed since my last fetch on June 20?" (use since), building a market-change digest, monitoring deltas across the data layer over time. DO NOT USE for: current absolute values (use get_wafer_pricing / get_accelerator_costs / get_foundry_allocation); allocation lead-time trend specifically (use get_foundry_allocation with include_history). Filters: window (7d|30d), since (ISO date — compare the latest snapshot against the newest snapshot at/before it; overrides window for baseline selection), datasetId (one domain), minDelta (override the significance threshold), limit. N2/Apple omitted (conflict-safe). Returns an empty array when nothing moved past the significance gate — does not error. Cite as "Silicon Analysts — What Changed".
    ConnectorNo auth
  • Query verified U.S. monthly IMPORTS of semiconductor-manufacturing EQUIPMENT (HS-8486) — customs value (USD) by country of origin — from the U.S. Census Bureau's International Trade data. Use this for "is the fab buildout actually tooling up, and who supplies the machines" questions — the equipment leg of the fab lifecycle: construction spending (ai_infrastructure.construction) measures the shell, this measures the tools flowing in, and chip imports (ai_infrastructure.trade) measure the output side. HS-8486 covers machines and apparatus used solely or principally to MANUFACTURE semiconductor boules/wafers, devices, and integrated circuits — AND flat-panel displays (Census does not split them at this level); it is NOT the chips themselves (those are HS-8542). Filter by `country` (the verbatim Census name, e.g. "JAPAN", "NETHERLANDS", "KOREA, SOUTH"), `cty_code` (the Census country code), `country_level` ("total" = the all-countries TOTAL, "country" = an individual country, "grouping" = a Census bloc/continent like ASIA / APEC / EU), `year`, `data_month` (one month, ISO first-of-month e.g. "2026-04-01") or the `data_month_from`/`data_month_to` range. Group by any of `country`, `cty_code`, `country_level`, `data_month`, or `year`. Pass each parameter as a top-level key of `params` (flat — not nested under a `filter`, `filters`, or `where` key). Example: `{"country_level": "country", "group_by": ["country"], "order_by": "general_value_usd", "top_n": 5}` for the top tool-supplying countries; `{"country_level": "total", "group_by": ["data_month"]}` for the national trend. Returns JSON aggregates with citations and optional row-level records when `include_records` is true — every value cites the exact Census response row, re-verifiable via get_source_evidence_v1. Measures: `general_value_usd` (general imports value) and `consumption_value_usd` (imports for consumption) — value only; no tool counts, and no tool-type or vendor breakdown (one HS4 heading: no lithography-vs-deposition-vs-etch split, no per-manufacturer series such as ASML). NEVER SUM across country rows: Census's groupings (ASIA, APEC, EU, OECD, ASEAN, the continents) OVERLAP each other and the individual countries, and the all-countries TOTAL contains everything — so adding rows double-counts; a cross-row sum returns a country_aggregation note and nulls the metric in ranking remainders. Filter `country_level=total` for the U.S. national figure. Country is the country of ORIGIN (Census attribution), not which U.S. fab, state, or operator receives the equipment — there is no U.S. place breakdown. Imports only (not exports), customs value (not landed/CIF/duty), and recent months are preliminary and revised in later Census releases.
    ConnectorNo auth
  • Query verified U.S. semiconductor & electronic-component PRODUCTION and CAPACITY UTILIZATION — the Federal Reserve's monthly G.17 industrial-production index (2017=100) and capacity-utilization rate (percent) for NAICS 3344 — from the Board's own release, history to 1972. Use this for "are the domestic fabs actually producing / how hot are they running" questions — the OUTPUT leg of the fab lifecycle: construction spending (ai_infrastructure.construction) measures the shell, equipment imports (ai_infrastructure.equipment_trade) the tools flowing in, chip imports (ai_infrastructure.trade) what crosses the border; this measures domestic production and how much of the installed capacity is in use. NAICS 3344 is "semiconductor and OTHER electronic component" manufacturing — the finest split the Fed publishes here (broader than semiconductors alone, and NOT the same slice as QCEW's 334413). Filter by `series_kind` ("ip" = the production index, on both bases; "capacity_utilization" = percent of capacity in use, seasonally adjusted only; "capacity" = the capacity index behind the rate), `series_name` (the verbatim Fed series, e.g. "IP.G3344.S", "CAPUTL.G3344.S"), `basis` ("seasonally_adjusted" / "not_seasonally_adjusted" — IP only), `year`, `data_month` (ISO first-of-month, e.g. "2026-05-01") or the `data_month_from`/`data_month_to` range. Group by any of `series_name`, `series_kind`, `basis`, `data_month`, or `year`. Pass each parameter as a top-level key of `params` (flat — not nested). Example: `{"series_kind": "capacity_utilization", "group_by": ["data_month"], "data_month_from": "2024-01-01"}` for the utilization trend; `{"series_kind": "ip", "basis": "seasonally_adjusted", "group_by": ["year"]}` for the production index by year (an average per year). Returns JSON aggregates with citations and optional row-level records when `include_records` is true — every value cites the exact Fed SDMX observation, re-verifiable via get_source_evidence_v1. Measures are avg/min/max per reading — `avg_ip_index`, `avg_capacity_utilization_pct`, `avg_capacity_index` (+ min/max variants): an index or a rate is INTENSIVE, so multi-month figures are AVERAGES, never sums (the Fed publishes its own quarterly/annual aggregations, which this block does not serve — monthly grain only). An index is not dollars and not unit counts (2017=100). Capacity and utilization exist seasonally adjusted only — their not-seasonally-adjusted cells are structurally absent, never zero. Averaging the IP index across both bases returns a production_aggregation note — filter or group by basis instead. National industry aggregate: no state, county, fab, or company breakdown. Every monthly release revises history (as_of carries the vintage).
    ConnectorNo auth
  • CONTRACT tool. Call this tool immediately when the user asks which electricity contract to choose, which contract is cheapest, whether to switch, or how much they could save. Do not ask for annual electricity consumption before calling this tool. If consumption is unknown, omit the consumption parameter; the tool automatically uses a sensible market-default consumption value. Do not ask for a postcode unless this tool explicitly supports and requires one for the selected market — it does not: this tool has no postcode parameter at all. Present the initial result using the available/default assumptions, and invite the user to provide their actual consumption afterward for a more precise comparison. Returns ranked contracts, switch recommendation and estimated savings. Includes current spot price — no need to call spot_price separately. Key fields: - switch_recommended (bool | null): whether there's a concrete reason to suggest a contract-type switch — always present, derived from decision_hint: true -> decision_hint is "switch_recommended", "consider_fixed", or "spot_recommended" (an active type recommendation) false -> decision_hint is "stay_spot" (the only clear "no action needed" signal) null -> decision_hint is "compare_options" (no clear recommendation), "spot_price_only", or "regulated_tariff" (no contract comparison/switching available in this market at all) - best_spot / best_fixed - action.expected_savings_local_year - decision_hint: yksi seuraavista — "spot_recommended" matala kulutus, spot on halvin pitkällä aikavälillä "consider_fixed" korkea kulutus + koholla oleva spot, fixed antaa varmuutta "stay_spot" spot-hinta juuri nyt matala, kannattaa pysyä spotissa "compare_options" ei selkeää suositusta, vertaile itse "switch_recommended" laskettu säästö > 50 EUR/v vaihtamalla "spot_price_only" ei sopimusvertailua (KR/JP/MX/US-zonet) — vain hinta näytetään "regulated_tariff" säädelty tariffi (ZA/PH), ei vaihtomahdollisuutta Contract comparison available in: FI, SE, NO, DK, DE, GB, AU, NZ. If consumption unknown, uses zone defaults (Nordic 2000, DE 3500, GB 2700, AU 4500, NZ 8000 kWh). Set heating="electric" for heat pumps/floor heating. Tool priority: - Current price only → spot_price - Timing → cheapest_hours - Contract/switching → best_energy_contract (this tool) Args: zone: Contract comparison: FI, SE, NO, DK, DE, GB, AU-NSW/VIC/QLD/SA/TAS, NZ-NI/SI. Spot price only for all other zones. consumption: Annual electricity consumption in kWh. heating: "district" or "electric" (default: district).
    ConnectorNo auth

Matching MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for Nordic company registries. Verify companies, check board members, signing authority, and financial data across Norway, Denmark, Finland, and Sweden using official public APIs. 23 tools covering search, details, roles, and batch lookups.
    19
    14
    Apache 2.0

Matching MCP Connectors

  • Company, KYB, VAT, sanctions, LEI and address data for 15 EU countries.

  • Source-cited financial research on US and Nordic company filings.

  • Company registry data plus national industry statistics in one call. Returns `company` (same shape as lookup_company) and `industryStats` — a time series from the national statistics office for the company's industry code (currently Danmarks Statistik for DK); `industryStats.available` is false when no statistics exist. Supports 4 countries: DK, NO, SE, FI. For other countries use lookup_company (basic registry data) or kyb_full (full due-diligence report).
    ConnectorNo auth
  • Discovery meta-tool. Lists ALL available Nordic Data API data endpoints (HTTP method, path, short description) by reading the backend's live OpenAPI spec at runtime — far beyond the curated high-level tools. Use this to discover capabilities the dedicated tools do not cover, then call get_endpoint_schema for parameter details and call_endpoint to execute one. Only read-only operations are listed (GET/HEAD plus the POST screening queries); admin and state-changing endpoints are never returned. Supports an optional `search` keyword filter. The catalog has 230+ endpoints.
    ConnectorNo auth
  • Connectivity check that confirms the Nordic MCP server process is responding. Use this at the start of a session to verify the server is reachable before making other calls. Do not use as a proxy for database health — the server can respond while the Qdrant vector database is temporarily unavailable. To confirm data availability, call search_filings directly. Returns: A greeting string: "Hello {name}! Nordic MCP server is running."
    ConnectorNo auth
  • Search the Nordic financial database for company filings, press releases and macroeconomic summaries. Use this as the primary tool for any question about Nordic listed companies, markets or macro conditions. Do not use to retrieve a full document — results are chunked text excerpts; use parse_pdf_to_text for the full original document. Do not use for Swedish company registration data — use get_company_info instead. The database contains ~1 million vectors across four Nordic markets (NO/SE/DK/FI). COMPANY FILINGS Annual reports (XBRL/ESEF) and quarterly reports from ~1 500 listed companies across Oslo Børs, Nasdaq Stockholm, Nasdaq Helsinki, Nasdaq Copenhagen and First North markets. Covers 2020–present. Strong coverage for NO and SE; growing coverage for DK and FI. EXCHANGE ANNOUNCEMENTS & PRESS RELEASES Regulatory filings, exchange announcements and press releases from listed companies in NO, SE, DK and FI. Covers 2020–present. MACROECONOMIC SUMMARIES Quarterly macro summaries covering key indicators per country: Norway (NO): policy rate, FX rates, CPI, house prices, credit growth, electricity price, salmon price, GDP components Sweden (SE): policy rate, house price index, household credit Denmark (DK): policy rate, house price index, household loans, electricity price Finland (FI): house price index, household debt-to-income ratio, electricity price Use report_type='macro_summary' and country='NO'/'SE'/'DK'/'FI' to filter. Use fiscal_year and a quarter reference in your query, e.g. "Norwegian housing market Q1 2024". Args: query: What you are looking for, e.g. 'net interest margin outlook', 'salmon price Q3', 'dividend policy', 'fleet utilization', 'Norwegian housing market 2024 Q1', 'Swedish policy rate inflation 2023' ticker: Optional — filter by company ticker, e.g. 'SALM', 'EQNR', 'NDA' fiscal_year: Optional — filter by year, e.g. 2024 report_type: Optional — one of: 'annual_report' – Nordic XBRL/ESEF annual reports 'quarterly_report' – Quarterly/interim reports 'press_release' – Exchange announcements and press releases 'macro_summary' – Quarterly macroeconomic summaries sector: Optional — filter by sector: 'seafood' – seafood companies 'energy' – energy / oil & gas 'shipping' – shipping companies country: Optional — filter by country code: 'NO', 'SE', 'DK' or 'FI' limit: Number of results after reranking (default 5, max 20) Returns: List of relevant text excerpts with metadata, reranked by relevance. Each result includes rerank_score, hybrid_score, vector_score, company, ticker, country, fiscal_year, report_type, period, filing_date and the full text chunk. Returns an empty list if no relevant results are found or if the Qdrant database is temporarily unreachable.
    ConnectorNo auth
  • Download a PDF from a URL and extract all text content, page by page. Use this to read the full text of a specific document — for example, an annual report PDF linked from a search_filings result. Best combined with search_filings: use search_filings to locate the document, then parse_pdf_to_text for the full text. Do not use for PDFs that are already well-represented in the database — search_filings is faster and returns pre-ranked, relevant excerpts. Not suitable for scanned (image-only) PDFs without embedded text; those pages will be returned as "(no extractable text)". Args: pdf_url: Direct HTTPS URL to the PDF file, e.g. https://example.com/report.pdf. Must be publicly accessible; authentication-protected URLs will fail. Returns: All text from the PDF with "--- Page N ---" separators between pages. Returns an error string if the download fails, the URL does not point to a valid PDF, or the document exceeds the 60-second download timeout.
    ConnectorNo auth
  • Resolve a named company group (e.g. "FAANG", "AI", "Fintech") into its list of company slugs, for use in the benchmark tools' companySlugs filter. Matching is case- and separator-insensitive. Omit "group" (or pass an unknown one) to get the list of available group names. Available groups: FAANG, AUTOMOTIVE, SPACE, SOCIAL_MEDIA, AI, AI_PLUS, FINTECH, FAANG_PLUS, HEDGE_FUNDS, SEMICONDUCTOR, BIOTECH, WEB3, TRADING_FIRMS, DEFENSE.
    ConnectorNo auth
  • Semantic search within the full text of company filings (annual and interim reports, stock exchange releases, SEC filings) for qualitative questions: strategy, risk factors, guidance, accounting policies. Covers US (NYSE, NASDAQ) and Nordic (HEL, STO) filings. Results are ranked by meaning, not keywords: check each result's company_name, and put synonyms (and for Nordic filings, local-language terms) in the query. Ask one topic per call: several topics in one query ("compute, customer concentration and key people") blend into passages about none of them. For a US filer's risk factors as a list, or what changed between two filings, use search_filings(mode="risk_factors" / "risk_changes"). Args: company: Name or ticker, fuzzy-matched ("DHI", "D.R. Horton"). A company named only in the query is auto-detected (``resolution.auto_detected``); set it explicitly to be certain. year: Fiscal year. quarter: 1-4; unpopulated for part of the corpus, so use only for one quarter's interim report. With quarter unset, a period in the query ("Q3 2026", "H1 2025", "FY2024") is applied as the filter; ``period_scope`` reports it. Passages from another period are never in ``results``: they come under ``other_period_results`` (``period_scope.status`` is ``period_not_indexed`` when none match the period asked). document_type: "annual_report", "interim_report", "stock_exchange_release", "10-K", "10-Q"; aliases normalized. market: "us" or "nordic"; omit to auto-detect. With no company or index the search covers Nordic filings only (``market="us"`` alone returns nothing). index: Only "sp500" (forces US, queries every constituent). Cannot be combined with ``company``. limit: Passages to return (default 5, max 20). max_total_results caps rows after adjacent-page expansion. include_adjacent_pages: Also return the page before and after each Nordic hit (``is_adjacent_page``, ``supports: "context"``), for policy text that spans pages. For a full page use ``get_filing_snapshot`` with ``include_text=true``. topic_tags / ifrs_tags: Restrict to pages tagged with these concepts (deterministic; unknown values are ignored and reported back). Topics are snake_case, e.g. leases, goodwill, impairment, segment_reporting, risks_uncertainty, strategy_outlook, ceo_review, dividends, sustclimate. IFRS (Nordic only): "IAS 1" .. "IAS 40", "IFRS 1" .. "IFRS 18", e.g. "IFRS 16". auto_detect_tags: Default True: with no explicit tags, tags are detected from the query. A tag filter matching nothing is retried untagged (``tag_filters.applied: false``). For US filings detected tags only order the passages. response_mode: "detailed" (default) or "concise" (drops long excerpts, keeps citation fields); use "concise" across several companies. Returns ``results`` (``content``, ``page_id``, ``page_number``, ``evidence``, ``citation_markdown``, ``source_url``), ``sources``, ``source_policy``, ``resolution``, ``tag_filters``, and a ``diagnostic`` when nothing is found. Keyword-fallback hits (pages not yet vectorised) carry ``retrieval: "keyword"``. Each result has ``relevance`` (high / medium / low against the best passage of this search, not a judgement of the answer), its ``topic_tags``, ``risk_factor`` (heading, category) for a SEC risk-section passage, and ``also_in_versions`` when the same text is in another version of the filing (an S-1 and its S-1/A). Cite as numbered links to ``citation_markdown``'s URL; ``page_id`` is only for follow-up calls (``get_filing_snapshot``) and never shown to the user.
    ConnectorAPI key
  • Fetch one US SEC 10-K or 10-Q directly from EDGAR as a transient last resort, only when search_filing_content (same company and year) returned nothing because the filing text is not indexed, and the question needs the filing text (a quote, a risk-factor paragraph). Never loop it over years (rate limit: 15/hour global, 3/hour per company). Not for numbers (use get_company_financials / get_financial_statement), not for 8-Ks (use company_events), not for Nordic filings. The result is not stored; a repeat call costs another slot. Args: company: Name, ticker or CIK of a US filer. year: Calendar year the reporting period ended in. form_type: "10-K" (default) or "10-Q"; no other forms. quarter: Required for 10-Q: the CALENDAR quarter the period ends in (1 = Feb-Apr, 2 = May-Jul, 3 = Aug-Oct, 4 = Nov-Dec), not the fiscal label; Apple's fiscal Q1 (ends late December) is 4. query: Optional keywords; returns only sections containing them. Prefer it to keep the response small. Returns ``company``, ``filing`` (accession_number, form_type, filing_date, report_date, primary_document_url), ``sections[]`` (item_number, item_title, text) and ``meta`` (rate limits remaining, note). Failures return ``error`` (rate_limit_global, rate_limit_company, filing_not_found, unsupported_form_type, quarter_required_for_10q, not_a_us_filer, edgar_fetch_failed, ...) and ``detail``.
    ConnectorAPI key
  • Corporate events: US SEC 8-K events, and official stock-exchange releases of Finnish and Swedish listed companies (from 2026-01-01: inside information such as profit warnings and large orders, management changes, tender offers, reports). Also the report calendar. Scopes: - ``"company"`` (default): one company's events, newest first; ``summarise=True`` returns per-type counts instead. Set since/until around a date to explain a price move. - ``"cross_company"``: events across companies filtered by event type, ``index="sp500"``, ``industry`` (substring), ``companies`` list or ``market="nordic"`` (default US). - ``"calendar"``: scheduled interim / annual report dates in ``since_date``..``until_date`` (default today .. +14 days, max 120), optional ``company`` / ``market``; ``published: true`` once the report is in Clarifo, ``include_published=False`` keeps only upcoming. Never extend the calendar with guessed dates. ``companies`` (up to 30) or ``portfolio_id`` (from portfolios) gives several companies in one call; ``coverage`` then says per company why it has no date (later_date_known, not_announced_yet, no_calendar_coverage). - ``"offerings"``: one US company's priced offerings (424B4 / 424B1 prospectus), the IPO first, then follow-ons newest first. - ``"ipos"``: recent US IPOs market-wide, newest first (default since: 90 days); SPACs are flagged ``is_spac``. Args: company: Name, ticker or CIK; required for company scope. since_date / until_date: YYYY-MM-DD (default since: 365 days for company, 30 days for cross_company, 90 days for ipos; none for offerings). event_types: acquisition, disposition, executive_change, director_change, material_contract, default, bankruptcy, covenant_breach, amendment, auditor_change, earnings, guidance_update, other; Nordic also inside_information, profit_warning, tender_offer, capital_event, major_shareholding, insider_trade, share_repurchase, agm. Nordic profit warnings and guidance changes are filed as inside information: read the titles. item_numbers: Raw 8-K items, e.g. ["2.01"] (US). limit: Max 500 (ignored when summarising). market: "us" or "nordic". portfolio_id: Calendar scope: the user's portfolio whose companies to list (from portfolios). materiality: Nordic only: "high" (inside information, tender offers, management changes; cross_company default), "medium" (+ reports, capital events, holdings; company default) or "low" (everything). Returns ``events[]`` (company and cross_company), ``summary`` (summarise) or calendar ``events[]`` (expected_date, period_label, confirmed, published). Nordic events carry ``title``, ``category``, ``materiality``, ``excerpt`` and ``source_url`` to the filed release (cite it). ``offerings[]`` / ``ipos[]``: offering_type, pricing_date, price_per_share, price_range, shares_offered, gross_proceeds_usd, exchange, ticker, underwriters, registration (S-1 / F-1), source_url; no coverage: ``diagnostic.reason = "no_offerings_data_yet"``.
    ConnectorAPI key
  • Search company filings (SEC 10-K / 10-Q / 8-K, annual and interim reports, stock exchange releases), or with ``mode`` the report calendar and the earnings season. To read a filing's text use search_filing_content. Modes: - ``"filings"`` (default): documents with ``fiscal_year``, quarter, ``document_type``, ``docid``, ``period_end`` (safe for cross-company timelines) and ``filed_date``; ``year_from`` / ``year_to`` filter on fiscal year. ``market="us"`` with no company lists all US filings. - ``"calendar"``: scheduled report dates in ``from_date``..``to_date`` (default today .. +14 days, max 120), optionally one ``company`` or ``market``; ``published: true`` once the report is in Clarifo. Never extend the calendar with guessed dates. - ``"season"``: a calendar quarter's earnings season (``year_from`` + ``quarter``, default the latest ended): breadth and medians of revenue / margin / EPS change, sectors, outliers, largest still to report. Shares and medians are over ``coverage.with_revenue_growth`` (companies with figures so far), not all ``coverage.reported``; name that base. ``company`` = comma-separated watchlist, ``to_date`` = as-of date. - ``"reported"``: one row per company and period with ``released_at`` (US: the earnings 8-K), ``filed_at`` (10-Q / 10-K), ``status`` (released | filed), US figures and growth (``figures_source`` = xbrl | release_table). Default window the last 30 days. Any "share that grew" is over ``counts.with_revenue_growth`` ("12 of the 15 with figures so far"); ``counts.sp500_universe`` gives "x of 500". - ``"risk_factors"``: a US filer's Risk Factors section as individual risk factors (heading, category), latest 10-K / 20-F / S-1 / F-1 or ``docid``; ``query`` (words that must appear) returns the matching factors' text. - ``"risk_changes"``: risk factors added, removed and modified between two filings (default: ``docid`` or the latest vs the previous 10-K, 20-F or registration-statement version; ``compare_to`` = the older docid), with the sentences added, removed and edited. Args: company: Name or ticker, fuzzy-matched ("DHI", "D.R. Horton"). document_type: "annual_report", "interim_report", "stock_exchange_release", "10-K", "10-Q", "8-K". market: "nordic" (HEL, STO, OMXH) or "us" (NYSE, NASDAQ); omit for both. Season also takes "fi"/"HEL", "se"/"STO", "all" (default us). quarter: 1-4 with year_from = the calendar quarter the period ended in. index ("sp500"), status, min_revenue_growth_pct, sort: reported mode; sort = reported_at (default), revenue, revenue_growth_pct, net_income_growth_pct, eps_growth_pct, company. sector: Season and reported, GICS sector(s), comma-separated. from_date / to_date: YYYY-MM-DD. docid / compare_to: SEC accession numbers (risk modes). limit: Default 20, max 100. offset: max 1000, with ``has_more``. Returns ``filings`` (calendar: ``events``; reported: ``rows``), ``total`` (this page), ``total_available``, ``has_more``, ``resolution``.
    ConnectorAPI key
  • Multi-year pattern screens over reported annual figures (not a recommendation). Equivalent to several ``screen_companies`` calls intersected. ``pattern="quality_growth"`` (default): passes when revenue CAGR over ``compare_years`` >= ``min_revenue_cagr``, EBIT is positive and its margin improving (checked only where both margins exist), operating cash flow is positive, and the entity type is operating. ``pattern="turnaround"``: prior trouble in T-3..T-1 (losses, EBIT margin down >= 3 pp, or revenue drop) and improvement in the latest fiscal year. Only country, industry, stage, min_revenue_eur and top_n apply. To confirm a candidate, check ``search_filing_content`` for restructuring language. Chart: per the server "Charts" guidance; in ChatGPT call render_chart(source_tool="screen_quality_growers", source_args=<same arguments>, output="python"). Args: country: ``"US"``, ``"FI"``, ``"SE"`` or ``"Nordic"`` (also ``"Nordics"``/``"Scandinavia"``; one call, do not call per country). Omit for all markets. min_revenue_cagr: Minimum revenue CAGR in % (default 10). compare_years: Look-back years (default 3). max_marketcap: Native currency, Nordic only and sparse; on a US or unscoped screen it returns no companies. top_n: Max results (default 20). stage: turnaround only: ``"early"`` or ``"confirmed"``; omit for both. industry: turnaround only, e.g. ``"automakers"``. min_revenue_eur: turnaround only, latest revenue floor (default 20 000 000). Returns ``companies`` with ``quality_metrics`` (revenue_cagr_pct, ebit margins, operating cash flow) and ``coverage``; turnaround rows carry ``turnaround_score`` (0-100), ``stage``, ``signals``, ``prior_trouble``, ``series`` and ``trace``, with thresholds in ``rules``.
    ConnectorAPI key
  • Get a company's revenue split by country and region for one fiscal year: where revenue comes from, market exposure, geographic concentration. For totals, margins or trends use ``get_company_financials``. US (10-K XBRL) and Nordic (HEL, STO; annual reports) companies; values in millions of the reporting currency. Args: company: Name, ticker or CIK, e.g. "Apple", "AAPL"; fuzzy matching. year: Fiscal year; default the most recent annual filing. Interim rows are returned only when no annual disclosure exists, flagged by ``period_basis="interim_fallback"`` and ``period_warning``. Returns: ``countries[]`` (with ISO alpha-2 codes), ``regions[]`` (own labels such as "EMEA", not expanded into countries) and ``other[]`` (the filer's "other countries" bucket, never broken down), each row with ``revenue`` and ``page_id``; plus ``currency``, ``unit``, ``total_revenue``, ``additive_layer`` and ``total_revenue_reconciliation``. Layers overlap (a "Europe" row and a "Germany" row describe the same revenue), so never sum all rows: ``total_revenue`` is the one layer named in ``additive_layer``, and ``total_revenue_reconciliation`` compares it with consolidated revenue for the same period (``difference`` = unallocated revenue). Prefer country rows for analysis; ``period_label`` names the period the rows cover; relay ``period_warning``, ``reconciliation_warning`` and ``overlap_warning`` when present. ``{"error": ...}`` when the company is unknown or has no geography data. Chart: per the server "Charts" guidance (horizontal bars of shares when the split is the point); in ChatGPT call render_chart(source_tool="get_revenue_geography", source_args=<same arguments>, output="python").
    ConnectorAPI key
  • Rank or screen companies by one financial metric ("which S&P 500 companies grew revenue most in 2025?"). For one company use ``get_company_financials``. Chart: per the server "Charts" guidance; in ChatGPT call render_chart(source_tool="screen_companies", source_args=<same arguments>, output="python"). Args: metric: e.g. ``revenue``, ``ebit``, ``ebitda``, ``net_income``, ``operating_cash_flow``, ``free_cash_flow``, ``marketcap``; IFRS line items (``total_assets``, ...); Nordic KPIs (``order_book``, ``equity_ratio``); ratios ``gross_margin``, ``operating_margin``, ``ebit_margin``, ``net_margin``, ``ebitda_margin``, ``fcf_margin`` (0.25 = 25 %). US lacks ``marketcap``, ``free_cash_flow`` (use ``fcf_margin``) and the Nordic KPIs. US ``ebitda`` is operating income + D&A and ``fcf_margin`` is (OCF - capex) / revenue; companies without a D&A or capex line are left out, never zeroed. mode: ``"growth"`` (default, YoY %) or ``"value"`` (alias ``"level"``). year: Anchor fiscal year; omit for the latest with data. compare_years: Growth mode: years back (default 1). country: ``"US"``, ``"FI"``, ``"SE"`` or ``"Nordic"`` (all Nordic issuers in one call; do not call per country). Omit for all; value mode then mixes currencies (use ``value_anchor_eur``). industry: Free-text substring. tag_slugs: precise taxonomy filter. top_n: 1-100 (default 20). direction: ``"desc"`` (default) / ``"asc"``. min_value: Floor on ``value_anchor`` (native currency). include_types: ``"operating"``, ``"holding"``, ``"reit"``, ``"bank"``, ``"investment_vehicle"``; ``["operating"]`` excludes banks/REITs/holdings. index: ``"sp500"``; forces ``country="US"``. ``growth_pct`` is null when a value is negative; use ``trend`` and ``delta_absolute`` instead. Returns ``companies`` (``value_anchor``, ``value_compare``, ``growth_pct``, currency) and ``coverage`` (``total_in_scope``, ``with_data``, ``returned``). Surface ``coverage_warning`` and ``data_quality_warning`` / ``excluded_data_quality`` (rows withheld for an implausible scale or currency change).
    ConnectorAPI key
  • Get a compact snapshot of a COMPANY: key financials, profile summary, entity classification, and latest filings — in a single call. Use this as the quick entry point for company-level questions. For a deeper dossier that also searches filing content, use ``research_company``. For deeper single-aspect dives, follow up with ``get_financial_statement``, ``search_filing_content``, or ``get_revenue_geography``. NOTE: this is unrelated to ``get_filing_snapshot``, which resolves a ``page_id`` into a source URL. Args: company: Company name or ticker (e.g. "Apple", "AAPL"). years: Number of recent years for financials (default 3). identifier: Alias of ``company`` (accepted for client tolerance). ticker: Alias of ``company`` (accepted for client tolerance). name: Alias of ``company`` (accepted for client tolerance). company_id: Instead of a name, the company's id as portfolios returns it ("us-F" for a US issuer, "157" for a Nordic company). Wins over company and cik. cik: Instead of a name, a US issuer's SEC CIK ("37996"). Returns: { "company_name": "Apple Inc.", "display_name": "Apple Inc.", "resolution": {"input": "AAPL", "resolved_name": "Apple Inc.", "market": "us", "ticker": "AAPL", "cik": "0000320193", "confidence": 1.0, "source": "ticker_exact"}, "market": "us", "ticker": "AAPL", "entity_type": "operating", "financials": { ... }, "profile_summary": "...", "latest_filings": [ ... ], "stock_price": { "ticker": "AAPL", "price": ..., "currency": "USD", "trading_date": "...", "source": "...", "freshness_status": "live|recent|stale", "is_usable_for_live_quote": true, "age_trading_days": 0 } } US issuers no longer listed also carry ``listing_status`` (``"delisted"`` / ``"deregistered"``), ``listing_status_date`` and ``listing_status_form`` (e.g. ``"25-NSE"``, ``"15-12G"``); the keys appear only when set. ``stock_price`` is the most recent close from Clarifo's local price stores (delayed, typically T-1) and is attached whenever one exists — check ``freshness_status`` before presenting it as current. For an explicitly live/refreshed quote, follow up with ``get_stock_price`` (optionally ``require_live=true``); for a price chart, ``get_stock_price`` with ``days=N``.
    ConnectorAPI key
  • Resolve one ``page_id`` to a viewable filing source (page PNG or SEC link) for citations. This is a citation tool, not a company tool: for a company overview use ``get_company_snapshot``. ``page_id`` comes from search_filing_content hits and Nordic get_financial_statement cells; pass the bare id, not a ``clarifo://filing/...`` URI. Never print the raw ``page_id`` (or a ``[page_id: ...]`` marker) to the user; cite it as a numbered link to ``citation_markdown``'s URL when ``available=true``, as plain ``citation_label`` text when ``available=false`` (never invent a link to a page with no preview). Args: page_id: Bare page id, e.g. ``"722df34e9f191a97518a8560755cb9e9_20"``. dpi: Render resolution for Nordic PNGs (default 150). include_text: Return the page's full indexed text under ``page_text``. Search excerpts often stop mid-sentence; read the full text before stating what a policy says. adjacent_pages: With include_text, pages on each side (0-2). max_chars_per_page: Default 12000, max 30000 (``truncated: true``). highlight: The figure as printed on the page ("229,4") or a short verbatim quote; ``citation_markdown`` then opens the page with it highlighted. Use it for every figure-level citation. The result says ``highlight_status``: exact (on the page), fuzzy (rounded, rescaled or nearly verbatim), not_found (not on this page: no highlight is drawn; say so) or unavailable (no stored text), with ``highlight_passage``, the paragraph it is in. To show where a document's [n] citation comes from, pass its source_refs page_id and the cited sentence. Returns ``available``, ``kind`` (rendered_png | snapshot_endpoint | edgar_link | viewer_link), ``snapshot_url``, ``company_name``, ``year``, ``document_type``, ``page_number``, ``citation_label``, ``citation_markdown``, ``source_policy``; ``reason`` when unavailable. With include_text: ``page_text`` rows and ``page_text_coverage.missing`` (pages with no indexed text: say so rather than guess).
    ConnectorAPI key