ares-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ARES_BASE_URL | No | API root for ARES | https://ares.gov.cz/ekonomicke-subjekty-v-be/rest |
| ARES_MAX_RETRIES | No | Attempts before giving up | 3 |
| ARES_TIMEOUT_SECONDS | No | Per-request timeout | 10 |
| ARES_CACHE_TTL_SECONDS | No | Cache lifetime | 900 |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| lookup_companyA | Look up a Czech company profile by its registration number (IČO). Args: ico: The company's IČO; spaces and missing leading zeros are fine. Returns: Name, registered seat, legal form, incorporation date, VAT ID, CZ-NACE activities and the registers the subject is listed in. |
| search_companiesA | Find Czech companies by a full or partial business name. Args: name: The name to search for, e.g. "Renomia". limit: How many results to return (1-50). Returns: The total number of matches and a list of hits with IČO, name and address. |
| check_vat_registrationA | Check whether a company is an active VAT payer and return its VAT ID. Args: ico: The company's IČO. Returns:
A |
| validate_ico_numberA | Validate an IČO offline via its modulo-11 checksum, without calling ARES. Useful for a quick sanity check on form input or on a number read out of a scanned document, where 0/8 and 1/7 are routinely confused. Args: ico: A string that is supposed to be an IČO. Returns:
|
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 4 tools
The tools are mostly distinct: validate_ico_number handles offline checksum validation, search_companies finds by name, and lookup_company returns a full profile. There is minor overlap between lookup_company and check_vat_registration since both accept an IČO and lookup_company already returns a VAT ID, but the descriptions make the focused VAT-status purpose clear.
All tool names follow the same imperative verb_object pattern in snake_case: validate_, lookup_, search_, check_. This makes the tool set highly predictable and easy for an agent to reason about.
Four tools is a well-scoped size for an ARES-focused MCP server. Each tool covers a distinct, useful operation without redundancy or unnecessary bloat.
The domain is Czech company registry lookups, and the set covers offline validation, name search, full company profile retrieval, and VAT registration status. There are no important dead ends for common workflows involving finding and validating Czech companies.