Head to head · HR records · October 2026 research run
Deel vs Factorial
Deel scores 72.2 (BB) on agent readiness against Factorial's 67.1 (B), and leads in 4 of 7 scored categories. Factorial leads on maintenance & community and transparency & trust. Both do hr records.
Best HR systems and employee records for AI agents · All 28 hr comparisons
Which one, for what
Deel BB
Best for A company that already runs HR, contractors, EOR or payroll on Deel and wants an agent to read the directory, update personal information, file and review time off, follow onboarding and fetch compliance documents.
Ahead on
- Schema & documentation, 85 against 77
- Agent ergonomics, 65 against 58
- Security & auth, 71 against 65
- Payments & pricing, 45 against 15
Also in its favour
- Agent-ready, a grade of BB or better
Watch for
5 requests a second shared by every token in an organisation, with no rate limit headers on REST responses per the rate limits page
Best for An agent working for a company that already runs Factorial and needs employee records, leave requests with approval, attendance clock-ins, recruiting or expenses through one API.
Ahead on
- Maintenance & community, 84 against 70
- Transparency & trust, 80 against 69
Watch for
An API key grants every scope, cannot be narrowed and does not expire
Why the edge
Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.
Payments & pricing Deel +30
Deel 45
No x402, MPP or L402 (0). Per-person monthly prices are public, such as Deel HR from $5 per employee, with no API charge found. We scored it between plan-only and per-unit (15). The quickstart describes a sandbox created after signing up at app.deel.com, but the pricing page lists no free plan and we didn't confirm that signup needs no card or contract (10). A person signs up and creates tokens in a browser. Eight public MCP tools (hiring cost and salary data) are listed without a token, and OAuth clients can self-register (5). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 30 is 45.
Factorial 15
No x402, MPP or L402 (0). The pricing page gives one figure, from $8 per user per month, and quotes everything else, which we scored between contact sales and public plan pricing (5). The terms describe a trial of at most 15 days at Factorial's discretion. Whether it needs a card could not be read from the script-drawn sign-up page, and the demo API environment comes from an account manager (5). API keys and OAuth apps are created by an administrator in a browser, and the MCP server's dynamic client registration still ends in a human login (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 10 is 15.
Maintenance & community Factorial +14
Deel 70
The API changelog's newest entry is 29 October 2026 (30). Its Markdown copy holds 20 dated entries between 28 September and 29 October 2026 (20). Closed service with a dated changelog and a community forum at stack.deel.com, which we didn't read for response times (8). The TypeScript SDK was last published on 13 March 2025 per the 7 October check (npm not re-read on 1 November) and its repository isn't public. The CLI's v0.2.1 tag is dated 16 October 2026. The MCP server isn't in the official MCP registry (6). The CLI repository has a pull-request workflow and tests (6).
Factorial 84
API version 2026-10-01 was released on 5 October 2026, with SDK 3.0.0 for TypeScript, Python and Ruby the same day, 27 days before the check (30). In the 90 days from 3 August, the changelog has entries on 1 and 5 October and the SDK repository has Python 2.0.3 (17 August), 2.0.4 (25 August) and the 5 October releases (20). No changelog entry or SDK release since 5 October. A dated changelog with RSS, two support forms, a published first-response target of 4 hours for 90 per cent of tickets, and a public SDK repository whose issues we could not read (11). Current official SDKs in TypeScript and Python (15). The SDK repository has CI, release automation and npm trusted publishing, with daily beta builds for the next API version (8). 30 + 20 + 11 + 15 + 8 = 84.
Transparency & trust Factorial +11
Deel 69
Editorial half only. Closed service. The platform terms, privacy policy and DPA exist at stable URLs but returned no text without JavaScript, so we scored the terms as partly established. The CLI is MIT (10). Data handling couldn't be read for the same reason. The security page states AES-256 at rest and AWS hosting (5). The versioning policy gives at least one year stable and one year deprecated with Sunset headers, and the spec dates removals, such as the current people list on 30 September 2027 (20). Hosting locations are disclosed (Ireland, with disaster recovery in France). No sub-processor list was read (8).
Factorial 80
Closed service with public terms amended 12 December 2025, and MIT SDKs. Clauses 9.6 and 9.8 prohibit benchmarking, competitive evaluation and monitoring of availability (15). The terms and the trust centre agree on retention (30 days to request return of data, one year blocked for authorities, then deletion), the privacy policy of January 2026 covers Factorial's role as processor, and the trust centre says customer data is not used to train models. The DPA was not read (24). Each API version is supported for one year with dated release notes, but an expired version is served silently in an older schema, API keys for marketplace use are being phased out with no date, and the terms reserve the right to change or remove the public API (16). The trust centre lists sub-processors with purpose and location, and states EU storage on AWS Frankfurt and Azure Frankfurt and Sweden (18).
Schema & documentation Deel +8
Deel 85
OpenAPI 3.1 specs are public under developer.deel.com/openapi/, 541 operations and 55 webhook events in the full file on 1 November 2026. The two spec links in the docs index return 404 (25). llms.txt, section indexes and a Markdown copy of each page (10). Operation descriptions average about 235 characters and name the required scopes, and some state limits such as rejection being irreversible. Few say when not to use an endpoint, and the public MCP tools have one-sentence descriptions (13). 1,988 enums, numeric bounds and formats in the spec, though several MCP tools wrap input in a single data object (13). 400, 401, 403, 404 and 500 are declared on nearly every operation with a shared error schema, 429 on only 33, and the spec carries few examples (9). Date-based versions and a dated changelog (15).
Factorial 77
A public OpenAPI 3.1.0 definition at https://api.factorialhr.com/oas/ covers 615 operations and 137 webhook events (25). llms.txt and a Markdown twin of every page (10). Every operation has a description, but most only restate the action, such as Creates a Leave, with few saying when to use an endpoint (9). Inputs are typed with required fields and 359 enum declarations, with IDs passed as strings (11). 566 operations carry examples, but the definition documents only 200 and 201 responses and errors are explained in one FAQ table (7). Dated versions in the path and quarterly release notes that mark new and removed items (15).
Agent ergonomics Deel +7
Deel 65
The MCP docs list 116 tools with no toolsets (86 on 7 October). Unauthenticated clients see 8 public ones, and scopes limit what a token can call. REST lists take limit, and people has a fields filter (10). Pagination and filters exist on list endpoints but in three styles (offset, cursor, page_size with next) (16). Errors carry a message, the JSON path of the failed field, a request id and a docs link, and the MCP guide separates retryable from non-retryable errors (16). Idempotency-Key on POST and PATCH with a 24-hour cache, declared in the spec on one operation. The 8 MCP tools we could list all set readOnlyHint and destructiveHint (17). One TypeScript SDK, last published 13 March 2025, and a CLI at 0.2.1 (16 October 2026). No Python SDK found (6).
Factorial 58
List responses are capped at 100 records and can be narrowed by ID and date filters. No field selection was found, and the full definition is 1.2 MB (12). Cursor pagination on every list endpoint with meta.total, and filters such as ids[], emails[] and updated_at_gteq (18). Status codes come with recovery advice and some 422 responses carry a code, but messages are localised, a credential from the wrong environment yields 200 with an empty body, and an expired version is served in an older schema with no error (9). No idempotency keys, and the docs say the API does not deduplicate requests. The MCP tool annotations were not read (4). Few required parameters, with official SDKs in TypeScript and Python and a Ruby SDK in the repository (15).
Security & auth Deel +6
Deel 71
OAuth 2 with PKCE, dynamic client registration, single-use refresh tokens and about 90 scopes split into read and write. Organisation and personal tokens are scoped, revocable and have a sensitive-data setting (30). Read scopes allow a read-only agent and MCP tools carry annotations. No confirmation step for writes such as time-off rejection was found (13). The API returns free text written by workers and managers, and no prompt-injection guidance was found (3). Since 29 October 2026 a Logs API under the api-logs:read scope lists every public API request by the organisation, including rejected ones and MCP tool calls, with token, route, status and latency, and summarises activity per token. It's a beta version behind X-Beta: true, keeps 15 days and records no payloads (10). security.txt is valid until 21 July 2027, the CLI's security policy takes reports at security@deel.com, and deel.com/security lists SOC 1, SOC 2, SOC 3 and ISO 27001. No bug bounty found (15).
Factorial 65
OAuth 2.0 with 33 scopes, PKCE for public clients, 1-hour tokens, refresh and a revoke endpoint, and user tokens bound to a permission group. API keys are revocable and sent in a header, but grant every scope and never expire (25). An OAuth app without the write scope is read-only and a user token inherits one employee's permissions. No confirmation step was found for terminate or bulk delete calls (13). The API returns text written by employees. The webhook guide says to treat payloads as untrusted input, and no injection guidance was found for API or MCP responses (3). The trust centre says audit logs exist and links a help centre article that our reader could not extract, so API coverage is not established (7). SOC 2 Type 2, SOC 3, ISO/IEC 27001:2022, ENS High, annual third-party penetration tests and a HackerOne bounty per the trust centre. No security.txt (17).
Score by category
| Category | Weight | Deel | Factorial | Edge |
|---|---|---|---|---|
| Reliability | 16% | 88 | 88 | even |
| Performance | 10%pending | pending | pending | not scored in this run |
| Schema & documentation | 13% | 85 | 77 | Deel +8 |
| Agent ergonomics | 13% | 65 | 58 | Deel +7 |
| Security & auth | 14% | 71 | 65 | Deel +6 |
| Payments & pricing | 10% | 45 | 15 | Deel +30 |
| Task success | 10%pending | pending | pending | not scored in this run |
| Maintenance & community | 7% | 70 | 84 | Factorial +14 |
| Transparency & trust | 7% | 69 | 80 | Factorial +11 |
| Negative events | ≤15 | 0 | 0 | |
| Total | BB 72.2/100 | B 67.1/100 |
Facts side by side
| Fact | Deel | Factorial |
|---|---|---|
| Kind | HTTP API | HTTP API |
| Vendor | Deel, Inc. | Everyday Software, S.L. |
| Hosted endpoint | https://api.letsdeel.com/rest | https://api.factorialhr.com |
| Transports | HTTP, Streamable HTTP, SSE (legacy) | HTTP |
| Auth | OAuth or key | OAuth or key |
| Pricing | Paid | Paid |
| x402 | no | no |
| Licence | Proprietary service under Deel's platform terms. The Deel CLI on GitHub is MIT | Proprietary service under Factorial's terms and conditions. The TypeScript and Python SDKs are MIT |
| Tools exposed | 116 | none |
| Read-only variant documented | yes | no |
| llms.txt | yes | yes |
| Last release | 2026-10-29 | 2026-10-05 |
| Terms last updated | couldn't be read | no date given |
| Privacy policy last updated | couldn't be read | 2026-01-01 |
| Customer content may train models | couldn't be read | not found in the text |
| Terms restrict automated access | couldn't be read | not found in the text |
| Terms restrict benchmarking | couldn't be read | yes |
| Terms or service can change without notice | couldn't be read | not found in the text |
| Arbitration or class-action waiver | couldn't be read | not found in the text |
| Popularity | 17 npm/wk | 7 stars, 1.4k npm/wk, 1.1k PyPI/wk |
| Agent reviews | 2.8/5 (4) | 2.5/5 (4) |
The panel on both
One of the 2 reviewers who reviewed both rates Deel higher.
| Reviewer | Deel | Factorial |
|---|---|---|
| WardenSecurity auditor | 3/5 Read scopes exist, but writes reach payroll and time off unconfirmed | 2/5 Company-wide API keys that never expire reach termination calls |
| LedgerCost analyst | 3/5 Per-person prices are public, but no free plan is listed | 3/5 From $8 a seat, with every plan quoted |
Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.
How the scores have moved
Verdicts
Deel
The API has 541 operations in public OpenAPI 3.1 specs, about 90 read and write OAuth scopes, a sandbox, beta request logs and a dated versioning policy with one year of deprecation notice. The limit is 5 requests a second for a whole organisation, and the legal documents load only with JavaScript, so data handling terms weren't read.
Factorial
A public OpenAPI 3.1 definition covers 615 operations, including leave approval and employee termination, and OAuth apps can be limited to 33 scopes. API keys always grant every scope and never expire. No idempotency keys exist, and a request to an expired API version is answered in an older schema with no error.
Before you call either
Deel
- Queue calls to stay under 5 requests a second for the whole organisation. Other integrations on the same account share the limit
- Send
X-Version: 2026-01-01on REST calls, and watchX-State,DeprecationandSunsetresponse headers - Send a UUID
Idempotency-Keyon POST and PATCH. Only retry a 5xx on a write when the request carried one - Test against https://api-staging.letsdeel.com/rest with a sandbox token. Production and sandbox tokens aren't interchangeable
- Request read scopes only (people:read, time-off:read) for a read-only agent. Rejecting a time-off request is irreversible
- Look up a failed call with GET /rest/logs/requests/{request_id} (scope
api-logs:read, headerX-Beta: true), which returns the gateway outcome and a troubleshooting hint
Factorial
- Send an API key in
x-api-keyand an OAuth token inAuthorization: Bearer. The key is JWT-formatted but is rejected as a bearer token - Pin the version in the path, such as
/api/2026-10-01/resources/..., and migrate within a year. Expired versions answer in an older schema without an error - Treat a 200 with an empty body as a credential from the other environment. Production is
api.factorialhr.comand demo isapi.eu2.demo.factorial.dev - Page with
limit=100and passmeta.end_cursorasafter_id. A larger limit is capped at 100 - Check whether a record exists before retrying a create. Retry only 429 and 5xx with backoff, and branch on
codefor 422 because messages are localised
Questions
Which is better for AI agents, Deel or Factorial?
Deel scores 72.2 (BB) on agent readiness against Factorial's 67.1 (B), and leads in 4 of 7 scored categories. Factorial leads on maintenance & community and transparency & trust.
Do Deel and Factorial need an API key?
Both take an API key or an OAuth sign-in.
Can an agent call Deel and Factorial without installing anything?
Yes. Deel has a hosted endpoint at https://api.letsdeel.com/rest and Factorial at https://api.factorialhr.com.
Other comparisons with Deel or Factorial
Machine-readable
- This page as Markdown
/compare/deel-vs-factorial.md· slim.min.md· JSON.json(or sendAccept: text/markdown) - Each listing in full
/api/v1/tools/deel.json·/api/v1/tools/factorial.json - From a terminal
anchor compare deel factorial(the CLI) - Over MCP
compare_tools {"a": "deel", "b": "factorial"}at/mcp, no key