How to Connect Handelsregister (handelsregister.ai) to Gemini — via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Handelsregister (handelsregister.ai), paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

Handelsregister (handelsregister.ai) + Gemini

Access the German commercial register (Handelsregister) data via handelsregister.ai — search companies by name, retrieve official entries, current/historical addresses, shareholders, managing directors, and corporate structure.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

HANDELSREGISTER_API_KEY

Step 1 — Get credentials

ai REST API which wraps the official Handelsregister portal and enriches it with structured data.

Authentication: API key via Authorization header. Generate a key at https://handelsregister.ai/account.

Typical workflow:

1. hr_search_companies — find a company by name or keyword
2. hr_get_company — fetch the full record by company_id returned from search
3. hr_get_documents — list SHD/AD/HRA documents attached to a company

Registernummer format: Courts + numbers like 'HRB 12345 München'. Search also accepts plain company names.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
2. Save the file and restart gemini.
3. Run /mcp inside the Gemini CLI — Handelsregister (handelsregister.ai) should be listed as available.
4. Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID to the tools array of your request with the same X-API-Key header.

Available tools

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT
• Connect to Cursor
• Connect to Meta Muse