ares
Czech & Slovak business registry — company lookup by IČO, name, legal form, VAT. Official ARES.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ares": {
"command": "npx",
"args": [
"@czagents/ares"
]
}
}
}Paquetes ejecutables
0.1.7stdioPuntos de conexión remotos
https://ares.cz-agents.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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).
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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#"
}Comunidad
Evidencia