Global Database

Access comprehensive company data including financial records, ownership structures, and contact information.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

Check Api Key: Verify the API connection and return current user info. Returns: id, first_name, last_name, email, is_active, date_joined, last_seen. Call ONLY when the user explicitly asks whether the
Get Company By Website: Look up a company by website URL or domain. Returns a full company profile. Accepts bare domains (tesco.com) or full URLs (https://tesco.com). Returns the full profile as sourc
Get Company By Linkedin: Look up a company by LinkedIn URL or public ID. Returns a full company profile. Accepts full URLs (linkedin.com/company/global-database) or just the public ID (global-database

What data it sees

Do you need an account

No: the server works without sign-in

Access comprehensive company data including financial records, ownership structures, and contact information. Search for businesses using domains, registration numbers, or LinkedIn profiles to streamline due diligence and lead generation. Retrieve historical financial performance and complex corporate group structures to support informed business analysis.

Server tool list (19)

Raw names from tools/list. Only developers need these.

check_api_key	Verify the API connection and return current user info. Returns: id, first_name, last_name, email, is_active, date_joined, last_seen. Call ONLY when the user explicitly asks whether they are connected / who they are, or to diagnose an [AUTH_REQUIRED] error. Never call it speculatively before a normal lookup — it costs a request and adds nothing to the answer.
get_company_by_website	Look up a company by website URL or domain. Returns a full company profile. Accepts bare domains (tesco.com) or full URLs (https://tesco.com). Returns the full profile as source-bearing field-groups (basic / address / contact / activity / additional / size), each with its own 'source' — cite the distinct sources. The 'id' is top-level. Calling get_company_details afterwards is redundant — this already returns the full profile.
get_company_by_linkedin	Look up a company by LinkedIn URL or public ID. Returns a full company profile. Accepts full URLs (linkedin.com/company/global-database) or just the public ID (global-database). Returns the same source-bearing field-group profile as get_company_by_website (each group carries its own 'source'; 'id' is top-level). Calling get_company_details afterwards is redundant.
get_company_by_identifiers	Look up a company by name, registration number, VAT, ticker, website, email, or LinkedIn. When searching by name, always include country_code for accurate results. Unique identifiers (registration_number, vat_number, ticker, website, email, linkedin) work without country_code. Returns the full profile as source-bearing field-groups (basic / address / contact / activity / additional / size), each with its own 'source' (registry, enrichment, modelled, …) — cite the distinct sources. The 'id' is top-level. Calling get_company_details afterwards is redundant. Use the 'id' for get_company_financials, get_company_ownership, or get_digital_insights.
get_company_details	Get a full company profile by company_id. Returns the same data as get_company_by_website, get_company_by_linkedin, and get_company_by_identifiers. Only useful after prospecting (which returns only id + name) when the user asks for details on a specific result.
get_company_financials	Get company financial data by company_id. Returns balance sheet, ratios, and key metrics per year. Requires a company_id from a previous lookup. If year is provided, returns data for that year only. Otherwise returns all available years. Returns {data: {<year>: {...}}, source: {...}} — per year: currency, employee numbers, share capital, equity, total assets/liabilities, cash, debt ratios, working capital, current ratio, gearing, and YoY changes. The 'source' names the reporting provider — cite it (it is a real provenance, unlike other commercial tools).
get_company_ownership	Get company shareholders and corporate group structure by company_id. Returns: shareholders (list with share types, quantities, values) and group_structure (tree with parent/subsidiary hierarchy).
get_digital_insights	Get a company's digital presence: web traffic, rankings, traffic sources, WHOIS, technologies. Requires a company_id from a previous lookup. Returns: domain, WHOIS, global/country/category ranks, engagement metrics, traffic sources (organic, direct, referral, social, email, paid), geographic breakdown, monthly visit history, technology stack, SEO keywords.
enrich_employee_contacts	Find and enrich an employee/contact. Returns full contact details. Matching rules (at least one combination required): - email alone - linkedin alone (person's profile URL, not company page) - first_name + last_name + company_name - first_name + last_name + domain Returns: id, full_name, first_name, last_name, gender, seniority_level, department, function_original_name (job title), phone, email, company_id, company_name, social media. Extended profile fields are requested by default and returned when the account has the Contact Details permission: country, location, headline, work_experience, educations, skills, company_website, company_linkedin. Without the permission they are simply absent. Both email and phone are always returned in a single call. Present only what the user asked for; if they later ask for the other, it is already in this result — do not re-call.
get_nomenclature	Get nomenclature/lookup values for use with prospecting filters. Each item returned has: id, name, parents, has_children, active. How to use returned values in prospecting filters: - location_countries and location_regions: use the 'parents' field (e.g. '1869197_1869198') — NOT 'id'; the wrong field silently matches nothing - All other filters: use the 'id' field - To drill down hierarchical nomenclatures: pass the item 'id' as parent parameter For 'country', 'company-status', and 'kyb/countries': check the pre-loaded resources (gdb://nomenclature/country, gdb://nomenclature/company-status, gdb://nomenclature/kyb-countries) BEFORE calling this tool — call it only when the resource is not loaded. Search: use the 'search' parameter to find items by name or code in hierarchical nomenclatures. Supported for: industry-focus, isic, nace, sic/{country_code}, country, region, legal-form. Not supported for: kyb/countries, kyb/country/{iso2}/regions, company-status, company-type, activity-type, department, seniority, technology, currency (fetch the full list and filter client-side). Returns matching items with their full parent hierarchy. Example: get_nomenclature('nace', search='6311') returns '6311 - Data processing' with its full tree. Available types: nace, isic, industry-focus, company-status, company-type, legal-form, activity-type, department, seniority, country, region, technology, currency, sic/{country_code} (e.g. sic/gb), kyb/countries, kyb/country/{iso2}/regions. Do not display nomenclature data to the user — use the IDs silently for prospecting.
prospecting	Search and filter companies by country, industry, size, revenue, and many other criteria. Full filter catalog (exact names, value formats, id-vs-parents rules): read the resource gdb://docs/prospecting-filters before building a non-trivial query. Returns: total_companies, total_pages (max 1000), data: [{id, name}]. Before calling, resolve filter values: - location_countries: prefer the pre-loaded resource gdb://nomenclature/country (use the 'parents' field); company_status: prefer gdb://nomenclature/company-status. Fall back to get_nomenclature only if not loaded. - location_regions: use the 'parents' field from get_nomenclature - company_type, legal_form, activity_type, nace, isic, industry_focus: use the 'id' field from get_nomenclature (with search= for hierarchical types) Results are minimal (id + name only). Use get_company_details for full profile on a specific result. When the user asks for "top", "largest", "best", or any ranked query, always add sorting_field and sorting_direction. Available sorting fields: website_alexa_rank, website_monthly_visits, turnover, size_range, modified_date. COST: each call consumes credits. When the user only wants the count, set per_page=1 and read total_companies. Do not page through results speculatively.
kyb_search	Search official government registries for KYB/compliance checks. Requires a location parameter — resolve it from the pre-loaded resource gdb://nomenclature/kyb-countries when available; only fall back to get_nomenclature('kyb/countries') if the resource is not loaded. Returns: list of [{id, name, registration_number, vat_number, country_code, state}]. Use the 'id' for detailed KYB lookups.
kyb_company_details	Get official registry details for a company. Accepts any company_id (from kyb_search or any company lookup). Returns: id, name, registration_number, vat_number, incorporation_date, status, country_code, address, legal_form, website, linkedin.
kyb_officers	Get company directors, secretaries, and officers from official registry. Accepts any company_id (from kyb_search or any company lookup). Paginated. Returns: [{id, first_name, last_name, job_title, appointed_at, date_of_birth_year, address}].
kyb_shareholders	Get company shareholders from official registry. Accepts any company_id (from kyb_search or any company lookup). Returns: [{id, company_id, name, quantity, currency, share_price, share_type, share_value, total_value}].
kyb_shareholders_search	Reverse shareholder lookup — search by holder name across all jurisdictions. The reverse of kyb_shareholders: start from a shareholder's name (person or corporate entity) and find every company they hold a stake in. Useful for UBO discovery and ownership-network mapping. view_mode (default 'full'): - full: holder + linked company plus percentage, quantity, share_type, share_price, share_value, currency, status - lite: holder (name, type) + linked company only Can filter by: company_name, registration_number, vat_number, location_countries (ISO 3166-1 alpha-2, e.g. ['GB']), and ownership percentage range (1-100). Returns: [{name, type, company: {id, name, registration_number, vat_number, address}, percentage, quantity, share_type, share_price, share_value, currency, status}].
kyb_group_structure	Get corporate group structure from official registry. Accepts any company_id. Two modes: - full (default): complete corporate family tree across all levels - lite: immediate parent-subsidiary connections only Defaults to 'full' for the complete hierarchy / UBO mapping. Use 'lite' only when the user just wants the immediate parents and subsidiaries, or to keep the call cheaper. Returns: tree of [{id, name, country, registration_number, selected, children}].
kyb_financial	Get detailed financial statements from official registry across multiple years. Accepts any company_id (from kyb_search or any company lookup). Returns: years (list of reporting dates) and groups — each group has an id, name, and list of financial line items with year-by-year values and progress indicators. Groups: Summary, Income Statement, Balance Sheet, Cashflow, Capital & Reserves, KPIs & Ratios.
kyb_officers_search	Reverse officer lookup — search by person's name across all jurisdictions. Returns all companies where the person holds or held a position. Returns: [{id, company_id, company_name, registration_number, full_name, officer_role, appointed_at, resigned_at, nationality, date_of_birth_year, address, email}]. Can filter by: date_of_birth_year, country_code, status (C=current/P=previous), appointment/resignation date ranges, company_name, company_reg_number, company_status (nomenclature ids), company_countries (ISO alpha-2 list).