SONAR KYB
SONAR KYB is an MCP server for company due diligence: register lookups, officers, sanctions/PEP/offshore-leak/adverse-media screening, and full KYB reports.
company_lookup— check a national company register (GB, FR, CZ, SK, NO, FI, CH, EE, LV, US by name/number; PL, BE, BR by number): existence, active status, good standing, legal form, address, VAT number, previous names; optionally officers and filings. €0.01 when found (first 100 free).company_officers— list current and former directors/secretaries/board members with appointment and resignation dates (GB, CZ, SK, NO, FR). €0.01 when found.kyb_findings— structured KYB screening: sanctions and PEP matches, offshore leaks (Panama/Paradise/Pandora), regulatory records, beneficial owners, adverse media, plus register answer. €0.50/call, ~30–90 s.kyb_run_submit— order a full written KYB due-diligence report asynchronously, returning arun_id. €6.00/call.check_report_status— poll a submitted report until complete and get a summary (verdict, risk level, PASS/REVIEW/FLAG checks, risk flags, directors). Free.adverse_media— negative news, complaints and reviews only (10-year lookback). €0.50/call.account_balance— check prepaid balance, free trial call and free lookups remaining, and monthly usage. Free.Works with Claude Desktop, Claude Code, Cursor, Windsurf and other MCP clients; pay-per-call with a
sk-sonar-...API key, plus a free sandbox test key for lookups.
getsonar-mcp
MCP server for SONAR: KYB due diligence on vendors, partners and resellers, callable from your AI assistant.
Ask Claude, Cursor or Windsurf whether a company exists and is in good standing, or to screen it, and it gets back the official register record, sanctions and PEP matches, ICIJ Offshore Leaks hits and adverse media, each finding naming the kind of source it came from.
SONAR is a due-diligence aid built on public records. It is not a regulated AML/KYC provider and its output is not a compliance decision: a human reviews the findings.
Features
Company register lookup: a live search of the official register in about a second (GB, FR, CZ, SK, NO, FI, CH, EE, LV, US states; PL, BE, BR by number): exists or not, active, good standing, legal form, address, VAT number, previous names, officers and filings. €0.01 only when the company is found
Company registries in the KYB check: official company registries in 10+ countries for legal name, number, status, address, officers and owners
Sanctions and PEP screening: native OFAC, UN, UK OFSI and Swiss SECO lists plus the OpenSanctions aggregator
ICIJ Offshore Leaks: Panama, Paradise and Pandora Papers, Bahamas Leaks
Regulatory registers: UK FCA Register, UK Disqualified Directors, The Gazette insolvency notices
Adverse media: 10-year lookback on news, complaints and reviews
Three call shapes: a register lookup (about 1 s), structured screening findings (30-90 s; the tools poll the API's 202 + poll URL for you) or a full written report (async, about 3 min)
Works with Claude Desktop, Claude Code, Cursor, Windsurf and any other Model Context Protocol client. Listed in the official MCP Registry as io.github.Ivanolegvak/sonar-mcp.
Related MCP server: Concept-4 Compliance Engine
Pricing
The API is pay per call:
Call | Price |
Company lookup ( | €0.01 when the company is found, free when not; the first 100 found are free |
| €0.50 |
| €6.00 |
| free |
Your first API call is free (a findings or report call; lookups have their own 100 free). After that, calls are paid from a prepaid balance: top up from €5 at getsonar.report/developer/keys. Plans and the web app's free tier are on getsonar.report/pricing.
Get an API key
Sign up at getsonar.report
Open Developer → API keys
Click Create API Key and copy the
sk-sonar-...key
Installation
You need uv (it provides uvx). Nothing else to install: uvx getsonar-mcp fetches and runs the latest release. With pipx instead: pipx install getsonar-mcp, then use getsonar-mcp as the command.
The key goes in the SONAR_API_KEY environment variable of the server process.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"sonar": {
"command": "uvx",
"args": ["getsonar-mcp"],
"env": {
"SONAR_API_KEY": "sk-sonar-YOUR_KEY_HERE"
}
}
}
}Restart Claude Desktop. The seven SONAR tools appear in the tools menu. If they don't, Claude Desktop may not find uvx on its PATH: replace "uvx" with the full path that which uvx prints (e.g. /Users/you/.local/bin/uvx).
Claude Code
claude mcp add sonar --env SONAR_API_KEY=sk-sonar-YOUR_KEY_HERE -- uvx getsonar-mcpAdd --scope user to make it available in every project. Check it with claude mcp list.
Cursor
Edit ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"sonar": {
"command": "uvx",
"args": ["getsonar-mcp"],
"env": {
"SONAR_API_KEY": "sk-sonar-YOUR_KEY_HERE"
}
}
}
}Windsurf
Edit ~/.codeium/windsurf/mcp_config.json (or Windsurf Settings → Cascade → MCP servers → View raw config):
{
"mcpServers": {
"sonar": {
"command": "uvx",
"args": ["getsonar-mcp"],
"env": {
"SONAR_API_KEY": "sk-sonar-YOUR_KEY_HERE"
}
}
}
}Other clients (Continue.dev, Zed, Cline, ...) take the same command, args and env; see your client's MCP docs for where the config lives.
Configuration
Variable | Default | Purpose |
| (required) | Your |
|
| Override for staging or self-hosted SONAR |
|
| Per-request timeout in seconds |
|
|
|
Tools
Tool | What it does | Price |
| Register check: does the company exist, is it active and in good standing | €0.01 if found |
| A company's officers from its register, current and former | €0.01 if found |
| KYB screening: sanctions, PEP, owners, adverse media and the register | €0.50 |
| Submit a full KYB report, returns a | €6.00 |
| Negative news, complaints and reviews | €0.50 |
| Poll a report submitted with | free |
| Balance, free calls and free lookups remaining | free |
All tools return Markdown for the model to read. Which one to use:
"Does this company exist / is it registered / is it active?":
company_lookup(€0.01)"Who are its directors?":
company_lookupwithinclude: ["officers"], orcompany_officers(€0.01)"Screen it for sanctions, PEP, offshore leaks or bad press":
kyb_findings(€0.50)"Give me a full written KYB report":
kyb_run_submitthencheck_report_status(€6.00)
company_lookup
Input:
{ "country": "GB", "company_name": "Tesco PLC", "include": ["officers", "filings"] }country (ISO code) is required, plus company_name or registration_number (a number is matched exactly and decides alone; PL, BE and BR take a number only). state is required for the US (NY, CO, OR, CT, TX, PA, FL, IA, DC). include is optional and free: officers (GB, CZ, SK, NO, FR) and filings (GB, FR) of the found company.
The name rule is strict: case, punctuation, accents and the spelling of the legal form are set aside, any other difference is another company, so a look-alike name is NOT_FOUND.
Output: a headline, then the API's full JSON answer (every field, nothing dropped):
# Company lookup: Tesco PLC (GB): **FOUND**
- TESCO PLC (00445790): active (register: active)
- Good standing: yes (active, no default or insolvency marker on the register)
- Charged: €0.01 · Free lookups left: 0
Full answer:
{"query": ..., "status": "FOUND", "matches": [{"name": "TESCO PLC", "good_standing": true, "officers": [...], "filings": [...], ...}], "truncated": null, "coverage_note": null, ...}good_standing is false when the company is closed or the register marks a default or insolvency (GB: accounts or confirmation statement overdue, strike-off pending), and null where the register publishes no such markers. truncated: true (FR) means the register holds more companies of the name than it returned: search by number. coverage_note (US) says what the state register holds, so a NOT_FOUND reads for what it is.
company_officers
Input:
{ "country": "GB", "registration_number": "00445790" }Output: a headline (current and former officer counts, price) and the full JSON: name, role, person or company, appointed_on, resigned_on. GB, CZ, SK, NO, FR. Priced like a lookup.
kyb_findings
Input:
{ "company_name": "Tesco PLC", "website": "https://www.tesco.com", "country": "GB", "registration_number": "00445790" }company_name is required. Pass country (and state for the US): without it no company register is searched and the answer says NOT_SEARCHED. registration_number and vat_number are optional. website is optional but strongly recommended: it separates the company from unrelated ones sharing the name.
Output (abridged, values illustrative):
# KYB Screening: Tesco PLC
Sources checked: 42 · Processing time: 41250ms
## Company register: **FOUND** (GB)
- Registered name: TESCO PLC
- Number: 00445790
- Status: active
- Good standing: yes (active, no default or insolvency marker on the register)
**Found data**: corporate_registration, directors_officers, adverse_media
**Checked, clean** (the check ran and returned nothing about the company): sanctions_screening, offshore_leaks
## Corporate Registration (confidence: HIGH)
- **TESCO PLC (00445790), active**
Public limited company
Source: company_registerEach finding names the kind of source (company_register, sanctions_lists, offshore_records, news_search, ...); news articles keep their link.
kyb_run_submit
Input: same as kyb_findings. Output:
Report submitted.
- Run ID: `3f6c...`
- Status: pending
- Estimated time: 90 seconds
Call `check_report_status` with run_id='3f6c...' and agent_type='kyb-diligence' in 30-60 seconds to get the result.check_report_status
Input:
{ "run_id": "3f6c...", "agent_type": "kyb-diligence" }agent_type is kyb-diligence (default) or adverse-media. While the report runs it answers Report status: running. Still processing, check again in 15-30 seconds.; when done it returns a compact summary: overall verdict and risk level, company details, a PASS / REVIEW / FLAG table of checks, risk flags, directors and sanctions coverage.
adverse_media
Input: same as kyb_findings. Output: the same Markdown shape as kyb_findings, limited to news, complaints and review sites (no sanctions or PEP screening).
account_balance
Input: none. Output:
# Account usage: 2026-11
- Calls this month: **0**
- Free trial calls remaining: **1** (granted once at signup)
- Pre-paid balance: **€5.00**
- Free company lookups remaining: **100** (spent only when a lookup finds the company)Example prompts
"Is Tesco PLC an active UK company in good standing? Who are its directors?"
The model calls company_lookup with country: "GB" and include: ["officers"]: one call, €0.01.
"Run a KYB check on Tesco PLC (tesco.com) and tell me if anything needs a closer look."
The model calls kyb_findings, reads the structured findings and points out sanctions, register or adverse-media hits with their kind of source.
"Get a full KYB report on Wise Payments Limited and summarise it when it's done."
The model calls kyb_run_submit, then check_report_status until the report is complete.
"How many free trial calls do I have left?"
The model calls account_balance.
Verify your install
The MCP Inspector starts the server and lists its tools:
SONAR_API_KEY=sk-sonar-YOUR_KEY_HERE npx @modelcontextprotocol/inspector uvx getsonar-mcpListing tools works without a key; calling one needs a valid key.
Test without paying (sandbox key)
Create a test key (sk-sonar-test-...) on Developer → API keys and put it in SONAR_API_KEY. It answers company_lookup, company_officers and account_balance with fixed, made-up scenarios, never calls a register and is never charged:
| Number | Answer |
SONAR Sandbox Found Ltd | 1 | FOUND, active |
SONAR Sandbox Dissolved Ltd | 2 | FOUND, inactive |
SONAR Sandbox Ambiguous Ltd | AMBIGUOUS | |
SONAR Sandbox Unavailable Ltd | 3 | 503, register unavailable |
anything else | any other | NOT_FOUND |
The number must still be in the country's format (for GB, 00000001). A test key cannot run kyb_findings, adverse_media or kyb_run_submit (403 SANDBOX_KEY).
Use the API without MCP
The MCP server is a thin client over the SONAR REST API. To call it directly:
export SONAR_API_KEY=sk-sonar-YOUR_KEY_HERE
# Register lookup: about 1 s, €0.01 when found (100 free), free when not
curl -X POST 'https://api.getsonar.report/v1/companies/lookup' \
-H "X-API-Key: $SONAR_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"country":"GB","company_name":"Tesco PLC","include":["officers"]}'
# Structured findings: 30-90 s, €0.50. 200 within ?wait= s (default 120),
# else 202 {"job_id", "poll_url"}: GET the poll_url until 200
curl -X POST 'https://api.getsonar.report/v1/agents/kyb-diligence/findings' \
-H "X-API-Key: $SONAR_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"company_name":"Tesco PLC","website":"https://www.tesco.com","country":"GB"}'
# Full report: async, about 3 min, €6.00; returns {"run_id": ..., "status": "pending"}
curl -X POST 'https://api.getsonar.report/v1/agents/kyb-diligence/run' \
-H "X-API-Key: $SONAR_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"company_name":"Tesco PLC","website":"https://www.tesco.com"}'
# Poll until status is "completed"
curl 'https://api.getsonar.report/v1/agents/kyb-diligence/run/RUN_ID' -H "X-API-Key: $SONAR_API_KEY"
# Usage, balance and free trial calls left
curl 'https://api.getsonar.report/v1/usage' -H "X-API-Key: $SONAR_API_KEY"Agents: kyb-diligence (registries, sanctions, PEP, UBOs, adverse media) and adverse-media (negative news only). The website field must be an http:// or https:// URL. Full OpenAPI spec: api.getsonar.report/docs. Developer guide: getsonar.report/developers.
Troubleshooting
Tools don't appear: check the config file is valid JSON, restart the client, and run uvx --version in a terminal to confirm uv is installed.
401 Unauthorized: SONAR_API_KEY is missing or wrong. Check it at getsonar.report/developer/keys.
402 Payment Required: your free first call (or your 100 free lookups) is used and your balance is too low. Top up from €5 at getsonar.report/developer/keys.
403 SANDBOX_KEY: a test key only runs company_lookup, company_officers and account_balance. Use a live key for screening and reports.
429: rate limit. kyb_findings, adverse_media and kyb_run_submit allow 10 calls a minute per key by default; lookups allow at least 120.
registry_match: NOT_SEARCHED in kyb_findings: pass country (and state for the US).
Timeouts: raise SONAR_API_TIMEOUT. A full report can take 3+ minutes; poll with check_report_status rather than waiting on one call.
uvx getsonar-mcp runs an old version: uvx caches environments. Run uvx getsonar-mcp@latest once, or uv cache clean getsonar-mcp.
Wrong company in the results: pass country and registration_number (or website). Short brand names collide with unrelated companies in news search; SONAR drops those collisions when it knows the domain.
Development
uv sync
uv run pytest # stdio smoke test and formatter tests against a fake API, no networkMaintainers: ARCHITECTURE.md covers the module layout and the stdio / HTTP transports; DIRECTORIES.md covers releasing and listing in MCP directories.
Support
Email ivan@getsonar.report or open an issue on GitHub.
License
MIT, see LICENSE.
Available Tools
7 toolsaccount_balanceARead-only
Check the prepaid balance, the free trial call and the free company lookups left, and this month's calls. Free (no charge).
Call it before a batch of paid calls to know whether they will be
free, paid or refused (402). Prices: company_lookup and
company_officers EUR 0.01 when found (100 free per account),
kyb_findings / adverse_media EUR 0.50, kyb_run_submit EUR 6.00. A new
account's first findings or report call is free.
Inputs: no named parameters. Returns: result
adverse_mediaARead-only
Screen a company for negative news, complaints and bad reviews only (10-year news lookback, complaint and review sites).
No register, sanctions or PEP screening: kyb_findings covers those
and adverse media at the same price, so prefer it unless the user
wants news and reviews only.
Price: EUR 0.50 per call (a new account's first call is free).
Args:
company_name: Company to screen
website: Company website URL for accuracy
Inputs: company_name (required), website. Returns: result
check_report_statusARead-only
Poll the status of an async report submitted via kyb_run_submit.
Returns a compact summary of the report when status='completed'.
Reports usually complete in about 2 minutes, up to about 4. Free (no charge).
Args:
run_id: The run_id returned by kyb_run_submit
agent_type: One of "kyb-diligence", "adverse-media"
Inputs: run_id (required), agent_type. Returns: result
company_lookupARead-only
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
Inputs: country (required), state, include, company_name, +1 more. Returns: result
company_officersARead-only
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.
Needs the registration number (get it from company_lookup). For
officers together with the register check, call company_lookup with
include=["officers"] instead: one call, one price.
Price: EUR 0.01 only when the register holds the company (free
lookups first); NOT_FOUND costs nothing.
Countries: GB, CZ, SK, NO, FR (GB, CZ, SK also list former officers).
Args:
country: ISO 3166-1 alpha-2 code, e.g. "GB"
registration_number: The register's company number, e.g. "00445790"
Inputs: country (required), registration_number (required). Returns: result
kyb_findingsARead-only
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"
Inputs: company_name (required), state, country, website, +2 more. Returns: result
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).
Returns a run_id immediately; poll check_report_status after 1-3
minutes. The report has everything kyb_findings returns plus a
PASS / REVIEW / FLAG verdict per check, risk flags, a written
summary and next steps for a human reviewer.
Args:
company_name: Legal name of the company
website: Company website URL, strongly recommended
country: ISO 3166-1 alpha-2 country of registration; without it
no company register is 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
Inputs: company_name (required), state, country, website, +2 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
KYB due diligence for agents: sanctions screening, EU VAT/VIES, LEI, IBAN in one verdict.
Sanctions screening, KYB, identifier validation, jurisdiction risk & secret scanning for AI agents
Screen counterparties and enrich companies for AI agents — sanctions checks, cited sources.
KYB for AI agents: verify business registrations from MCP clients.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform identity verification, KYC/KYB, PEP & sanctions screening, bank statement analysis, and workflow automation via the Model Context Protocol.MIT
- AlicenseBqualityBmaintenanceAutonomous M2M compliance and trust APIs for AI agents (KYB, OFAC, VAT, Sanctions checking).5MIT
- AlicenseAqualityDmaintenanceEnables AI agents to screen business partners against EU/US/HADDEX sanctions and PEP lists, and maintain the easycompliance daily monitoring list.613 npmMIT
- AlicenseAqualityAmaintenanceEnables AI agents to investigate corporate ownership, trace ultimate beneficial owners, screen sanctions, detect offshore exposure, and access fully cited dossiers from 130M+ entities across 31 global registries.2196 npm1MIT