count_company_segment
ChatGPTCount 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_contact_segment
ChatGPTCount 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.
describe_tools
ChatGPTDescribe MCP tool capabilities with names, operation groups, and brief usage hints so external clients can self-discover available routes before calling business endpoints.
find_companies
ChatGPTFind 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_contact_by_email
ChatGPTFind 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.
list_company_contacts
ChatGPTRetrieve 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_segment
ChatGPTList 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_contact_segment
ChatGPTReturn 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_countries
ChatGPTList 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_industries
ChatGPTList 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_industry_groups
ChatGPTList available high-level industry groups with IDs to use in industryGroupIds filters (e.g. Information and communication). Use when broad sector filtering is needed. Free to call; does not consume account balance.
list_job_functions
ChatGPTList available job functions with IDs to use in jobFunctionIds filters. These are role/function categories (e.g. Sales, IT, HR) and are typically more specific than main responsibility areas. Free to call; does not consume account balance.
list_keyword_categories
ChatGPTList all customer-facing company keyword categories (the main taxonomy level) with canonical names and Finnish, Swedish, and English labels. Call this when the user requests a broad business category or when you need to narrow a subcategory search. Copy a returned name into keywordCategoryFilter with level "main". Do not use a localized label as the filter name. This tool does not return internal classification keywords. Free to call; does not consume account balance.
list_main_responsibility_areas
ChatGPTList available main responsibility areas with IDs to use in mainResponsibilityAreaIds filters (e.g. Sales, IT, Marketing). Use for broad functional-role filtering. Free to call; does not consume account balance.
resolve_company_by_domain
ChatGPTResolve companies by exact website domain. Use when you have a verified, exact domain and want a direct lookup. Returns a single resolved company if exactly one match is found (resolvedCompany field set, candidates omitted); if multiple companies share the domain, returns isAmbiguous: true with candidates array. Returns empty results if domain doesn't match exactly. If you need ranking across multiple criteria or have ambiguous input, use find_companies instead. Example: resolve_company_by_domain({ domain: "dynava.com", limit: 5 }). 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.
search_keyword_subcategories
ChatGPTSearch customer-facing company keyword subcategories using canonical, Finnish, Swedish, or English wording. Use search for a specific business activity such as "sopimusvalmistus". Optionally pass canonical mainCategories from list_keyword_categories to narrow ambiguous or broad searches. Copy a returned name into keywordCategoryFilter with level "sub". mainCategories restrict discovery only; do not add them to the segment filter unless the user also requested those broad categories. This tool does not search or return raw keyword text. Free to call; does not consume account balance.
service_info
ChatGPTReturn service pricing, setup steps, multi-user policy, and the authenticated account subscription/quota status.
