Compatibility & Integration

The server works with any MCP-capable client — from Claude and ChatGPT to the OpenAI SDK — bringing Handelsregister data into your AI workflows without a custom integration layer.

Key Features

• Works with every MCP client
• Real-time access to German company data
• Perfect for agent-based workflows
• Native integration with OpenAI SDK

Usage with OpenAI Python SDK

The MCP server can be used directly with the OpenAI Python SDK to integrate Handelsregister data into your AI applications:

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

resp = client.responses.create(
    model="gpt-5",
    input="Get me the latest financial data for Konux GmbH from Munich and output it as a markdown table.",
    tools=[
        {
            "type": "mcp",
            "server_label": "handelsregister",
            "server_url": "https://mcp.handelsregister.ai/mcp",
            "require_approval": "never",
            "headers": {
                "X-API-Key": os.environ["HANDELSREGISTER_API_KEY"]
            },
        }
    ],
)

print(resp.output_text)

Authentication

Two authentication methods are supported:

API key (header)

Send your handelsregister.ai API key as a header — ideal for scripted clients and SDKs:

Use the same API key as for the REST API.

OAuth 2.1 (for MCP clients like Claude and ChatGPT)

Clients that connect interactively (e.g. Claude custom connectors, ChatGPT) authenticate via our OAuth 2.1 authorization server — no manual API key handling required. The client discovers the server automatically, registers itself (Dynamic Client Registration, RFC 7591), and requests your consent in the browser. Requests are then billed to your account.

Supported: authorization_code grant with PKCE, refresh tokens, scopes mcp / api / offline_access. Access tokens work on the REST API like regular Bearer tokens.

Available Tools

The MCP server exposes one tool per data product. Tool inputs mirror the REST API parameters; credits are charged exactly like the corresponding REST call:

Agent-Based Workflows

The MCP server enables seamless integration of Handelsregister data into complex agent-based workflows:

• • Automatic data extraction and analysis
• • Multi-agent systems with access to company data
• • Workflow automation with real-time data retrieval
• • Integration into existing AI pipelines

Credits & Pricing

MCP requests consume the same credits as direct API calls — based on the requested features, at exactly the same prices as the REST API.

Requirements

• Valid handelsregister.ai API key
• MCP-compatible client (e.g., OpenAI SDK)
• Python 3.8+ (for OpenAI SDK)