NordicContacts

Count matching companies for segment filters without loading company/contact rows. Use this for "how many companies" questions. Free to call; does not consume account balance. Supports webshopStatus, webshopPlatforms, and targetMarket filters. webshopPlatforms is only valid when webshopStatus is "identified" or omitted. Supports company keyword taxonomy filtering through keywordCategoryFilter. Use list_keyword_categories for broad main categories and search_keyword_subcategories for specific business activities. Pass only canonical returned name values; never pass localized labels or raw keywords. Your account exclusion list always applies automatically and cannot be disabled. Optional customerListMode: "exclude" removes companies on your customer list (net-new prospecting), "limit" returns only customer-list companies, "ignore" or omitted ignores the customer list. Exclude/limit require an active customer list managed in the web app (Company lists). Does not support pagination and always returns a total count.

count_company_segment

Count matching contacts for segment filters without loading contact rows. Use this for "how many contacts" questions. Free to call; does not consume account balance. Supports webshopStatus, webshopPlatforms, and targetMarket filters. webshopPlatforms is only valid when webshopStatus is "identified" or omitted. Supports company keyword taxonomy filtering through keywordCategoryFilter. Use list_keyword_categories for broad main categories and search_keyword_subcategories for specific business activities. Pass only canonical returned name values; never pass localized labels or raw keywords. Your account exclusion list always applies automatically and cannot be disabled. Optional customerListMode: "exclude" removes companies on your customer list (net-new prospecting), "limit" returns only customer-list companies, "ignore" or omitted ignores the customer list. Exclude/limit require an active customer list managed in the web app (Company lists). Does not support pagination and always returns a total count.

count_contact_segment

Describe MCP tool capabilities with names, operation groups, and brief usage hints so external clients can self-discover available routes before calling business endpoints.

describe_tools

Find companies by internal companyId, business ID, website domain, or company name. companyId is the internal database ID returned as id in company records or companyId in contact rows, not the business registration ID. Use find_companies({ companyId: 12345 }) to retrieve full details for a previously returned company ID. When provided, companyId takes precedence over other identifiers; countryId still restricts the lookup. Intended for identity resolution only (typically 1-3 best matches), not bulk retrieval. Returns resolvedCompany with match score and match type for an unambiguous match, omitting candidates. Otherwise returns ranked candidates with match scores and match types and includes ambiguity detection when name-based searches have multiple plausible matches. Example: find_companies({ companyName: "Dynava", limit: 3 }). Use the domain field here when combining identifiers or when candidate ranking/ambiguity handling is needed. For direct domain-to-company lookup only, prefer resolve_company_by_domain. For bulk company retrieval use list_company_segment. Consumes the account's shared subscription balance (the same balance used by subscribed Excel exports and REST API usage: included monthly contacts first, then prepaid top-up contacts). A completed call always costs at least 1 unit. Costs 1 company unit for a resolved match, or 1 unit per returned candidate when the result is ambiguous.

find_companies

Find one individual contact from a known email address. Always returns at most 1 row. Consumes the account's shared subscription balance (the same balance used by subscribed Excel exports and REST API usage: included monthly contacts first, then prepaid top-up contacts). A completed call always costs at least 1 unit. Costs exactly 1 contact unit per completed call.

find_contact_by_email

Retrieve contacts that belong to one company. Returns full company details once in resolvedCompany, omitting candidates, and compact contact rows with person fields and companyId only. Supports deterministic pagination with limit and offset. If companyName matches multiple companies, returns isAmbiguous=true and candidates instead of contacts; resolve by re-calling with companyId or businessId. Example: list_company_contacts({ companyName: "Dynava Oy", contactInfoFilter: "both", limit: 25, offset: 0 }). Use a small limit (e.g. 3) when fetching sample rows to minimise cost. Consumes the account's shared subscription balance (the same balance used by subscribed Excel exports and REST API usage: included monthly contacts first, then prepaid top-up contacts). A completed call always costs at least 1 unit. Costs 1 contact unit per returned contact.

list_company_contacts

List companies matching the given segment criteria (country, industry, size, new contacts, webshop and target market, etc.). Consumes the account's shared subscription balance (the same balance used by subscribed Excel exports and REST API usage: included monthly contacts first, then prepaid top-up contacts). A completed call always costs at least 1 unit. Costs 1 company unit per returned company row. Returns paginated, deterministically ordered company rows with source classification attributes (hasWebshop, webshopPlatform, targetMarket). Supports webshopStatus, webshopPlatforms, and targetMarket filters. webshopPlatforms is only valid when webshopStatus is "identified" or omitted. Supports company keyword taxonomy filtering through keywordCategoryFilter. Use list_keyword_categories for broad main categories and search_keyword_subcategories for specific business activities. Pass only canonical returned name values; never pass localized labels or raw keywords. Your account exclusion list always applies automatically and cannot be disabled. Optional customerListMode: "exclude" removes companies on your customer list (net-new prospecting), "limit" returns only customer-list companies, "ignore" or omitted ignores the customer list. Exclude/limit require an active customer list managed in the web app (Company lists). Example: list_company_segment({ countryId: -2460, companyContactFilter: "email", limit: 100, offset: 0 }). For count-only questions, prefer count_company_segment.

list_company_segment

Return a filtered contact segment using the same criteria as the web search page. Consumes the account's shared subscription balance (the same balance used by subscribed Excel exports and REST API usage: included monthly contacts first, then prepaid top-up contacts). A completed call always costs at least 1 unit. Costs 1 contact unit per returned contact row. Results are deterministically ordered and support limit/offset pagination. Response meta includes companyCount (number of distinct companies represented by matching contacts). Returned contact rows include person fields (name, title, email, phone, responsibility areas), compact employer context (companyId, companyName, countryName, region, city, wwwpage, industryName), and source classification attributes (hasWebshop, webshopPlatform, targetMarket). Full company descriptions, financials, and address details are omitted; use find_companies or list_company_segment for full company details. Supports webshopStatus, webshopPlatforms, and targetMarket filters. webshopPlatforms is only valid when webshopStatus is "identified" or omitted. Supports company keyword taxonomy filtering through keywordCategoryFilter. Use list_keyword_categories for broad main categories and search_keyword_subcategories for specific business activities. Pass only canonical returned name values; never pass localized labels or raw keywords. Your account exclusion list always applies automatically and cannot be disabled. Optional customerListMode: "exclude" removes companies on your customer list (net-new prospecting), "limit" returns only customer-list companies, "ignore" or omitted ignores the customer list. Exclude/limit require an active customer list managed in the web app (Company lists). For count-only questions, prefer count_contact_segment. Example: list_contact_segment({ countryId: -2460, contactInfoFilter: "both", organizationLevels: ["Top Management"], limit: 50, offset: 0 }).

list_contact_segment

List available supported countries (Finland, Sweden, Estonia) with IDs to use in countryId filters. Use when building geography-based segments before calling segment/count tools. Free to call; does not consume account balance.

list_countries

List detailed industry codes for a specific country. Each country uses its own classification system: Finland (countryId -2460) uses TOL 2025, Sweden (countryId -7520) uses SNI 2025, Estonia (countryId -2330) uses EMTAK 2025. Always pass countryId matching the country you are segmenting — the code sets differ between countries. Returns string IDs (e.g. "62100" = Computer programming in Finland) required for the industryCodes filter on segment tools. The industryCodes filter matches by prefix, so shorter IDs (e.g. "62") match every industry whose code starts with them. Use offset to paginate large result sets (e.g. first call offset: 0, next offset: 200) or search by English names, codes, and Finnish/Swedish names where available (e.g. "programming", "ohjelmisto", or "datakonsult"). Free to call; does not consume account balance.

list_industries