@t4dhg/mcp-factorial

MCPattested

v11.0.1Taig Mac CarthyMITUpdated 15d agonpm GitHub

The definitive MCP server for FactorialHR - Full CRUD operations for employees, teams, time off, projects, training, recruiting (ATS), and payroll. Context-optimized with 14 hierarchical tools (117 operations) and safety guardrails.

Works in

ClaudeCursorCopilotGemini

Inferred from the transports this listing declares (stdio). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.

Attested build

A verified provenance attestation binds this artifact to the listed repository. Nobody has claimed the listing yet — this proves where the code was built, not who stands behind it.

158Downloads/wk

3GitHub stars

1Forks

15d agoLast update

Needs 1 credential before it runs

FACTORIAL_API_KEYAPI keyrequired
API key from FactorialHR (Settings > API Keys)

Declared by the author in the official MCP registry. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.

Package

AuthorTaig Mac Carthy

LicenseMIT

Version11.0.1

Sourcenpm+mcp-registry

npm@t4dhg/mcp-factorial

GitHubt4dhg/mcp-factorial

SBOMCycloneDX 1.6 ↓

Trust Status

A

85/100Trusted

✓Listed in Forge index+10/10

✓Identity verified · attested build+20/20

—Ed25519 publish signature+0/5

→ Included automatically when the publisher runs `forge publish`

—Domain verification+0/5

→ Publisher: host /.well-known/forge.json on the package homepage with { "publisher": "<github-login>" }

✓npm Trusted Publishing (Sigstore)+5/5

—npm maintainer match+0/5

→ Publisher: add the verified GitHub login to the npm package's maintainers (npm owner add <login>)

✓CVE scan · clean+30/30

✓Static analysis · clean+20/20

Paste into Claude Code, Cursor, or any AI assistant to fix all gaps

StatusIdentity verified

PublisherUnverified

SignatureUnsigned

Domain—

Provenance✓ Sigstore-verified · f5106ec

Dependencies✓ 60 resolved+ · none vulnerable

Tool surface14 tools · none privileged

Security scan✓ Cleanv11.0.1 · 11d agoHow well does this scan work?

EvalsNone

IndexedSep 9, 2026

Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.

Tools

14 tools · none privileged

Statically extracted from the published packagev11.0.1 · 11d ago

Read out of the source npm actually ships, at scan time. The package was never executed. Tools registered dynamically at runtime, or hidden inside bundled or minified code, can be missed — so this is a floor on the tool surface, not a complete census of it.

Filter toolsPrivileged only

factorial_atsApplicant tracking: job postings, candidates, applications, hiring stages. Full CRUD.

Applicant tracking: job postings, candidates, applications, hiring stages. Full CRUD.

No input schema was published for this tool.

factorial_attendanceAttendance (registro horario): list/get/create/update/delete shift records, clock_in,

Attendance (registro horario): list/get/create/update/delete shift records, clock_in,

No input schema was published for this tool.

factorial_contractsContract and salary data: list, get with employee, filter by job role/level

Contract and salary data: list, get with employee, filter by job role/level

No input schema was published for this tool.

factorial_documentsDocument management: list folders, list/get documents, search, download (OAuth2 required for downloads)

Document management: list folders, list/get documents, search, download (OAuth2 required for downloads)

No input schema was published for this tool.

factorial_employeesManage employees: list, get, search, create, update, terminate

Manage employees: list, get, search, create, update, terminate

No input schema was published for this tool.

factorial_discoverList available FactorialHR tool categories and their actions. Use this first to understand what operations are available.

List available FactorialHR tool categories and their actions. Use this first to understand what operations are available.

No input schema was published for this tool.

factorial_job_catalogView job roles and levels

View job roles and levels

No input schema was published for this tool.

factorial_locationsManage locations: list, get, create, update, delete

Manage locations: list, get, create, update, delete

No input schema was published for this tool.

factorial_payrollView payroll data: supplements, tax identifiers, family situations (read-only)

View payroll data: supplements, tax identifiers, family situations (read-only)

No input schema was published for this tool.

factorial_projectsProject management: projects, tasks, workers, time records. Full CRUD operations.

Project management: projects, tasks, workers, time records. Full CRUD operations.

No input schema was published for this tool.

factorial_teamsManage teams: list, get, create, update, delete

Manage teams: list, get, create, update, delete

No input schema was published for this tool.

factorial_time_offManage leave requests: list, get, create, update, cancel, approve, reject, view types and allowances

Manage leave requests: list, get, create, update, cancel, approve, reject, view types and allowances

No input schema was published for this tool.

factorial_trainingTraining programs, sessions, and enrollments. Full CRUD operations.

Training programs, sessions, and enrollments. Full CRUD operations.

No input schema was published for this tool.

factorial_work_areasManage work areas within locations

Manage work areas within locations

No input schema was published for this tool.

14 of 14 tools published a description.

Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.

About

The definitive MCP server for FactorialHR - Full CRUD operations for employees, teams, time off, projects, training, recruiting (ATS), and payroll. Context-optimized with 14 hierarchical tools (117 operations) and safety guardrails.

Keywords

mcpmodel-context-protocolmcp-serverfactorialfactorialhrfactorial-hrhrishrhrmhuman-resourcesemployee-managementtime-offattendanceptorecruitingatsapplicant-trackingtrainingprojectspayrollclaudeclaude-codeanthropicaillmai-integrationenterprise

Alternatives

Comparing tool surfaces…

Tools exposed

14 tools · none privileged · observed 2026-09-13 by static extraction. A tool surface is what one scan read on one day, not a live capability list.

factorial_ats
factorial_attendance
factorial_contracts
factorial_documents
factorial_employees
factorial_discover
factorial_job_catalog
factorial_locations
factorial_payroll
factorial_projects
factorial_teams
factorial_time_off
factorial_training
factorial_work_areas

Linked names open Forge’s index of every entry observed exposing that tool. Browse all indexed tools.

Dependency tree

What one Forge scan resolved from npm metadata on 2026-09-13 — observed resolution, not a publisher declaration.

60 packages resolved · 3 direct · none carrying advisories Resolution stops at depth 4 and 60 packages.

zod3.25.76
dotenv16.6.1
@modelcontextprotocol/sdk1.30.017 dependencies
- ajv8.20.04 dependencies
  - fast-deep-equal3.1.3
  - fast-uri3.1.7
  - json-schema-traverse1.0.0
  - require-from-string2.0.2
- zod4.6.4
- cors2.8.6+2 not drawn
- hono4.13.7
- jose6.2.12
- express5.2.1+27 not drawn1 dependency
  - content-type1.0.5
- raw-body3.0.2+4 not drawn
- ajv-formats3.0.11 dependency
  - ajv8.20.0shown above
- cross-spawn7.0.6+3 not drawn
- eventsource3.0.71 dependency
  - eventsource-parser3.1.1
- content-type1.0.5shown above
- pkce-challenge5.0.1
- @hono/node-server2.1.1
- json-schema-typed8.0.2
- eventsource-parser3.1.1shown above
- express-rate-limit8.7.0+2 not drawn
- zod-to-json-schema3.25.2

The crawl stopped at the depth-4 limit. Anything below that level was never resolved.

The crawl stopped at the 60-package limit. The rest of the tree was never resolved.

36 more resolved packages are not drawn here (display cap: 24). Every dependency carrying an advisory is drawn regardless of the cap. Full inventory (CycloneDX SBOM)

Declared but not resolved

55 declared dependencies never landed in the tree. They are missing from Forge's resolution, not from the package.

package cap reached: 50
below the depth cap: 5

es-define-property ^1.0.1 — required by qs@6.16.0package cap reached
wrappy 1 — required by once@1.4.0package cap reached
http-errors ^2.0.1 — required by send@1.2.1package cap reached
mime-types ^3.0.2 — required by send@1.2.1package cap reached
ms ^2.1.3 — required by send@1.2.1package cap reached
on-finished ^2.4.1 — required by send@1.2.1package cap reached
range-parser ^1.2.1 — required by send@1.2.1package cap reached
statuses ^2.0.2 — required by send@1.2.1package cap reached
ms ^2.1.3 — required by debug@4.4.3package cap reached
debug ^4.4.0 — required by router@2.2.0package cap reached
depd ^2.0.0 — required by router@2.2.0package cap reached
is-promise ^4.0.0 — required by router@2.2.0package cap reached

+43 more not listed. The counts by reason above cover all of them.

Not followed: peerDependencies. This tree covers runtime dependencies only, so anything those pull in was never resolved.