Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SONAR_API_KEYYesYour sk-sonar-... API key
SONAR_API_BASENoOverride for staging or self-hosted SONARhttps://api.getsonar.report
SONAR_API_TIMEOUTNoPer-request timeout in seconds120
SONAR_MCP_LOG_LEVELNoDEBUG 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
company_lookupA

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
    
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.

    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"
    
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.

    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"
    
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
    
adverse_mediaA

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
    
check_report_statusA

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"
    
account_balanceA

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.
    

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 7 tools

Disambiguation4/5

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.

Naming Consistency3/5

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.

Tool Count5/5

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.

Completeness4/5

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

ActivityMaintained
ResponsivenessNo recent community issues