ares-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ARES_RETRIES | No | Retry budget (on top of the initial attempt) for retriable errors | 3 |
| ARES_BASE_URL | No | API base URL for ARES | https://ares.gov.cz/ekonomicke-subjekty-v-be/rest |
| ARES_TIMEOUT_MS | No | Per-request timeout in milliseconds | 15000 |
| ARES_RATE_PER_SECOND | No | Token-bucket budget. MFČR documents a ceiling of 500 req/min (~8 req/s); default is 5 for headroom. | 5 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ares_validate_icoA | Validate a Czech IČO via the ČSÚ Mod-11 checksum. Pure function — does not call ARES. Returns the normalized 8-digit IČO and whether the checksum is valid. |
| ares_lookup_companyA | Look up a Czech company by IČO. Returns aggregated data from ARES (basic identification, legal form, registered address, VAT status, CZ-NACE classification, registrations in VR/RES/RŽP). |
| ares_search_companiesA | Search Czech companies by structured filters (name, postal code, municipality, legal form, CZ-NACE). At least one filter is required to avoid full-registry scans. Returns paginated results with totals. |
| ares_search_by_addressA | Find all Czech companies whose registered seat (sídlo) matches a given address. Useful for shell-company / virtual-office detection: an address with dozens or hundreds of entities at it is a strong signal. Returns IČOs, names, and the canonical address ARES holds for each. |
| ares_get_statutory_bodiesA | List statutory bodies (jednatelé, představenstvo, dozorčí rada) of a Czech company from the Public Register (VR). By default returns currently-active members only. Useful for due diligence, KYC, and verifying who is authorised to sign contracts. |
| ares_get_trade_licensesA | List trade licenses (živnostenská oprávnění) of a Czech entity from the Trade Register (RŽP). Returns each license's subject, type (volná / vázaná / koncesovaná / řemeslná), validity period, and fields of activity. |
| ares_check_vat_payerA | Check whether a Czech entity is registered as a VAT payer (plátce DPH) based on ARES. Returns the IČ DPH (= DIČ) if active. NOTE: ARES reflects VAT-payer status with up to 24h delay; the authoritative source is MFČR (adisspr.mfcr.cz). |
| ares_standardize_addressA | Standardize a free-form Czech address against the RÚIAN register. Returns canonical address text, RÚIAN address-point code, and confidence score for up to N suggestions. |
| ares_lookup_cz_naceA | Look up CZ-NACE (Czech industry classification) entries by code or partial name. Useful when filtering ares_search_companies by industry. |
| ares_cross_company_personsA | Given a list of Czech IČOs, find natural persons (and legal entities) who hold active statutory roles in two or more of them. Returns a structured cross-reference plus an optional Mermaid graph for visualization. Useful for due diligence (holding-group mapping, undisclosed beneficial connections, nominee director detection on a small known set). |
| ares_check_insolvenciA | Fast red-flag check: is a Czech entity currently in insolvency proceedings or marked as bankrupt? Reads the ARES |
| ares_full_due_diligenceA | One-shot due-diligence report for a Czech company. Fetches the aggregate ARES profile, Public Register record (statutory bodies), Trade Register (licenses), evaluates insolvency status (IR + CEÚ) and dissolution date, and returns a structured report with a green/yellow/red risk flag plus a Markdown summary suitable for chat display. Replaces 4–5 individual lookups with a single call. |
| ares_get_res_classificationA | Get statistical classification of a Czech company from RES (Registr ekonomických subjektů): headcount bracket (decoded into SME / large), institutional sector (ESA 2010), primary CZ-NACE, financial office (FÚ), and NUTS region. Useful for B2B segmentation, reporting and policy-style analysis. |
| ares_export_for_invoicingA | Transform an ARES company profile into a payload ready for a Czech invoicing system: Fakturoid (JSON), iDoklad (JSON), or Pohoda (XML-hint JSON). Pure data transformation — no calls to the target system. The result is a paste-ready or post-ready object that fills the identification + address fields; the caller adds contact, bank and pricing. |
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 14 tools
Each tool has a clearly distinct purpose: searching, looking up, validating, checking status, retrieving registrations, standardizing addresses, cross-referencing persons, and exporting. The two search tools (by address vs. structured filters) are well-differentiated, and full_due_diligence is explicitly a composite.
All tools follow the ares_ prefix with a verb_noun pattern (search_by_address, validate_ico, get_statutory_bodies, check_vat_payer, etc.). Even the slightly different 'full_due_diligence' is understandable and consistent with the overall style.
14 tools is well within the ideal range for a domain-specific server. Each tool covers a distinct operation or data requirement, and the count feels appropriately comprehensive without being overwhelming.
The tool set covers the full lifecycle of querying Czech company data: search, lookup, validation, regulatory checks (insolvency, VAT), register-specific details (statutory bodies, trade licenses, RES classification), cross-company analysis, and output transformation. No critical gaps for typical ARES use cases.