Koskamo

czid-mcp

A community MCP server providing tools for AI agents to query the Czech ARES entity registry. It supports checks for company details, VAT/RZP status, insolvency records, RÚIAN addresses, and identifier validation (IČO/DIČ). The service is currently free with no authentication required.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

czid-mcp logo, by CasuyiCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by Casuyi
MCP endpoint (Streamable HTTP)
https://czid.casuyi.com/mcp
Vendor documentation

What its tools do

6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

6 of 6 have a description · 0 of 6 declare behavior hints · 5 of 6 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Verify Czech company details via ARES
  • Check VAT/RZP status
  • Look up insolvency records
  • Validate RÚIAN addresses and identifiers

Source and maintenance

Community listingRegistry 1.0.1

Protocol and capabilities

Server
czid-mcp 0.3.0
MCP protocol negotiated in check
2025-11-25
Tools
6 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

6 advertised

company_lookup — Lookup Czech company by IČO or DIČ
Advertised by the server during the last successful anonymous check.

Basic register (ARES) lookup: name, legal form, registered address, NACE, data-box, VAT DIČ. Input: IČO (8 digits) or DIČ (CZ+10).

company_lookup input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "IČO (e.g. 27082440) or DIČ (e.g. CZ27082440)"
    }
  }
}
check_vat — Czech VAT (DPH) status check
Advertised by the server during the last successful anonymous check.

Plátce-DPH status from the ARES RZP record, cross-checked against the ARES DPH source flag. RZP is a HISTORICAL register (records can stop updating in 2016), so a positive here is not proof of current plátcost — the result carries registerState + caution when the two disagree. For a legally binding check use the MOF DPH register (ADISREG). Batch up to 20 IČOs.

check_vat input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ids"
  ],
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1,
      "description": "IČOs or DIČs (CZ+10)"
    }
  }
}
entity_status — Entity risk snapshot (registers + insolvency)
Advertised by the server during the last successful anonymous check.

KYC-style snapshot: active/cancelled, which registers the entity appears in (VR, RZP, IR insolvency, NRPZS, RCNS, SZR...), plus an insolvency presence flag (IR). Insolvency is presence-only — case detail needs ISIR.

entity_status input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "IČO or DIČ"
    }
  }
}
search_company — Search Czech companies by name
Advertised by the server during the last successful anonymous check.

Company-name search in ARES (prefix match, case-insensitive; no wildcards). Returns IČOs + names + addresses for further lookups.

search_company input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "description": "Company name or name prefix (e.g. \"Alza\")"
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Max results (default 10)"
    }
  }
}
validate_cz — Validate Czech identifiers (offline)
Advertised by the server during the last successful anonymous check.

Checksum/format validation: IČO (mod-11), DIČ (CZ+IČO or birth number), IBAN (mod-97, CZ-specific), variable symbol. Pure local, no network.

validate_cz input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "dic": {
      "type": "string"
    },
    "ico": {
      "type": "string"
    },
    "iban": {
      "type": "string"
    },
    "variableSymbol": {
      "type": "string"
    }
  }
}
address_check — Standardize Czech address (RÚIAN)
Advertised by the server during the last successful anonymous check.

Free-text Czech address -> RÚIAN-standardized (full KOD ADM, codes for obec/část/ulice, correct PSC).

address_check input schema
{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "minLength": 3,
      "description": "e.g. \"Václavské náměstí 1, Praha\""
    }
  }
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
544 ms
95th percentile latency
544 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 544 ms · metadata changed · 6 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http czid-mcp https://czid.casuyi.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add czid-mcp --url https://czid.casuyi.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable czid-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "czid-mcp": {
      "url": "https://czid.casuyi.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "czid-mcp": {
      "type": "streamableHttp",
      "url": "https://czid.casuyi.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start czid-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "czid-mcp": {
      "type": "http",
      "url": "https://czid.casuyi.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http czid-mcp https://czid.casuyi.com/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://czid.casuyi.com/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "czid-mcp": {
      "serverUrl": "https://czid.casuyi.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like czid-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.