MCP 서버

curl https://germanyinsolvencies.com/api/mcp/health

claude mcp add --transport http insolvency \
  https://germanyinsolvencies.com/api/mcp \
  --header "X-API-Key: $INSOLVENCY_API_KEY"

{
  "mcpServers": {
    "insolvency": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://germanyinsolvencies.com/api/mcp",
        "--header", "X-API-Key:${INSOLVENCY_API_KEY}"
      ],
      "env": { "INSOLVENCY_API_KEY": "YOUR_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "insolvency": {
      "url": "https://germanyinsolvencies.com/api/mcp",
      "headers": { "X-API-Key": "${env:INSOLVENCY_API_KEY}" }
    }
  }
}

{
  "name": "check_counterparty",
  "description": "Check whether a German company appears in official insolvency announcements. Use before extending credit, signing a supplier or chasing an overdue invoice. Prefer register number over name when you have it. Never guess a register number.",
  "annotations": { "readOnlyHint": true },
  "inputSchema": {
    "type": "object",
    "properties": {
      "name":           { "type": "string", "description": "Company name as written on the invoice or contract." },
      "city":           { "type": "string", "description": "Registered seat, narrows ambiguous names." },
      "register":       { "type": "string", "description": "e.g. HRB 123456 B" },
      "register_court": { "type": "string", "description": "e.g. Charlottenburg (Berlin)" },
      "since":          { "type": "string", "format": "date", "description": "Only filings on or after this date. Default: 3 years ago." }
    },
    "anyOf": [ { "required": ["name"] }, { "required": ["register"] } ]
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Musterbau GmbH (HRB 123456 B, Berlin): insolvency proceedings OPENED on 2026-09-28 by Amtsgericht Charlottenburg, case 36a IN 4711/26. Earlier: protective measures on 2026-08-14. Source: official announcement."
    },
    {
      "type": "resource_link",
      "uri": "insolvency://filing/fil_8Kq2Zp4RwT",
      "name": "Announcement 36a IN 4711/26",
      "mimeType": "application/json"
    }
  ],
  "structuredContent": {
    "match": "exact",
    "company_id": "cmp_3n8Kd2ZpQv",
    "status": "opened",
    "filings": [
      { "id": "fil_8Kq2Zp4RwT", "date": "2026-09-28", "type_code": "2" },
      { "id": "fil_2Hd7Vb1Xe", "date": "2026-08-14", "type_code": "0" }
    ]
  },
  "isError": false
}

insolvency://filing/{id}             one announcement incl. full text
insolvency://company/{id}            company profile and status
insolvency://company/{id}/filings    all announcements of a company
insolvency://company/{id}/financials published balance sheet figures
insolvency://watchlist               your watched companies
insolvency://types                   filing types with codes and aliases

{
  "name": "counterparty_check",
  "description": "Check a list of customers or suppliers for insolvency filings and summarise the risk.",
  "arguments": [
    { "name": "companies", "description": "One company per line: name, city or register number.", "required": true },
    { "name": "since",     "description": "Look-back start date, default 3 years.", "required": false }
  ]
}

사용자: 미결제 청구서 중 금액이 큰 세 곳을 확인해 줄래요? 베를린의
        Musterbau GmbH, Nordlicht Handels GmbH, 함부르크의 Beispiel Logistik이에요.

에이전트: [check_counterparty name="Musterbau GmbH" city="Berlin"]
        [check_counterparty name="Nordlicht Handels GmbH"]
        [check_counterparty name="Beispiel Logistik" city="Hamburg"]

에이전트: Musterbau GmbH: 2026년 9월 28일에 절차가 개시되었습니다
        (AG Charlottenburg, 36a IN 4711/26). 이제 채권은 도산관재인에게
        신고해야 하며, 직접 지급받을 가능성은 낮습니다.
        Beispiel Logistik UG: 2026년 9월 22일부터 보전처분이 내려졌고
        가관재인이 선임되어 있습니다.
        Nordlicht Handels GmbH: 같은 이름의 회사가 두 곳 있으며 둘 다
        공고는 없습니다. 어느 도시의 회사인가요?

사용자: 함부르크요. 그리고 지금부터 세 곳 모두 모니터링해 주세요.

에이전트: [watch_company name="Nordlicht Handels GmbH" city="Hamburg"]
        [watch_company company_id="cmp_3n8Kd2ZpQv"]
        [watch_company company_id="cmp_7Yb3Rt5Mn"]
        완료했습니다. 새 공고가 나오면 바로 웹훅을 받게 됩니다.

{
  "content": [
    {
      "type": "text",
      "text": "No unique match: 2 companies are called \"Nordlicht Handels GmbH\" (Hamburg, Kiel). Ask the user for the city or the register number and call check_counterparty again. Do not pick one yourself."
    }
  ],
  "isError": true
}