SONAR KYB
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SONAR_API_KEY | Yes | Your sk-sonar-... API key | |
| SONAR_API_BASE | No | Override for staging or self-hosted SONAR | https://api.getsonar.report |
| SONAR_API_TIMEOUT | No | Per-request timeout in seconds | 120 |
| SONAR_MCP_LOG_LEVEL | No | DEBUG for verbose logs (stderr) | INFO |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
SONAR runs KYB (Know Your Business) due diligence on vendors, partners and resellers from public records: national company registers, sanctions and PEP lists, offshore-leak records and 10 years of adverse media. It is a due-diligence aid, not a regulated AML/KYC provider: present results as findings for a human to review, never as a compliance decision. Pick the cheapest tool that answers the question: company_lookup (EUR 0.01, only when the company is found; the first 100 found are free) for 'does this company exist / is it registered / is it active or in good standing'; company_officers (same price) for its directors; kyb_findings (EUR 0.50) for sanctions, PEP, offshore-leak, ownership and adverse-media screening; kyb_run_submit (EUR 6.00) only when the user asks for a full written KYB report. Always pass the country (ISO code) and, when known, the registration number and website: without a country no register is searched. Call account_balance before a batch of paid calls. A new account's first findings or report call is free.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| company_lookupA | Check a national company register: does this company exist, is it registered, is it active, is it in good standing? |
| company_officersA | List a company's officers (directors, secretaries, board members) from its national register, current and former, with appointment and resignation dates where the register publishes them. |
| kyb_findingsA | 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. |
| kyb_run_submitA | Order a full written KYB due-diligence report (async). Use ONLY when the user asks for a full or written report: it costs EUR 6.00 per call (a new account's first call is free). For a quick check use company_lookup (EUR 0.01) or kyb_findings (EUR 0.50). |
| adverse_mediaA | Screen a company for negative news, complaints and bad reviews only (10-year news lookback, complaint and review sites). |
| check_report_statusA | Poll the status of an async report submitted via kyb_run_submit. |
| account_balanceA | Check the prepaid balance, the free trial call and the free company lookups left, and this month's calls. Free (no charge). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a distinct role in a tiered KYB funnel (lookup -> findings -> report), and descriptions explicitly steer between them. However, company_officers is fully redundant with company_lookup's include=["officers"], and adverse_media is a strict subset of kyb_findings at the same price, so two pairs can still be misselected without reading the prose.
All snake_case, but the set mixes noun-first names (company_lookup, company_officers, account_balance, adverse_media), a kyb_ prefix family (kyb_findings, kyb_run_submit), and a verb-first outlier (check_report_status). Readable, but there is no single predictable pattern an agent can generalize from.
Seven tools is well within a healthy range and each maps to a real step in a KYB workflow: identity check, officers, screening, adverse media, full report, async polling, and balance. Nothing feels padded, even the two overlapping tools encode a real price/scope tradeoff.
The surface covers the full KYB lifecycle from cheap existence checks through paid screening and an async due-diligence report, plus status polling and prepaid balance. Minor gaps: no fuzzy/partial name search, no standalone filings retrieval, no beneficial-ownership call outside kyb_findings, and no ongoing monitoring.