MCP-Server
FirmaDB — European Company Data
com.firmadb/company-data
Was dieses MCP kann
Searches, retrieves, verifies, and enriches European company registry records for business checks, CRM workflows, and due diligence.
Funktionen
Tools
6
Tools
firmadb_check_coverage
Check FirmaDB country and field coverage before planning a lookup, enrichment, or compliance workflow. Use this when an agent needs to know whether fields such as employee_count, nace_code, dissolution_date, website, or source_url are populated for a country. Returns supported countries, field availability percentages, freshness class, known limitations, and recommended fallback behavior. Cheap, cacheable. Do NOT use this to retrieve company records — call search/get/verify/enrich tools for company data.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'country': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': 'ISO alpha-2. Omit for all countries.'}}, 'additionalProperties': False}
firmadb_enrich_companies
Enrich a list of up to 100 companies in one synchronous call. Each input row must include a (country, registry_id) pair. Returns per-row match_status, the company record, and any error as an embedded RFC 9457 problem. Designed for CRM enrichment, due-diligence batches, and KYB screens. For more than 100 rows, split client-side and call firmadb_estimate_cost first. Idempotent: pass an idempotency_key (UUID) to safely retry without double-billing. Pricing: per verified match. References that 404 are not billed.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['references', 'idempotency_key'], 'properties': {'include': {'type': 'array', 'items': {'enum': ['field_meta', 'provenance'], 'type': 'string'}}, 'references': {'type': 'array', 'items': {'type': 'object', 'required': ['country', 'registry_id'], 'properties': {'country': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'registry_id': {'type': 'string', 'maxLength': 50, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1}, 'idempotency_key': {'type': 'string', 'maxLength': 255, 'minLength': 1}}, 'additionalProperties': False}
firmadb_estimate_cost
Estimate billable units and rate-limit impact for a planned FirmaDB job before running it. Use this before batch enrichment or any agent workflow where the user might be charged for many results. Returns estimated min/max cost, billable unit, free quota impact, and whether human approval is recommended. Does NOT bill anything. Final billing depends on actual matched results and account plan.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['operation', 'estimated_records'], 'properties': {'countries': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Z]{2}$'}}, 'operation': {'enum': ['get', 'search', 'verify_status', 'enrich'], 'type': 'string'}, 'estimated_records': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
firmadb_get_company
Retrieve one FirmaDB company record by exact (country, registry_id). Use this after firmadb_search_companies has identified the target, or when the user already has an official national registry identifier (FR SIREN, GB CRN, SE organisationsnummer, etc.). Returns canonical identity, legal status, address, NACE classification (where collected), employee count (where collected), website, source URL, and data_freshness. Do NOT use this for fuzzy name lookup — call firmadb_search_companies first. Field coverage varies by country; if a field is missing the response explains whether it is not_published_by_registry, not_collected, or unknown.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['country', 'registry_id'], 'properties': {'country': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': 'ISO 3166-1 alpha-2 country code, uppercase.'}, 'include': {'type': 'array', 'items': {'enum': ['field_meta', 'provenance'], 'type': 'string'}, 'description': 'Optional expansions.'}, 'registry_id': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': 'National registry identifier. Leading zeros are significant.'}, 'include_nulls': {'type': 'boolean', 'default': False}}, 'additionalProperties': False}
firmadb_search_companies
Search FirmaDB's European company index by name, registry identifier, or address fragment. Use this when you DON'T have a registry_id but you have a name, address, NACE code, or industry term. Returns ranked candidates with confidence scores and matched_fields. Use BEFORE firmadb_get_company when the user gave you a name like "Acme Holdings" rather than a registry number. Top result is usually correct for distinctive names; for common names ("ABC Trading") inspect scores and addresses to disambiguate. Filter by country when known — searches without a country filter scan all 19 partitions, are slower, and return max 10 results. Cross-country structured filters (NACE, employee_count) are not supported and return an error with the precise workaround. Returns a JSON list: `data[]` of company objects each with a `match` block (score 0..1, matched_fields, explanation), plus total_count, has_more, next_cursor.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['q'], 'properties': {'q': {'type': 'string', 'maxLength': 200, 'minLength': 3}, 'nace': {'type': 'string', 'description': 'NACE code prefix. Requires country.'}, 'sort': {'enum': ['relevance', 'name_asc', 'name_desc', 'registered_date_asc', 'registered_date_desc'], 'type': 'string'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1}, 'cursor': {'type': 'string'}, 'status': {'enum': ['active', 'dissolved', 'liquidation', 'deregistered', 'bankrupt', 'deleted', 'unknown', 'any'], 'type': 'string', 'description': 'Canonical status filter (one of the 7 canonical status values). `any` disables the filter.'}, 'country': {'type': 'string', 'description': 'ISO alpha-2. Comma-separated for multi-country (FR,BE).'}, 'include': {'type': 'array', 'items': {'enum': ['field_meta', 'provenance'], 'type': 'string'}}, 'registered_date_to': {'type': 'string', 'format': 'date'}, 'registered_date_from': {'type': 'string', 'format': 'date'}}, 'additionalProperties': False}
firmadb_verify_status
Verify whether a company is active, dissolved, in liquidation, deregistered, bankrupt, deleted, or unknown in FirmaDB's latest government-sourced data. Use this for KYB, vendor checks, CRM hygiene, and any agent workflow that needs a compact decision rather than a full company profile. Returns a JSON object with: country, registry_id, name, status (one of the 7 canonical values), status_active (bool), dissolution_date (or null), source_url, data_freshness, confidence ('registry' or 'unknown'), and request_id. Do NOT treat unknown as active; ask for human review or use the source URL.
Nur Lesen
Externer Zugriff
Eingabeschema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['country', 'registry_id'], 'properties': {'country': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'registry_id': {'type': 'string', 'maxLength': 50, 'minLength': 1}}, 'additionalProperties': False}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
firmadb_estimate_cost
3. October 2026 02:40
Hinzugefügt
firmadb_check_coverage
3. October 2026 02:40
Hinzugefügt
firmadb_enrich_companies
3. October 2026 02:40
Hinzugefügt
firmadb_verify_status
3. October 2026 02:40
Hinzugefügt
firmadb_search_companies
3. October 2026 02:40
Hinzugefügt
firmadb_get_company
3. October 2026 02:40
Entdecken
Ähnliche MCP-Server
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Intelligence
com.stratalize/intelligence
Provides vendor, market, SaaS, workforce, government contract, public company, regulatory, competitive, and AI-brand intelligence…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…