Skip to content
emploreadocs

MCP server

The Emplorea MCP server exposes HR capabilities as native tools for Claude, GPT and any MCP-compatible client. Transport is Streamable HTTP (JSON-RPC 2.0 over POST) at https://app.emplorea.com/mcp, with the manifest at /.well-known/mcp.json. Authentication is the same API key as the REST API, sent as a Bearer token on every request.

Connect from Claude

{
  "mcpServers": {
    "emplorea": {
      "type": "http",
      "url": "https://app.emplorea.com/mcp",
      "headers": {
        "Authorization": "Bearer emp_live_your_key_here"
      }
    }
  }
}

Tools

  • get_company_info - call first for company context
  • list_employees / get_employee / update_employee / terminate_employee
  • list_leave_requests / get_leave_balances / request_leave / approve_leave / decline_leave / cancel_leave
  • list_leave_types / list_public_holidays
  • list_documents (coming-soon notice until the documents session)

Raw protocol example

curl -X POST https://app.emplorea.com/mcp \
  -H "Authorization: Bearer $EMPLOREA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://app.emplorea.com/mcp \
  -H "Authorization: Bearer $EMPLOREA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 2, "method": "tools/call",
    "params": { "name": "get_leave_balances", "arguments": {} }
  }'

Tool results return as MCP text content containing JSON. Errors set isError true with a human-readable message - the same safe messages the web app shows.