Skip to main content
Glama
oracle-hcm-mcp

oracle-hcm-mcp

by GaneshR-dev

oracle-hcm-mcp

Unofficial Model Context Protocol (MCP) server for Oracle Fusion Cloud HCM REST APIs.

Not an Oracle product. Not affiliated with, endorsed by, or supported by Oracle Corporation. Provided as-is under the MIT License. You are responsible for compliance with your Oracle licenses, HCM security roles, privacy/PII rules, and any damage caused by write operations. This project does not claim to be an official Oracle integration, SDK, or partner solution. Oracle® and Java® are trademarks of Oracle Corporation. Use of these names does not imply endorsement.

Status

v0.10 — official ADF /describe schema (resource + catalog + OpenAPI Accept). Fusion HCM has no GraphQL. v0.9 — remaining official Fusion worker children, timeEventRequests, work-structure LOVs, recruiting/benefit nested collections, documentRecords actions, dummy If-Match 412. v0.8 — official Fusion 11.13.18.05 collection names only (no invented roots). v0.7 security control-plane remains: split-principal approvals, HTTP/gRPC bearer, path canonicalization, SENSITIVE resource and child gates (nationalIdentifiers, legislativeInfo), Fusion REST-Framework-Version / If-Match, ADF q= quoting. Atom CDC uses /hcmRestApi/atomservlet/{workspace}/{collection}. 243 tools. Perfect ADF coverage is not a goal. See docs/ORACLE_MAPPING.md and docs/ADF_SCHEMA.md.

Honest coverage

Domain

Curated tools

Fusion roots

Workers + assignments

search/get/create/update + nested assignments

workers + child/workRelationships/.../assignments

Absences

CRUD + loadProjectedBalance

absences

Plan balances

search + get + as-of-date finder

planBalances

AOR

CRUD

areasOfResponsibility

Checklists / tasks

list/get + status update

allocatedChecklists / child/allocatedTasks

BP notifications

list/get + performAction

businessProcessNotifications

Org LOVs

orgs, locationsV2, jobs, grades

organizations, locationsV2, jobs, grades

Time

search/get + event submit + clock

timeRecordGroups / timeRecordEventRequests / timeEventRequests

Talent

search/get + light update

talentPersonProfiles

Payroll

search/get (read-only)

payrollRelationships

Generic

allowlisted get/mutate

official roots only; CE / generative AI blocked

Related MCP server: HR System MCP Server

Safety modes

Mode

Behavior

Default

Mutating tools return pending_approval with an approval_id. A human/ops principal must call hcm_approve_write / hcm_deny_write with approval_token (ORACLE_HCM_APPROVAL_TOKEN — never returned by tools) or use the Approval UI (HTTP bearer). SENSITIVE reads need ORACLE_HCM_SENSITIVE=1 then execute; sensitive writes also queue.

--write / ORACLE_HCM_WRITE=1

Bypasses everything: no approval queue, no SENSITIVE gate, no prod-profile write lock — mutations (including payslip/bank/comp) run immediately. Use only for trusted automation.

Unknown / future hcm_* tools are classified as write (safe default).

Transports

  • stdio (default) — for Claude Desktop / Cursor / MCP clients

  • Streamable HTTP — POST /mcp (plus GET /health). Bearer required on /mcp and /approvals.

  • gRPC — custom bridge wrapping MCP JSON-RPC (proto/mcp_bridge.proto). Same bearer via authorization / x-hcm-token metadata.

Approval UI (humans)

# MCP HTTP must be running, e.g. npx oracle-hcm-mcp --http 8788
npm run approval-ui
# open http://127.0.0.1:8796

Tiny localhost page to list / approve / deny pending writes. Paste ORACLE_HCM_HTTP_TOKEN. Tool/summary text is rendered as text (not HTML). Unofficial — not Oracle.

Setup UI (local wizard)

Interactive setup at http://127.0.0.1:8790 (localhost only):

npm run setup-ui
# open http://127.0.0.1:8790  (falls back to 8792+ if 8790 is busy)

Walks through Dummy vs Real Fusion → base URL / API version → auth (basic / bearer / oauth) → approval vs --write → test connection → copy Cursor mcp.json fragments for oracle-hcm and oracle-hcm-write → a short how-to cheat sheet.

Secrets stay in the browser for generating config. Optional write to .env.local (gitignored). The setup server can proxy a health/test-connection probe and never logs or returns passwords, bearer tokens, or client secrets.

Unofficial wizard for an unofficial MCP — not an Oracle product.

Quick start

npm install
npm run build
npm test
npm run e2e        # dummy HCM + stdio/HTTP/gRPC + setup/approval UI

# Local mock HCM (basic auth demo/demo) on :9090
npm run dummy-hcm

# MCP over stdio against the mock (approval mode)
ORACLE_HCM_BASE_URL=http://127.0.0.1:9090/hcmRestApi \
ORACLE_HCM_USERNAME=demo ORACLE_HCM_PASSWORD=demo \
npx oracle-hcm-mcp

# Unrestricted writes (trusted only)
npx oracle-hcm-mcp --write --base-url http://127.0.0.1:9090/hcmRestApi

# Streamable HTTP
npx oracle-hcm-mcp --http 8788 --base-url http://127.0.0.1:9090/hcmRestApi

# gRPC bridge
npx oracle-hcm-mcp --grpc 8789 --base-url http://127.0.0.1:9090/hcmRestApi

CLI

oracle-hcm-mcp                     # stdio, approval required for writes
oracle-hcm-mcp --write             # stdio, unrestricted writes
oracle-hcm-mcp --http 8788
oracle-hcm-mcp --grpc 8789
oracle-hcm-mcp --base-url http://127.0.0.1:9090/hcmRestApi

Environment

Variable

Meaning

ORACLE_HCM_BASE_URL

e.g. https://fa-….fa.ocs.oraclecloud.com/hcmRestApi

ORACLE_HCM_API_VERSION

default 11.13.18.05

ORACLE_HCM_AUTH

basic | oauth | bearer | none

ORACLE_HCM_USERNAME / PASSWORD

Basic auth

ORACLE_HCM_BEARER_TOKEN

Bearer token

ORACLE_HCM_TOKEN_URL / CLIENT_ID / CLIENT_SECRET

OAuth client-credentials (IDCS)

ORACLE_HCM_WRITE=1

Same as --write

ORACLE_HCM_APPROVAL_TTL_MS

Pending intent TTL (default 15 min)

ORACLE_HCM_SENSITIVE=1

Enable payslip / bank / national-ID tools

ORACLE_HCM_SENSITIVE_WRITE=1

Allow sensitive tools to skip approval when combined with --write

ORACLE_HCM_PROFILE

Optional multi-env profile label

ORACLE_HCM_APPROVAL_STORE

memory (default) | file | sqlite — multi-node pending approvals

ORACLE_HCM_APPROVAL_STORE_PATH

Path for file/sqlite approval store

ORACLE_HCM_WEBHOOK_SECRET

HMAC-SHA256 secret for webhook receiver (X-HCM-Signature)

ORACLE_HCM_ATOM_CHECKPOINT_PATH

Atom CDC checkpoint JSON path

ORACLE_HCM_PROFILES_PATH

Multi-env profiles.json path

ORACLE_HCM_SMOKE_DIR

Smoke probe report directory

ORACLE_HCM_WEBHOOK_SECRETS

Comma-separated rotating webhook HMAC secrets

ORACLE_HCM_WEBHOOK_MTLS

1 to enable webhook mTLS (needs TLS key/cert/ca env)

Auth note: credentials open the HTTP door; HCM RBAC still decides what the user/app can do.

Tools (v0.5)

Meta / setup: hcm_health, hcm_whoami, hcm_list_resources, hcm_describe_resource, hcm_adf_describe, hcm_adf_catalog, hcm_fusion_api_surface, hcm_setup_status, hcm_test_connection, hcm_emit_mcp_config, hcm_export_config

Workers: hcm_search_workers, hcm_get_worker, hcm_get_worker_assignments, hcm_create_worker, hcm_update_worker

Absences / balances: hcm_search_absences, hcm_get_absence, hcm_create_absence, hcm_update_absence, hcm_delete_absence, hcm_absence_balance → planBalances, hcm_get_plan_balance

AOR: hcm_search_aor, hcm_get_aor, hcm_create_aor, hcm_update_aor, hcm_delete_aor

Checklists: hcm_list_checklists, hcm_get_checklist, hcm_update_task_status → child/allocatedTasks/…/action/updateTaskStatus

BP / notifications: hcm_list_notifications, hcm_get_notification, hcm_perform_bp_action → businessProcessNotifications/action/performAction

Org LOVs: hcm_search_organizations, hcm_get_organization, hcm_search_locations, hcm_get_location, hcm_search_jobs, hcm_get_job, hcm_search_grades, hcm_get_grade

Time: hcm_search_time_records, hcm_get_time_record

Talent: hcm_search_talent_profiles, hcm_get_talent_profile, hcm_update_talent_profile

Payroll (read-only): hcm_search_payroll_relationships, hcm_get_payroll_relationship

Generic (allowlisted): hcm_rest_get, hcm_rest_mutate

Atom CDC: hcm_list_atom_feeds, hcm_get_atom_feed, hcm_list_atom_entries, hcm_get_atom_entry, hcm_detect_changes, hcm_atom_poll, hcm_atom_consume, hcm_atom_get_checkpoint, hcm_atom_reset_checkpoint

Finders: hcm_lov_finder, hcm_lov_find, hcm_describe_finder, hcm_resolve_uniq_key

Approval: hcm_list_pending_approvals, hcm_approve_write, hcm_deny_write (always registered; file/sqlite store optional for multi-node)

CE / generative-AI / Oracle-internal style paths are blocklisted for generic REST.

Docs

Reference

License

MIT — see LICENSE. No warranty. No liability. Not an Oracle product.

Available Tools

119 tools
hcm_absence_balanceC
Read-only

Search absence plan balances via Fusion planBalances.

Inputs: q, limit, finder, personNumber.

hcm_allocate_checklistB

Allocate a checklist to a person (approval unless --write).

Inputs: body (required).

hcm_approve_writeA

Approve and execute a pending write by approval_id.

Inputs: approval_id (required).

hcm_atom_consumeB

Consume (poll + advance checkpoint) Atom entries after cursor. Persists checkpoint to file store.

Inputs: limit, dryRun, collection.

hcm_atom_get_checkpointC
Read-only

Get Atom CDC checkpoint(s) from local store.

Inputs: collection.

hcm_atom_pollA
Read-only

Poll Atom feed for entries after the stored checkpoint cursor (or since). Does not advance cursor.

Inputs: limit, since, collection.

hcm_atom_reset_checkpointA

Clear Atom CDC checkpoint for a collection (or all). Local store only.

Inputs: collection.

hcm_bulk_approve_notificationsB

Bulk approve BP notifications (approval unless --write). Prefer dry-run first.

Inputs: notificationIds (required).

hcm_bulk_bp_dry_runA
Read-only

Dry-run bulk approve/deny for notification ids — returns planned actions without executing.

Inputs: action (required), notificationIds (required).

hcm_bulk_deny_notificationsC

Bulk reject/deny BP notifications (approval unless --write).

Inputs: notificationIds (required).

hcm_create_absenceC

Create an absence entry (approval unless --write).

Inputs: body (required).

hcm_create_aorC

Create AOR (approval unless --write).

Inputs: body (required).

hcm_create_workerA

Create a worker (requires approval unless --write). Example body: { "DisplayName": "New Hire", "PersonNumber": "P9" }

Inputs: body (required).

hcm_create_worker_assignmentB

Create nested worker assignment under workRelationships/.../assignments (approval unless --write).

Inputs: body (required), workerId (required), periodOfServiceId.

hcm_delete_absenceC
Destructive

Delete an absence (approval unless --write).

Inputs: absenceId (required).

hcm_delete_aorC
Destructive

Delete AOR (approval unless --write).

Inputs: aorId (required).

hcm_deny_writeB

Deny a pending write by approval_id.

Inputs: approval_id (required).

hcm_describe_finderA
Read-only

Describe curated ADF finder parameters for a resource (or list all finders). Unofficial catalog — not full Fusion metadata.

Inputs: finder, resource.

hcm_describe_resourceB
Read-only

Describe a curated resource by name (workers, planBalances, …).

Inputs: name (required).

hcm_detect_changesC
Read-only

Summarize recent Atom/change entries since an optional ISO timestamp (client-side filter on feed).

Inputs: limit, since, collection.

hcm_dry_run_mutateA
Read-only

Dry-run an allowlisted mutate: validates path/method/body shape; does not call Fusion.

Inputs: path (required), method (required), body.

hcm_emit_mcp_configB
Read-only

Emit a redacted Cursor mcp.json fragment for oracle-hcm / oracle-hcm-write (secrets as placeholders).

Inputs: includeWriteServer.

hcm_explain_toolB
Read-only

Explain a curated MCP tool: class (read/write/sensitive), related resource, usage hints.

Inputs: name (required).

hcm_export_configA
Read-only

Export public (non-secret) config JSON for multi-env profiles / backup.

Inputs: no named parameters.

hcm_find_locationsC
Read-only

Location finder helper (finder + country filter).

Inputs: q, limit, finder, country.

hcm_force_close_checklistC
Destructive

Force-close an allocated checklist (approval unless --write).

Inputs: checklistId (required), body.

hcm_get_absenceB
Read-only

Get absence by id.

Inputs: absenceId (required).

hcm_get_absence_type_balanceD
Read-only

getAbsenceTypeBalance-style helper via planBalances finder.

Inputs: personNumber (required), absenceType.

hcm_get_aorB
Read-only

Get AOR by id.

Inputs: aorId (required).

hcm_get_atom_entryA
Read-only

Get a single Atom entry by EntryId.

Inputs: entryId (required).

hcm_get_atom_feedB
Read-only

Get an Atom feed as JSON entries (or request format=atom for XML via dummy). Supports since ISO filter.

Inputs: limit, since, format, collection.

hcm_get_bank_accountB
Read-only

Get bank account. SENSITIVE gate.

Inputs: bankAccountId (required).

hcm_get_benefit_enrollmentB
Read-only

Get benefits enrollment by id.

Inputs: enrollmentId (required).

hcm_get_candidateA
Read-only

Get recruiting candidate by id.

Inputs: candidateId (required).

hcm_get_checklistA
Read-only

Get allocated checklist by id (expand allocatedTasks when supported).

Inputs: checklistId (required), expand.

hcm_get_compensationC
Read-only

Get compensation row. SENSITIVE gate.

Inputs: compensationId (required).

hcm_get_contactC
Read-only

Get contact by id.

Inputs: contactId (required).

hcm_get_goalC
Read-only

Get goal by id.

Inputs: goalId (required).

hcm_get_gradeC
Read-only

Get grade by id.

Inputs: gradeId (required).

hcm_get_jobB
Read-only

Get job by id.

Inputs: jobId (required).

hcm_get_learning_enrollmentB
Read-only

Get learning enrollment by id.

Inputs: enrollmentId (required).

hcm_get_locationB
Read-only

Get location by id.

Inputs: locationId (required).

hcm_get_national_identifierB
Read-only

Get national identifier. SENSITIVE gate.

Inputs: nationalIdentifierId (required).

hcm_get_notificationA
Read-only

Get a business process notification by task/notification id.

Inputs: notificationId (required).

hcm_get_organizationC
Read-only

Get organization by id.

Inputs: organizationId (required).

hcm_get_org_hierarchyA
Read-only

Return a simple org hierarchy tree rooted at organizationId (dummy parent/child).

Inputs: organizationId (required).

hcm_get_payroll_relationshipA
Read-only

Get payroll relationship by id (read-only).

Inputs: payrollRelationshipId (required).

hcm_get_payslipC
Read-only

Get payslip by id. SENSITIVE gate.

Inputs: payslipId (required).

hcm_get_performance_documentC
Read-only

Get performance document by id.

Inputs: documentId (required).

hcm_get_plan_balanceB
Read-only

Get a single plan balance by id (Fusion planBalances/{id}).

Inputs: balanceId (required).

hcm_get_positionB
Read-only

Get position by id.

Inputs: positionId (required).

hcm_get_public_workerC
Read-only

Get publicWorker by id.

Inputs: publicWorkerId (required).

hcm_get_requisitionC
Read-only

Get recruiting job requisition by id.

Inputs: requisitionId (required).

hcm_get_scheduleB
Read-only

Get work schedule by id.

Inputs: scheduleId (required).

hcm_get_talent_profileA
Read-only

Get talent person profile by id.

Inputs: profileId (required).

hcm_get_time_recordA
Read-only

Get a time record by id.

Inputs: timeRecordId (required).

hcm_get_workerA
Read-only

Get a worker by WorkerId. Example: { "workerId": "1001" }

Inputs: workerId (required).

hcm_get_worker_assignmentsC
Read-only

Deep-read worker assignments. Prefers workers/{id} expand; falls back to workerAssignments.

Inputs: workerId (required), expand.

hcm_get_work_relationshipC
Read-only

Get nested work relationship for a worker.

Inputs: workerId (required), periodOfServiceId (required).

hcm_healthA
Read-only

Check connectivity to the configured HCM REST base (unofficial MCP).

Inputs: no named parameters.

hcm_list_atom_entriesC
Read-only

List Atom feed / change-detection entries (Fusion atomfeeds). Dummy returns mock change events.

Inputs: q, limit, finder, offset, +1 more.

hcm_list_atom_feedsB
Read-only

List known Atom / change-detection feeds (collection-oriented). Dummy exposes workers/absences/all.

Inputs: no named parameters.

hcm_list_audit_trailA
Read-only

List in-process MCP audit trail (tool invocations; not Fusion transaction history).

Inputs: limit.

hcm_list_checklistsC
Read-only

List allocated checklists.

Inputs: q, limit, offset.

hcm_list_direct_reportsA
Read-only

List direct reports for a manager person number (dummy: filters workers by ManagerPersonNumber).

Inputs: managerPersonNumber (required), limit.

hcm_list_notificationsC
Read-only

List business process notifications. Optional status/assignee filters (richer BP filters).

Inputs: q, limit, offset, status, +1 more.

hcm_list_pending_approvalsA
Read-only

List pending write intents awaiting human approval.

Inputs: no named parameters.

hcm_list_resourcesA
Read-only

List curated HCM resource roots supported by this unofficial MCP.

Inputs: no named parameters.

hcm_list_webhook_eventsB
Read-only

List events received by the local webhook stub.

Inputs: limit.

hcm_lov_findA
Read-only

Structured ADF finder call: resource + finder name + params object (builds finder=name;k=v,…). Prefer over raw finder strings.

Inputs: finder (required), resource (required), q, limit, +1 more.

hcm_lov_finderB
Read-only

LOV finder helper — runs finder= on an allowlisted LOV root (organizations, locations, jobs, grades, positions, absenceTypes, workers, absences, …).

Inputs: finder (required), resource (required), q, limit.

hcm_perform_bp_actionD

Perform BP action via businessProcessNotifications/action/performAction.

Inputs: action (required), notificationId (required), body, comment.

hcm_probe_capabilitiesB
Read-only

Tenant capability probe — lists curated resources and whether dummy/seed responds.

Inputs: no named parameters.

hcm_rbac_hintA
Read-only

RBAC hint: reminds that HTTP auth ≠ HCM privileges; returns whoami + sensitive/write flags.

Inputs: no named parameters.

hcm_resolve_uniq_keyB
Read-only

Resolve a Fusion-style uniq key / business key to a primary id via q= on an allowlisted resource.

Inputs: key (required), value (required), resource (required), idField.

hcm_rest_getB
Read-only

Allowlisted generic GET under HCM resources. Blocked for CE/generative-AI/internal paths.

Inputs: path (required), query.

hcm_rest_mutateC

Allowlisted generic mutate (POST/PATCH/PUT/DELETE). Requires approval unless --write.

Inputs: path (required), method (required), body.

hcm_search_absence_plansC
Read-only

Search absence plans LOV.

Inputs: q, limit, finder, offset.

hcm_search_absencesC
Read-only

Search absences.

Inputs: q, limit, offset.

hcm_search_absence_typesC
Read-only

Search absence types LOV.

Inputs: q, limit, finder, offset.

hcm_search_aorC
Read-only

Search areas of responsibility.

Inputs: q, limit, offset.

hcm_search_bank_accountsC
Read-only

Search bank accounts. SENSITIVE: requires ORACLE_HCM_SENSITIVE=1 + approval (unless SENSITIVE_WRITE).

Inputs: q, limit, finder, offset.

hcm_search_benefit_enrollmentsC
Read-only

Search benefits enrollments.

Inputs: q, limit, finder, offset.

hcm_search_calculation_cardsC
Read-only

Search calculation cards (read-only specialist).

Inputs: q, limit, finder, offset.

hcm_search_candidatesC
Read-only

Search recruiting candidates.

Inputs: q, limit, finder, offset.

hcm_search_compensationC
Read-only

Search compensation history. SENSITIVE: requires ORACLE_HCM_SENSITIVE=1 + approval (unless SENSITIVE_WRITE).

Inputs: q, limit, finder, offset.

hcm_search_contactsD
Read-only

Search hcmContacts.

Inputs: q, limit, finder, offset.

hcm_search_element_entriesC
Read-only

Search payroll element entries (read-only specialist; not sensitive-gated).

Inputs: q, limit, finder, offset.

hcm_search_emailsC
Read-only

Search worker emails.

Inputs: q, limit, finder, offset.

hcm_search_goalsC
Read-only

Search talent goals.

Inputs: q, limit, finder, offset.

hcm_search_gradesC
Read-only

Search grades LOV (optional).

Inputs: q, limit, finder, offset.

hcm_search_jobsC
Read-only

Search jobs LOV.

Inputs: q, limit, finder, offset.

hcm_search_learning_enrollmentsC
Read-only

Search learning enrollments.

Inputs: q, limit, finder, offset.

hcm_search_locationsD
Read-only

Search locations LOV.

Inputs: q, limit, finder, offset.

hcm_search_national_identifiersC
Read-only

Search national identifiers. SENSITIVE: requires ORACLE_HCM_SENSITIVE=1 + approval (unless SENSITIVE_WRITE).

Inputs: q, limit, finder, offset.

hcm_search_organizationsC
Read-only

Search organizations / departments.

Inputs: q, limit, finder, offset.

hcm_search_payment_methodsB
Read-only

Search payment methods. SENSITIVE: requires ORACLE_HCM_SENSITIVE=1 + approval (unless SENSITIVE_WRITE).

Inputs: q, limit, finder, offset.

hcm_search_payroll_relationshipsC
Read-only

Search payroll relationships (read-only).

Inputs: q, limit, offset.

hcm_search_payslipsC
Read-only

Search payslips. SENSITIVE: requires ORACLE_HCM_SENSITIVE=1 + approval (unless SENSITIVE_WRITE).

Inputs: q, limit, finder, offset.

hcm_search_performance_documentsC
Read-only

Search performance documents.

Inputs: q, limit, finder, offset.

hcm_search_phonesC
Read-only

Search worker phones.

Inputs: q, limit, finder, offset.

hcm_search_positionsC
Read-only

Search positions LOV.

Inputs: q, limit, finder, offset.

hcm_search_public_workersC
Read-only

Search publicWorkers.

Inputs: q, limit, finder, offset.

hcm_search_requisitionsC
Read-only

Search recruiting job requisitions.

Inputs: q, limit, finder, offset.

hcm_search_schedulesC
Read-only

Search work schedules.

Inputs: q, limit, finder, offset.

hcm_search_talent_profilesC
Read-only

Search talent person profiles.

Inputs: q, limit, offset.

hcm_search_time_recordsC
Read-only

Search time records (Fusion timeRecords).

Inputs: q, limit, finder, offset.

hcm_search_workersC
Read-only

Search workers (q / finder / limit / offset). Example: { "q": "PersonNumber=P1001", "limit": 5 }

Inputs: q, limit, finder, offset.

hcm_setup_statusA
Read-only

Setup status: public config view, write/sensitive flags, tool counts (no secrets).

Inputs: no named parameters.

hcm_start_webhook_receiverA

Start localhost webhook receiver. When ORACLE_HCM_WEBHOOK_SECRET (or secret arg) is set, requires X-HCM-Signature HMAC-SHA256.

Inputs: port, secret.

hcm_submit_time_cardC

Submit a time card (approval unless --write).

Inputs: body (required).

hcm_test_connectionB
Read-only

Probe HCM connectivity via workers?limit=1 (same as hcm_health, explicit setup name).

Inputs: no named parameters.

hcm_update_absenceC

Update an absence (approval unless --write).

Inputs: body (required), absenceId (required).

hcm_update_aorC

Update AOR (approval unless --write).

Inputs: body (required), aorId (required).

hcm_update_talent_profileC

Light PATCH of a talent person profile (approval unless --write).

Inputs: body (required), profileId (required).

hcm_update_task_statusC

Update checklist task status via child/allocatedTasks/.../action/updateTaskStatus.

Inputs: status (required), taskId (required), checklistId (required), body.

hcm_update_workerC

PATCH a worker (requires approval unless --write).

Inputs: body (required), workerId (required).

hcm_update_worker_assignmentC

PATCH a worker assignment (approval unless --write).

Inputs: body (required), assignmentId (required).

hcm_whoamiA
Read-only

Return local auth/config identity hints (no secrets). HCM RBAC still applies.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.4/5.0

    Scored across 119 tools

    Disambiguation2/5

    While most tools target a distinct resource+action, there are notable overlaps: hcm_health and hcm_test_connection are explicitly the same operation, and hcm_lov_finder/hcm_lov_find plus resource-specific searches blur boundaries. The massive set also includes multiple near-duplicate Atom and balance helpers that make selection error-prone.

    Naming Consistency4/5

    All tools share the hcm_ prefix and most follow a consistent verb_noun pattern (search_*, get_*, create_*, update_*, delete_*, list_*). Minor deviations like hcm_health, hcm_lov_finder, hcm_atom_poll, and hcm_test_connection are in the minority and still readable.

    Tool Count1/5

    119 tools is extreme over-scoping for a single MCP server, far beyond the 1-5 well-scoped range and into the 50+ territory. Even for a broad HCM domain, the surface is bloated with duplicate helpers, generic rest tunnels, and setup/probe tools that could be consolicated.

    Completeness4/5

    The tool surface is remarkably broad, covering workers, absences, talent, payroll, recruiting, benefits, organizations, time, notifications, webhooks, audit, and Atom change detection. Minor gaps exist (e.g., no worker delete, no update/delete for several read-only resources), but core HCM workflows are largely represented.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Insperity's REST API to access employee data, including employee lists, check details, and profile information for HR management tasks.
      -
    • A
      license
      A
      quality
      B
      maintenance
      An MCP server that lets AI models interact with Oracle Fusion Cloud HCM across its entire REST surface. It uses generic, schema-aware tools to dynamically discover licensed modules and resources without per-endpoint code.
      6
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with Oracle Fusion HCM via REST, SOAP, SQL, and BPM, supporting catalog search, operation execution, ESS processes, BI Publisher reports, security diagnostics, and workflow management.
      -