mcp-factorial (t4dhg/mcp-factorial) is an MCP server listed on the M8ven Trust Index. It scores 70 out of 100, grade C. It declares 14 tools. No publisher has claimed this listing.

Caution

70/100

mcp-factorial

Item: mcp-factorial
Rating: 70
Author: M8ven

Full CRUD MCP server for FactorialHR: employees, teams, time off, projects, ATS, payroll.

→ t4dhg/mcp-factorial · listed on glama

Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.

How we verified

Code Verified⚡ Live Monitored: not connected

Verified is a snapshot. Live keeps it current, and builds your track record.

⚡ Connect GitHub → continuous verification on every push why connect →

Who stands behind it

t4dhg

Source: Glama · also listed on ModelScope

Is this your MCP?

Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →

⚡ Connect GitHub for Live Monitored

Install from

Glamanot scored here ModelScopenot scored here

The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.

// key findings

🚨

Secret credentials may flow to a network call

1 flow detected: FACTORIAL_OAUTH_CLIENT_ID. We can’t prove the destination matches the brand the credential belongs to.

🚨

Known vulnerabilities in dependencies: 1 critical, 2 high

Affects packages this MCP installs at runtime. Upgrade or remove the affected dependency.

🔐

You'll be asked for 4 credentials: CODECOV_TOKEN, FACTORIAL_API_KEY, FACTORIAL_OAUTH_CLIENT_SECRET, FACTORIAL_OAUTH_REFRESH_TOKEN

These are read from process.env at runtime. Make sure you trust where they’ll be sent.

// tools this server exposes14 tools

These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.

factorial_discover

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

factorial_ats

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

factorial_attendance

Manage shifts (clock in/out): list, get, create, update, delete

factorial_contracts

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

factorial_documents

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

factorial_employees

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

factorial_job_catalog

View job roles and levels

factorial_locations

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

factorial_payroll

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

factorial_projects

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

factorial_teams

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

factorial_time_off

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

factorial_training

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

factorial_work_areas

Manage work areas within locations

// known CVEs in dependencies1 critical2 high

Disclosed vulnerabilities in this server's declared npm dependencies (via OSV). Whether each is reachable depends on the installed versions.

criticalvitest@2.1.9GHSA-5xrq-8626-4rwp

When Vitest UI server is listening, arbitrary file can be read and executed

high@modelcontextprotocol/sdk@1.25.1GHSA-345p-7cg4-v4c7

@modelcontextprotocol/sdk has cross-client data leak via shared server/transport instance reuse

high@modelcontextprotocol/sdk@1.25.1GHSA-8r9q-7v3j-jr4g

Anthropic's MCP TypeScript SDK has a ReDoS vulnerability

Depend on this server? Get alerted when its CVEs change.Watch this server free →

// environment variables

To run this server yourself, you supply these values. They go in your own MCP client configuration and stay on your machine. The secret label means the value is sensitive, not that the server mishandles it.

🔐 secretCODECOV_TOKEN

configENV_FILE_PATH

🔐 secretFACTORIAL_API_KEYRequired

configFACTORIAL_API_VERSION2025-10-01

configFACTORIAL_BASE_URL

configFACTORIAL_MAX_RETRIESMax retry attempts 3

configFACTORIAL_OAUTH_CLIENT_IDOAuth2 client ID (for downloads) -

🔐 secretFACTORIAL_OAUTH_CLIENT_SECRETOAuth2 client secret (for downloads) -

🔐 secretFACTORIAL_OAUTH_REFRESH_TOKENOAuth2 refresh token (for downloads) -

configFACTORIAL_TIMEOUT_MS30000

// quality suggestions

Tool annotations

No tools have read-only/destructive annotations

Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.

All four hints declared on every tool

14/14 tools missing one or more hints — factorial_discover (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); factorial_ats (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); factorial_attendance (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +11 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.

For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.

Tool test coverage

Only 0/14 tools referenced in tests (0%)

Write tests that reference each tool by name so every tool has at least one test.

Production dependencies are patched

0 critical, 2 high severity in production deps — @modelcontextprotocol/sdk@1.25.1 (high), @modelcontextprotocol/sdk@1.25.1 (high)

Run npm audit fix, or upgrade the affected packages to a non-vulnerable version.

Dev dependencies

1 critical/high in dev-only deps (does not ship to users)

Upgrade dev dependencies when convenient.

Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.

// full audit trail

The findings above are the summary. The full trail, every check we ran, each deduction, the network hosts observed and the dependency advisories, goes to verified publishers, along with an alert whenever a new one lands. Verified publishers can also review each finding and dispute it in one click. Publisher corrections have sharpened several of our checks this month, because the maintainer knows the codebase better than any scanner.

// improvement guidance — verified publishers only

We have 5 concrete improvements we can share with the publisher of this MCP. Each comes with specific guidance to raise the trust score.

// embed badge in your README

[![M8ven Verified](https://m8ven.ai/badge/mcp/t4dhg/mcp-factorial?variant=verified)](https://m8ven.ai/mcp/t4dhg/mcp-factorial)

Shows verification status without the grade. Want the grade badge instead? Remove ?variant=verified from the URL.

commit: cf9f60ae4965c8faccb283b93e5f5990d9998c91

code hash: 228c16a806b40338350e7a3933c12ae6fbcdd4eaf350c6aa5539b51fcae40f97

view raw JSON →

Check MCPs from inside your assistant

Tool Check · MCP

Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.

https://m8ven.ai/api/mcp/tool-check

check_toolsearch_toolscompare_toolsrecommend_alternativescheck_publisherreport_concern

How to add it →Free · no account needed · works in any MCP client