company_lookup
Verify company existence, registration, active status, and good standing in official national registers by exact legal name or registration number.
Instructions
Check a national company register: does this company exist, is it registered, is it active, is it in good standing?
Use this first for any "is X a real / registered / active company"
question; it is the cheapest call. One live search of the official
register, about a second. Returns FOUND / NOT_FOUND / AMBIGUOUS with
the full register record: legal name, number, status (active /
inactive), good_standing (overdue filings, strike-off, insolvency),
legal form, incorporation date, address, VAT number, previous names,
US registered agent. The name must match exactly (case, punctuation
and legal-form spelling aside); a look-alike name is NOT_FOUND.
No sanctions, PEP or adverse-media screening: use kyb_findings.
Price: EUR 0.01 only when the company is found (the first 100 found
lookups per account are free); NOT_FOUND costs nothing.
Countries: GB, FR, CZ, SK, NO, FI, CH, EE, LV, US (by name or number);
PL, BE, BR by registration_number only. US needs `state` (NY, CO, OR,
CT, TX, PA, FL).
Args:
country: ISO 3166-1 alpha-2 code of the register, e.g. "GB"
company_name: Exact legal name, e.g. "Tesco PLC". Optional when
registration_number is given
registration_number: The register's number (GB company number,
FR SIREN, CZ / SK ICO, NO orgnr, PL KRS, ...). Matched
exactly; decides alone when given. Prefer it when known
state: US only (required there): 2-letter state code
include: Also return the found company's "officers" (GB, CZ, SK,
NO, FR) and / or latest "filings" (GB, FR), at no extra cost
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country": "<country>"
},
"name": "company_lookup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | ||
| country | Yes | ||
| include | No | ||
| company_name | No | ||
| registration_number | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |