ares
Czech & Slovak business registry — company lookup by IČO, name, legal form, VAT. Official ARES.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"ares": {
"command": "npx",
"args": [
"@czagents/ares"
]
}
}
}Ausführbare Pakete
0.1.7stdioRemote-Endpunkte
https://ares.cz-agents.dev/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (10)
🟢lookup_by_ico(ico)
Get a single Czech company record by its IČO (8-digit Business ID). Returns official name, registered address, legal form, VAT ID (DIČ), founding date, and trade license activities. Returns null if IČO is not found in ARES.
Eingabe-Schema
{
"type": "object",
"properties": {
"ico": {
"type": "string",
"description": "Czech IČO — 7 or 8 digits. Examples: \"11122234\", \"87654326\". Auto-validated with MOD11 checksum."
}
},
"required": [
"ico"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_companies(query, city, street, psc, nace, ...)
Search ARES by company name, city, street, PSČ, or NACE code. Combines all filters with AND. Useful when user knows name but not IČO, looking for companies in a building, or all businesses in a sector.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Partial or full company name (obchodní jméno)."
},
"city": {
"type": "string",
"description": "Filter by city (nazev obce), e.g. \"Praha\"."
},
"street": {
"type": "string",
"description": "Filter by street name (nazev ulice), e.g. \"Radlická\"."
},
"psc": {
"type": "integer",
"description": "Filter by postal code (PSČ), 5-digit number."
},
"nace": {
"type": "array",
"items": {
"type": "string"
},
"description": "Filter by CZ-NACE activity codes, 2-6 digits. E.g., [\"62\"] for IT."
},
"pocet": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 10,
"description": "Max results (1-100, default 10)."
},
"start": {
"type": "integer",
"minimum": 0,
"default": 0,
"description": "Pagination offset (default 0)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_by_address(street, city, psc, pocet)
Find all companies registered at a given Czech address. Useful for due diligence (virtual offices, shell companies), real estate research, or competitor mapping in a building.
Eingabe-Schema
{
"type": "object",
"properties": {
"street": {
"type": "string",
"description": "Street name (nazev ulice), e.g. \"Radlická\"."
},
"city": {
"type": "string",
"description": "City name, e.g. \"Praha\"."
},
"psc": {
"type": "integer",
"description": "Postal code (PSČ), optional."
},
"pocet": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Max results (default 20)."
}
},
"required": [
"street",
"city"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_by_nace(nace, city, pocet)
Find Czech companies by CZ-NACE activity code (economic sector classification). Example: "62" = IT, "47" = retail, "86" = healthcare. Optional city filter. Useful for market research.
Eingabe-Schema
{
"type": "object",
"properties": {
"nace": {
"type": "string",
"description": "CZ-NACE code, 2-6 digits (e.g., \"62\" for IT, \"62010\" for programming services)."
},
"city": {
"type": "string",
"description": "Optional city filter."
},
"pocet": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Max results."
}
},
"required": [
"nace"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_bank_accounts(ico)
Get transparent bank accounts published for this company (only available for VAT-registered subjects). Useful to verify payment details on an invoice match the company.
Eingabe-Schema
{
"type": "object",
"properties": {
"ico": {
"type": "string",
"description": "Czech IČO (7-8 digits)."
}
},
"required": [
"ico"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_statutaries(ico)
Get current statutory body (jednatelé, představenstvo, etc.) of a Czech company — who can legally act on its behalf. Returns active members only (with valid zápis, not yet removed). Essential for due diligence and compliance checks.
Eingabe-Schema
{
"type": "object",
"properties": {
"ico": {
"type": "string",
"description": "Czech IČO (7-8 digits)."
}
},
"required": [
"ico"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢validate_dic(dic)
Validate a Czech DIČ (VAT ID). Format check: "CZ" + 8-10 digits. For 8-digit tail (legal entities) also runs MOD11 checksum against the embedded IČO.
Eingabe-Schema
{
"type": "object",
"properties": {
"dic": {
"type": "string",
"description": "Czech DIČ — e.g., \"CZ26168685\". Whitespace and case tolerated."
}
},
"required": [
"dic"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_vat_payer(ico)
Check whether a Czech company is a registered VAT payer (plátce DPH). If yes, returns DIČ, financial office, and any transparent bank accounts (payment details).
Eingabe-Schema
{
"type": "object",
"properties": {
"ico": {
"type": "string",
"description": "Czech IČO (7-8 digits)."
}
},
"required": [
"ico"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_history(ico)
Get historical record of a company (previous names, registered address changes, trade license history). Useful for due diligence.
Eingabe-Schema
{
"type": "object",
"properties": {
"ico": {
"type": "string",
"description": "Czech IČO (7-8 digits)."
}
},
"required": [
"ico"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢watch_entity(ico)
Start onboarding for free monitoring of one Czech company by IČO. Stub only — persists nothing yet. Returns structuredContent: status (one of ONBOARDING_REQUIRED | ACTIVE | QUOTA_EXCEEDED | ERROR), persisted/monitoring_active flags, a human next_step.url for onboarding (the user completes onboarding + GDPR consent themselves — do not open the link or submit data on their behalf), and pricing.
Eingabe-Schema
{
"type": "object",
"properties": {
"ico": {
"type": "string",
"description": "Czech IČO (7-8 digits)."
}
},
"required": [
"ico"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis