Humanforce MCP by usefulapi

Read employees, rosters, timesheets, leave requests and clocking status in Humanforce.

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
95%
命名の品質
79%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(1)

  • LOWTool 'humanforce_list_public_holidays' name length outside 3-30 rangehumanforce_list_public_holidays 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~2,928トークン数(ツール定義)
~1.7 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 2.29%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "humanforce": {
      "url": "https://humanforce.usefulapi.io/mcp"
    }
  }
}

リモートエンドポイント

https://humanforce.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール(14)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢humanforce_list_employees(activeOnly, employeeCode, defaultLocationGuidKey, defaultDepartmentGuidKey, lastEdit, ...)

List employees with summary details (code, name, default location, department and role, active status). Humanforce API: GET /api/1.0/employees.

入力スキーマ

{
  "type": "object",
  "properties": {
    "activeOnly": {
      "description": "Only active employees (true) or include terminated (false).",
      "type": "boolean"
    },
    "employeeCode": {
      "description": "Filter by employee code.",
      "type": "string"
    },
    "defaultLocationGuidKey": {
      "description": "Filter by default location GUID.",
      "type": "string"
    },
    "defaultDepartmentGuidKey": {
      "description": "Filter by default department GUID.",
      "type": "string"
    },
    "lastEdit": {
      "description": "Only records changed since this date-time (ISO 8601).",
      "type": "string"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_get_employee(guidKey, roleRevisionEffectiveDate)

Get one employee with all details (personal, employment, roles, locations and departments). Humanforce API: GET /api/1.0/employees/{guidKey}.

入力スキーマ

{
  "type": "object",
  "properties": {
    "guidKey": {
      "type": "string",
      "minLength": 1,
      "description": "GUID key of the record (from a list tool)."
    },
    "roleRevisionEffectiveDate": {
      "description": "Role revision effective date (yyyy-mm-dd), if the role at a date matters.",
      "type": "string"
    }
  },
  "required": [
    "guidKey"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_locations(page, pageSize)

List locations with summary data (site names and codes). Humanforce API: GET /api/1.0/locations.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_departments(page, pageSize)

List all departments. Humanforce API: GET /api/1.0/departments.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_roles(page, pageSize)

List all roles (job roles used for rostering and pay). Humanforce API: GET /api/1.0/roles.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_shift_types(isLeaveType, page, pageSize)

List shift types, including leave types when isLeaveType is true. Humanforce API: GET /api/1.0/shiftTypes.

入力スキーマ

{
  "type": "object",
  "properties": {
    "isLeaveType": {
      "description": "Only leave types (true) or only non-leave shift types (false).",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_pay_types(page, pageSize)

List all pay types used in timesheets and payruns. Humanforce API: GET /api/1.0/payTypes.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_pay_companies(page, pageSize)

List the pay companies (legal payroll entities) in this tenant. Humanforce API: GET /api/1.0/PayCompany.

入力スキーマ

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_roster_items(dateMin, dateMax, employeeGuidKey, locationGuidKey, departmentGuidKey, ...)

List rostered shifts between two dates, with filters for employee, location, department and role. Humanforce API: GET /api/1.0/rosterItems.

入力スキーマ

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "departmentGuidKey": {
      "description": "Filter by department GUID.",
      "type": "string"
    },
    "roleGuidKey": {
      "description": "Filter by role GUID.",
      "type": "string"
    },
    "published": {
      "description": "Only published (true) or unpublished (false) shifts.",
      "type": "boolean"
    },
    "includeDeleted": {
      "description": "Include deleted shifts.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_availability(dateMin, dateMax, employeeGuidKey, locationGuidKey, departmentGuidKey, ...)

List employee availability between two dates, optionally for one employee, location or department. Humanforce API: GET /api/1.0/availability.

入力スキーマ

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "departmentGuidKey": {
      "description": "Filter by department GUID.",
      "type": "string"
    },
    "recurring": {
      "description": "Only recurring availability (true) or only one-off (false).",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_public_holidays(dateMin, dateMax, regionGuidKey, page, pageSize)

List public holidays between two dates, optionally for one region. Humanforce API: GET /api/1.0/publicHolidays.

入力スキーマ

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "regionGuidKey": {
      "description": "Filter by region GUID.",
      "type": "string"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_get_clocking_status(employeeGuidKey, timezoneOffset)

Get whether an employee is clocked in or out now, in their local time. Humanforce API: GET /api/1.0/clocking/status.

入力スキーマ

{
  "type": "object",
  "properties": {
    "employeeGuidKey": {
      "type": "string",
      "minLength": 1,
      "description": "Employee GUID."
    },
    "timezoneOffset": {
      "type": "integer",
      "minimum": -840,
      "maximum": 840,
      "description": "Minutes offset from UTC for local time, for example 600 for Sydney and -240 for New York."
    }
  },
  "required": [
    "employeeGuidKey",
    "timezoneOffset"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_timesheets(dateMin, dateMax, usePayDate, employeeGuidKey, locationGuidKey, ...)

List timesheets in a date range (or pay-date range), with filters for employee, location and approval. Humanforce API: GET /api/1.0/timesheets.

入力スキーマ

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "usePayDate": {
      "type": "boolean",
      "description": "Filter on the pay date (true) or the shift date (false)."
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "authorised": {
      "description": "Only authorised (true) or unauthorised (false) timesheets.",
      "type": "boolean"
    },
    "rostered": {
      "description": "Only rostered (true) or unrostered (false) timesheets.",
      "type": "boolean"
    },
    "includeDeleted": {
      "description": "Include deleted timesheets.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax",
    "usePayDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_leave_requests(dateMin, dateMax, approvedStatus, employeeGuidKey, locationGuidKey, ...)

List leave requests in a date range, optionally only approved ones or for one employee. Humanforce API: GET /api/1.0/leaveRequest.

入力スキーマ

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "approvedStatus": {
      "description": "Only approved (true) or not approved (false) requests.",
      "type": "boolean"
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "deleted": {
      "description": "Only deleted (true) or not deleted (false) requests.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 14 件