ARES

Provides access to the Czech ARES API for searching, validating, and retrieving company data across multiple registries.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "vzeman-ares-mcp-server": {
      "command": "python3",
      "args": [
        "-m",
        "ares_mcp_server.server"
      ],
      "env": {
        "LOG_LEVEL": "INFO",
        "ARES_AUTH_TOKEN": "YOUR_TOKEN_HERE",
        "ARES_RATE_LIMIT_WINDOW": "60",
        "ARES_RATE_LIMIT_REQUESTS": "100"
      }
    }
  }
}

You run an MCP server that exposes the Czech ARES API for querying company data, registrations, and related records. This server lets you search, fetch details, validate IČO numbers, and perform registry-specific inquiries from your client tools, with built-in rate limiting and optional authentication for secure access.

How to use

You interact with the ARES MCP Server through an MCP client. Start by configuring a local or remote MCP connection, then issue high-level actions such as searching for companies, getting full company details by IČO, validating IČO formats, and querying specific registries. Use the provided tools to filter by name, IČO, address, legal form, CZ-NACE codes, and other attributes. The server handles the underlying ARES API calls and returns structured results suitable for your automation, dashboards, or conversational assistant.

Practical usage patterns include performing complex searches across multiple fields, retrieving detailed company records, validating IČO numbers before creating records, and performing registry-specific searches to locate entities within a chosen public registry, trade registry, or sector-specific registry.

How to install

Prerequisites you need before installation are Python 3.8 or higher and pip.

Clone the MCP server repository and install in editable mode

git clone https://github.com/yourusername/ares-mcp-server.git
cd ares-mcp-server
pip install -e .

Run the development server locally (if you are following a local, stdio-based setup) or prepare to connect via an MCP client using the configured command and arguments

# Example: run directly via Python module
python3 -m ares_mcp_server.server

Configuration and startup details

Configure runtime behavior with environment variables. The server accepts rate limit settings, an optional authentication token, and a logging level. These variables control how many requests you’ll accept per window, whether you require a token for access, and how verbose the server’s logs are.

ARES_RATE_LIMIT_REQUESTS=100
ARES_RATE_LIMIT_WINDOW=60
ARES_AUTH_TOKEN=your_token_here
LOG_LEVEL=INFO

Claude Desktop integration example

To connect Claude Desktop to this MCP server, configure a stdio-based MCP entry that runs the server module directly.

{
  "mcpServers": {
    "ares": {
      "command": "python3",
      "args": ["-m", "ares_mcp_server.server"],
      "cwd": "/path/to/ares-mcp-server"
    }
  }
}

Available tools

vyhledat_ekonomicke_subjekty

Main search tool that queries economic entities using complex filters including ICO, name, address, legal form, CZ-NACE, and more.

najit_ekonomicky_subjekt

Retrieves detailed information about a specific economic entity by its IČO.

vyhledat_v_registru

Search within a specific registry (e.g., Public Registers, Economic Entities, Trade Licensing) using common search parameters.

najit_v_registru

Get an entity from a specific registry by IČO.

validovat_ico

Validate the format of an IČO and verify its existence.

vyhledat_ciselniky

Search codebooks and nomenclatures used by the ARES API.

vyhledat_adresy

Search standardized addresses.

vyhledat_notifikace

Search notification batches.