read scope covers all content tools and is granted by default. The read:watchlist scope covers the watchlist tools. See how to connect your AI client for setup instructions.
Available tools
If a tool does not appear when listing available tools, check that the required scope is granted on your connection. The
read scope covers all content tools and is granted by default.Tool parameters and usage
Three parameters filter by country, and they do not mean the same thing. Onsearch_events, search_articles, and search_stories, country is the country of the source that reported the news. market is the country whose exchanges a company is listed on, so SE covers Nasdaq Stockholm, First North, Spotlight, and NGM together, and it includes issuers that list locally but are registered abroad. domicile is where a company is legally registered, which reaches unlisted companies. On search_companies, country and domicile mean the same thing. All three take comma-separated ISO 3166-1 alpha-2 codes.
ticker and company select companies directly. Both take a comma-separated list of up to 25 values and match any of the companies named. Every value has to resolve to a company the API publishes: one unknown ticker or ID fails the whole call with Unknown ticker(s): VOLVB, naming each value it could not resolve, rather than silently returning fewer companies. Ticker matching is case-insensitive, and exchange-suffixed and former tickers resolve. Send ticker and company together and they intersect.
On search_companies those two parameters are the batch route from an ID back to a name. Pass the company_id or company_ids values another tool returned and resolve up to 25 of them in one call, rather than one get_company per company. Rows arrive in name order rather than the order you asked for, and a ticker shared by more than one issuer resolves to every match, where get_company tie-breaks to one.
search_events
Search and filter events. An event groups related coverage of one development, such as an earnings report, an acquisition, or a CEO change, with the source articles attached. For scheduled dates, such as upcoming earnings or AGMs, usesearch_calendar_events instead.
Results are sorted most recently reported first. Unlike on search_articles, q filters rather than ranks, so results keep that order and page with a cursor. Every significance tier is returned unless you filter on significance.
Additional filters include
country, category, sources, source_type, content_type, market, domicile, exchange, index, sector, listed, watchlist, related_to, last_article_after, and last_article_before. mode="semantic" matches q by meaning and returns a single ranked page with no cursor.
get_company_news
Return one company’s events over a time window in a single call, grouped by event type, with a count for each type. The digest arrives as markdown incontent, with the same data in structuredContent. There is no REST equivalent.
The counts cover the whole window, even when
limit cuts the list of events short.
search_articles
Search and filter Nordic articles by their English headlines, summaries, and key points.
Additional filters include
sources, company, index, sector, and watchlist. company takes comma-separated company IDs on the same terms as ticker.
search_stories
Search AI-generated event summary stories.
Additional filters include
sources, company, index, sector, and watchlist. company takes comma-separated company IDs on the same terms as ticker.
search_companies
Search companies by name or ticker symbol.search_calendar_events
Search the Nordic financial calendar: earnings reports, earnings calls, dividends, shareholder meetings (AGMs and EGMs), capital markets days, IPOs, and M&A milestones. By default, returns upcoming events from today onward, sorted by date.get_event
Retrieve one event by ID. On a merged or removed event, it returns a tombstone carrying onlyid, status, merged_into, and updated_at.
depth="full" saves the follow-up calls an agent would otherwise make to understand an event: get_article on the disclosure, get_story, search_events with related_to, and a second get_event for the event a commentary piece reacts to. Alongside the event, it returns:
primary_disclosure: the summary and key points of the earliest official sourcearticles: a compact list of member articles, oldest first, at most 25.articles_truncatedis true when there are morestory: the newest published story about the eventrelated_event: for a commentary event, the factual event it reacts tocommentary: the commentary events reacting to this one, newest first, at most 10.countis the total your plan can reach
primary_disclosure, story and related_event are null when there is none your plan can reach. Both depths return the event in structuredContent; full also returns a markdown rendering in content.
get_article, get_story, get_calendar_event
Retrieve the full details of a single record by ID.get_company
Look up a company by ID or ticker symbol.list_watchlist
Return the companies on your watchlists. Omitwatchlist_id to list every company you follow across all of your watchlists, with each company listed once. Pass a watchlist_id to scope the results to a single list. Requires the read:watchlist scope.
Reference data tools
list_countries, list_categories, list_event_types, list_exchanges, list_stock_indices, list_sources, and list_watchlists return reference data. They take no required parameters. list_event_types takes no parameters, including limit, and returns every event type in one response.
list_exchanges, list_stock_indices, and list_sources also accept filters: country for list_exchanges and list_sources, and exchange for list_stock_indices.