{
 "categories": [
  "hr",
  "hcm"
 ],
 "deployment": "saas",
 "evidence": [
  {
   "date": "2026-10-04",
   "fact": "homepage",
   "note": "Factorial presents HR, finance, and IT processes with an assistant named One, and says more than 17,000 companies trust Factorial.",
   "source": "https://factorialhr.com/",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "deployment",
   "note": "The homepage presents Factorial as a hosted HR product used by companies.",
   "source": "https://factorialhr.com/",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "platforms",
   "note": "The product is used as a web application. The homepage does not name desktop operating systems.",
   "source": "https://factorialhr.com/",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "license",
   "note": "The homepage markets Factorial to companies and points at an open API and a marketplace. It does not publish a free plan.",
   "source": "https://factorialhr.com/",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.api.exists",
   "note": "Factorial documents a public API with API keys and OAuth 2.",
   "source": "https://apidoc.factorialhr.com/docs/authentication",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.api.kinds[0]",
   "note": "The API index lists HTTP resource operations such as GET, POST, PUT, and DELETE for attendance, employees, and time off under the 2026-07-01 API.",
   "source": "https://apidoc.factorialhr.com/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.api.auth[0]",
   "note": "API keys are sent in the x-api-key header with no prefix. The page says they have total company access, never expire, and require an administrator.",
   "source": "https://apidoc.factorialhr.com/docs/api-keys",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.api.auth[1]",
   "note": "OAuth 2 access tokens are sent as Authorization Bearer. The page says user tokens and company tokens each last 1 hour.",
   "source": "https://apidoc.factorialhr.com/docs/oauth-2.md",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.api.coverage",
   "note": "The index lists attendance shifts, employees, time off allowances and leaves, and other HR resources. API keys are for internal integrations. Marketplace integrations must use OAuth.",
   "source": "https://apidoc.factorialhr.com/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.sdk.exists",
   "note": "Factorial documents official TypeScript and Python clients generated from the OpenAPI spec.",
   "source": "https://apidoc.factorialhr.com/docs/sdks-overview.md",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.sdk.languages[0]",
   "note": "The TypeScript package is @factorialco/api-client.",
   "source": "https://apidoc.factorialhr.com/docs/sdks-overview.md",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.sdk.languages[1]",
   "note": "The Python package is factorial-api-client.",
   "source": "https://apidoc.factorialhr.com/docs/sdks-overview.md",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.sdk.official",
   "note": "The page calls both packages official client libraries.",
   "source": "https://apidoc.factorialhr.com/docs/sdks-overview.md",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.mcp.first_party",
   "note": "Factorial documents a hosted MCP server at https://mcp.factorialhr.com with Streamable HTTP and OAuth 2.0. Direct tools cover attendance, tasks, time off, and employee lookup.",
   "source": "https://apidoc.factorialhr.com/docs/mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.extensibility.webhooks",
   "note": "The API index has a webhooks section and lists subscriptions such as attendance shift clock-in. The SDK page says deliveries echo a challenge in x-factorial-wh-challenge.",
   "source": "https://apidoc.factorialhr.com/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "modalities.agent_docs.llms_txt",
   "note": "https://apidoc.factorialhr.com/llms.txt is an index of the Factorial developer portal, including authentication, SDKs, MCP, and resource references.",
   "source": "https://apidoc.factorialhr.com/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "verdict.scores.api",
   "note": "The versioned REST API plus official SDKs cover attendance, employees, and time off. API-key scope is company-wide, and OAuth tokens last 1 hour, so the score stays in the broad production tier.",
   "source": "https://apidoc.factorialhr.com/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "verdict.scores.mcp",
   "note": "The official hosted server is useful for clock-in, tasks, time off, and lookup. Broader questions go through Factorial One, which is plan-gated and consumes credits.",
   "source": "https://apidoc.factorialhr.com/docs/mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "freshness.watch[0].url",
   "note": "Opened the current MCP guide, including the endpoint, OAuth, and direct tools.",
   "source": "https://apidoc.factorialhr.com/docs/mcp-server",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "freshness.watch[1].url",
   "note": "Opened the current authentication overview for API keys and OAuth 2.",
   "source": "https://apidoc.factorialhr.com/docs/authentication",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "freshness.watch[2].url",
   "note": "Opened the current API index for version 2026-07-01.",
   "source": "https://apidoc.factorialhr.com/llms.txt",
   "tier": "declared"
  },
  {
   "date": "2026-10-04",
   "fact": "freshness.watch[3].url",
   "note": "Opened the current official SDK overview for TypeScript and Python.",
   "source": "https://apidoc.factorialhr.com/docs/sdks-overview.md",
   "tier": "declared"
  }
 ],
 "freshness": {
  "last_verified": "2026-10-04",
  "volatility": "high",
  "watch": [
   {
    "type": "docs",
    "url": "https://apidoc.factorialhr.com/docs/mcp-server"
   },
   {
    "type": "docs",
    "url": "https://apidoc.factorialhr.com/docs/authentication"
   },
   {
    "type": "docs",
    "url": "https://apidoc.factorialhr.com/llms.txt"
   },
   {
    "type": "docs",
    "url": "https://apidoc.factorialhr.com/docs/sdks-overview.md"
   }
  ]
 },
 "homepage": "https://factorialhr.com/",
 "id": "factorial",
 "license": "commercial",
 "modalities": {
  "agent_docs": {
   "llms_txt": true
  },
  "api": {
   "auth": [
    "api-key",
    "oauth2"
   ],
   "coverage": "partial",
   "docs": "https://apidoc.factorialhr.com/docs/authentication",
   "exists": true,
   "kinds": [
    "rest"
   ]
  },
  "cli": {
   "exists": "unknown"
  },
  "computer_use": {
   "issues": [],
   "viability": "unknown"
  },
  "data_access": {
   "export": [],
   "import": []
  },
  "extensibility": {
   "scripting": [],
   "webhooks": true
  },
  "integrations": {
   "make": "unknown",
   "n8n": "unknown",
   "power_automate": "unknown",
   "zapier": "unknown"
  },
  "mcp": {
   "first_party": true,
   "third_party": [],
   "verdict": "official"
  },
  "rpa": {
   "drivability": "unknown",
   "notes": "No repeatable UI probe was run. The public API, official SDKs, and hosted MCP server cover HR actions without browser control.\n",
   "ui_stack": [],
   "vendor_support": []
  },
  "sdk": {
   "exists": true,
   "languages": [
    "typescript",
    "python"
   ],
   "official": true
  }
 },
 "name": "Factorial",
 "platforms": [
  "web"
 ],
 "related": {
  "alternatives": [
   "personio",
   "hibob",
   "bamboohr",
   "rippling"
  ],
  "our_products": []
 },
 "schema_version": 1,
 "score_version": 1,
 "status": "active",
 "vendor": "Factorial",
 "verdict": {
  "best_path": "api",
  "scores": {
   "api": 8,
   "cli": null,
   "computer_use": null,
   "integrations": null,
   "mcp": 7,
   "overall": 8,
   "rpa": null
  },
  "summary": "Factorial HR is automatable today through its public API. The current developer index is version 2026-07-01 and lists attendance shifts, employees, time off, and other resources, plus webhook subscriptions. API keys are sent as x-api-key. They do not expire and the API keys page says they have total access for the company, so an administrator creates them for internal integrations. Marketplace integrations must use OAuth 2. OAuth access tokens are sent as Authorization Bearer. The current OAuth page says both user tokens and company tokens last 1 hour and can be refreshed. Official SDKs are @factorialco/api-client for TypeScript and factorial-api-client for Python. They accept an API key or an OAuth bearer token. Factorial hosts an MCP server at https://mcp.factorialhr.com using Streamable HTTP and OAuth 2.0 with dynamic client registration. Direct tools cover clock in and out, tasks, time off, and employee lookup, and they run as the signed-in user. A Factorial One tool can reach policies, contracts, and reports when the plan includes it, and those calls consume Factorial One credits. https://apidoc.factorialhr.com/llms.txt is a first-party API index. This record does not include Factorial Code. Zapier, Make, Power Automate, and n8n were not assessed. A general CLI was not established. Computer-use viability is unassessed. API scores 8. MCP scores 7. API is the best path because an API key or OAuth token calls the versioned HR resources directly, without an MCP client and without Factorial One credits.\n"
 }
}