ares
Czech & Slovak business registry — company lookup by IČO, name, legal form, VAT. Official ARES.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"ares": {
"command": "npx",
"args": [
"@czagents/ares"
]
}
}
}실행 가능한 패키지
0.1.7stdio원격 엔드포인트
https://ares.cz-agents.dev/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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).
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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#"
}커뮤니티
증거