Model Context Protocol (MCP)

​

Overview

Registercheck provides a Model Context Protocol (MCP) server that automatically converts our entire API into AI-accessible tools. This enables AI agents like Claude Desktop to seamlessly interact with German company registry data through natural language.

​

AI Plugin Discovery

AI agents can automatically discover our MCP server through the standard manifest:

GET /.well-known/ai-plugin.json

Response:

{
  "schema_version": "v1",
  "name_for_model": "registercheck",
  "name_for_human": "Registercheck API",
  "description_for_model": "Access comprehensive German company registry data including company details, shareholders, management, financial reports, and search capabilities.",
  "auth": {"type": "bearer"},
  "api": {
    "type": "mcp",
    "url": "https://jobs-api.registercheck.de/tools",
    "has_user_authentication": true
  },
  "mcp": {
    "endpoints": {
      "tools_list": "https://jobs-api.registercheck.de/tools",
      "tools_invoke": "https://jobs-api.registercheck.de/invoke"
    }
  }
}

​

Authentication

All MCP tools require Bearer token authentication, same as our regular API:

{
  "tool_name": "search_companies_search_companies_get",
  "input": {
    "query": "BMW",
    "headers": {
      "Authorization": "Bearer your_token_here"
    }
  }
}

​

Available Tools

​

Tool Discovery

List all available MCP tools:

GET /tools

Response includes 23 auto-generated tools:

• Company search and details
• Person search and details
• Shareholder information
• Investment data
• Contact information
• Financial reports
• Company history
• List management

​

Tool Execution

Execute any tool through the universal invoke endpoint:

POST /invoke

​

Usage Examples

​

Company Search

AI Request: “Find technology companies in Munich”

MCP Tool Call:

{
  "tool_name": "search_companies_search_companies_get",
  "input": {
    "city": "Munich",
    "full_text": "technology",
    "limit": 10,
    "headers": {
      "Authorization": "Bearer your_token"
    }
  }
}

Response:

{
  "tool_name": "search_companies_search_companies_get",
  "status_code": 200,
  "output": {
    "companies": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Tech Solutions GmbH",
        "city": "München",
        "status": "active"
      }
    ],
    "total_count": 245
  },
  "execution_time_ms": 1250
}

​

Company Details

AI Request: “Get detailed information about this company including management and financials”

MCP Tool Call:

{
  "tool_name": "get_company_details_companies__company_id__get",
  "input": {
    "company_id": "123e4567-e89b-12d3-a456-426614174000",
    "headers": {
      "Authorization": "Bearer your_token"
    }
  }
}

Response:

{
  "tool_name": "get_company_details_companies__company_id__get",
  "status_code": 200,
  "output": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": {
      "name": "Tech Solutions GmbH",
      "legal_form": "GmbH"
    },
    "register": {
      "register_number": "12345",
      "register_court": "Amtsgericht München"
    },
    "representation": [
      {
        "name": "Max Mustermann",
        "role": "DIRECTOR"
      }
    ],
    "financials": {
      "has_financial_reports": true,
      "financial_reports_count": 3
    }
  },
  "execution_time_ms": 2090
}

​

Investment Analysis

AI Request: “Show me all companies that Siemens has invested in”

MCP Tool Call:

{
  "tool_name": "get_company_investments_companies__company_id__investments_get",
  "input": {
    "company_id": "siemens-company-id",
    "headers": {
      "Authorization": "Bearer your_token"
    }
  }
}

​

Error Handling

​

Authentication Errors

{
  "tool_name": "search_companies_search_companies_get",
  "status_code": 401,
  "output": {
    "detail": "Valid Bearer token required in Authorization header"
  },
  "execution_time_ms": 50
}

​

Tool Not Found

{
  "tool_name": "invalid_tool_name",
  "status_code": 404,
  "output": {
    "detail": "Tool 'invalid_tool_name' not found"
  },
  "execution_time_ms": 25
}

​

API Errors

{
  "tool_name": "get_company_details_companies__company_id__get",
  "status_code": 404,
  "output": {
    "detail": "Company with ID xyz not found"
  },
  "execution_time_ms": 800
}

​

Use Cases

​

Business Intelligence

• Competitive Analysis: Find and analyze competitors in specific markets
• Market Research: Identify trends and opportunities by sector/region
• Due Diligence: Comprehensive company background checks

​

Investment Research

• Portfolio Analysis: Track investment relationships and ownership structures
• Deal Sourcing: Identify potential investment targets
• Risk Assessment: Analyze company financials and management

​

Sales & Marketing

• Lead Generation: Find prospects based on specific criteria
• Account Research: Deep dive into potential customers
• Market Segmentation: Understand market structure and players

​

Compliance & Legal

• KYC/AML: Know Your Customer due diligence
• Regulatory Compliance: Track corporate structure changes
• Legal Research: Understand business relationships and ownership

​

Rate Limits

MCP tools inherit the same rate limits as our standard API:

• Free tier: 100 requests/day
• Professional: 10,000 requests/day
• Enterprise: Custom limits

​

Best Practices

​

Efficient Tool Usage

1. Use specific search criteria to reduce API calls
2. Combine multiple tools for comprehensive analysis
3. Cache results when possible for repeated queries
4. Handle errors gracefully with retry logic

​

Authentication

1. Secure token storage in environment variables
2. Token rotation for long-running applications
3. Error handling for expired tokens

​

Data Processing

1. Structured analysis of returned company data
2. Cross-reference multiple data points
3. Temporal analysis using historical data

​

Technical Details

​

Architecture

AI Agent → MCP Server → Registercheck API → Database

​

Response Format

All MCP tools return a standardized response:

{
  tool_name: string,           // Name of executed tool
  status_code: number,         // HTTP status code
  output: any,                 // Tool-specific response data
  execution_time_ms: number,   // Execution time in milliseconds
  timestamp: string            // ISO timestamp
}

​

Tool Naming Convention

Tools follow the pattern: {operation}_{resource}_{method}

Examples:

• search_companies_search_companies_get
• get_company_details_companies__company_id__get
• get_company_shareholders_companies__company_id__shareholders_get