kyb_findings
Screen a company for KYB risk by checking sanctions, PEP, offshore-leak, regulatory, beneficial-owner, adverse-media, and company-register records; use it to vet partners before onboarding.
Instructions
Screen a company for KYB risk: sanctions and PEP matches, offshore-leak records, regulatory records, beneficial owners and adverse media, plus the company register's answer (registry_match, good standing). Structured findings, each naming the kind of source; no AI-written summary.
Use this for "screen / vet / check X for sanctions, PEP or bad
press". For only "does it exist / is it active", company_lookup is
far cheaper. Usually 30-90 s (the tool waits for queued results).
Price: EUR 0.50 per call, charged even when nothing is found (a new
account's first call is free). Rate limit: 10 calls a minute per key.
Args:
company_name: Legal name of the company (e.g. "Tesco PLC")
website: Company website URL (http/https), strongly recommended:
it separates the company from others with a similar name
country: ISO 3166-1 alpha-2 country of registration. Without it
no company register is searched (registry_match NOT_SEARCHED)
registration_number: The register's company number; needs country
state: US only: 2-letter state of formation
vat_number: VAT number with its country prefix, e.g. "DE123456789"
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": {
"company_name": "<company_name>"
},
"name": "kyb_findings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | ||
| country | No | ||
| website | No | ||
| vat_number | No | ||
| company_name | Yes | ||
| registration_number | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |