AI-native · MCP protocol · Claude Desktop

MCP Server

Lounbreck exposes a remote MCP (Model Context Protocol) server so Claude Desktop, Claude Code, and any MCP-compatible AI assistant can query your compliance data in natural language.

1. Generate an API key

In Lounbreck → Settings → API keys, create a key named something like "Claude Desktop". Copy the full key — it's shown once.

2. Configure Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "lounbreck": {
      "type": "http",
      "url": "https://www.lounbreck.com/api/mcp",
      "headers": {
        "Authorization": "Bearer lb_live_YOUR_API_KEY"
      }
    }
  }
}

3. Available tools

get_compliance_summaryHigh-level snapshot: employee counts, threshold statuses, alert counts, upcoming deadlines.
list_frontaliersAll frontalier employees with WFH day counts, threshold status, and SS regime. Optional corridor filter.
get_active_alertsUnresolved compliance alerts ordered by severity. Optional severity filter.
get_upcoming_deadlinesPending filing deadlines within N days (default 30).
get_employee_complianceFull compliance detail for a specific employee by email.
log_wfh_dayLog a work location (HOME / OFFICE / HOLIDAY / SICK) for an employee on a date.
add_employeeCreate a new frontalier employee. Checks plan limits. Requires name, email, 13-digit matricule, nationality, corridor, and start date.
resolve_alertMark a compliance alert as resolved by ID.
update_a1_cert_statusSet the A1 certificate status (PENDING / OBTAINED / EXPIRED) for an employee.
simulate_scenarioWhat-if analysis: given a corridor and number of WFH days, returns threshold status, SS routing, and recommended actions. No real employee needed.
log_wfh_days_bulkLog a location across a date range (weekends skipped, max 90 days) — one call instead of one per day.
update_employeeUpdate name, corridor, contract, residence, nationality, or start date by email.
offboard_employeeDeactivate a leaver. History retained; seat count and billing updated.
run_compliance_checkRe-evaluate all thresholds and regenerate alerts. Once per 5 minutes per org.
generate_deadlinesCreate the year’s CCSS / ACD / A1 deadlines from employee data. Idempotent.
complete_deadlineMark a compliance deadline as done by ID.
get_annual_reportPer-employee year report: WFH days, threshold, SS regime, A1, alerts. Starter plan or higher.

4. Resources & prompts

Beyond tools, the server publishes resources — regulatory reference your AI can read directly, generated from the same constants the compliance engine uses:

lounbreck://rules/wfh-thresholdsThe 25% rule (EU Reg. 883/2004), the 55-day limit, and status bands
lounbreck://rules/social-securitySS routing per corridor (CCSS / URSSAF / ONSS / DRV) and A1 certificates
lounbreck://rules/deadline-typesCCSS declaration, ACD tax card, and A1 renewal deadlines explained

And prompts — one-click workflows in Claude Desktop's prompt picker:

weekly_compliance_reviewSummary → alerts → deadlines → prioritised action list
onboard_employeeGuided intake ending in add_employee plus the corridor’s compliance implications
what_if_analysisSimulate N home days on a corridor and get a plain-language interpretation

5. Example queries

"Which of my employees are approaching their WFH threshold?"

"Log today as a home day for jean-luc.martin@company.lu"

"How many active compliance alerts do I have and what are they?"

"What compliance deadlines are coming up in the next 2 weeks?"

"Give me a full compliance report for k.weber@company.lu"

"Add a new employee: Sophie Bernard, sophie@acme.lu, French national living in France, CDI, started 1 Jan 2026"

"Mark the critical alert about Marie Dupont as resolved"

"What happens if an LU-FR frontalier works 45 days from home this year?"

"Update k.weber@company.lu A1 certificate status to OBTAINED"

"Log Marie as working from home all of last week, then re-run the compliance check"

"Sophie moved from France to Belgium — update her corridor and explain what changes"

"Generate this year’s deadlines and mark the CCSS declaration as done"

"Pull the annual report and tell me who needs an A1 certificate before year-end"

Authentication

All MCP requests require an API key in the Authorization: Bearer lb_live_... header. Keys are scoped to your organisation and can be revoked at any time from Settings.