# Can an AI agent use WorkOS? L3 · Does the work

WorkOS is a developer service for authentication, single sign-on and user management, with organizations, roles, audit logs and SCIM directories.

**L3 · Does the work** · [What the levels mean](https://agentdrives.com/method/levels?via=md)

Rank among the 246 products we drove:

- Time to get in: 1 minute, tied #6 (Getting in on its own)
- Core work done: 90%, tied #50 (9 of 10 core tasks)
- Steps on its own: 3 / 5, tied #35 (Find to Leave, no person)
- Holds up: 67 / 100, tied #92 (Reliability under errors)

**Can an AI agent use WorkOS? Yes.** Our agent got into WorkOS on its own without signing up, got an API key and used its API and CLI. It also has an MCP server. It offers agents a way to pay: Stripe Projects.

- Level confirmed: Not yet (Level from one drive; a second must agree)
- Got in by: Try first, claim later (1 minute, no account)
- Got as far as: Use: 9 of 10 core tasks (No payment made)

Category: Auth and identity · Connects by: MCP, API, CLI · Agent payments: Stripe Projects; our agent didn't try it · Driven: 2 Nov 2026

**How to connect**
- MCP server URL: `https://mcp.workos.com/mcp` (streamable HTTP, documented). Source: https://mcp.workos.com/mcp
- API base URL: `https://api.workos.com` (documented). Source: https://workos.com/openapi.json
- CLI install: `npm install -g workos` (documented). Source: https://workos.com/docs
- Docs page: `https://workos.com/docs` (tested in our drive). Source: https://workos.com/docs

Checked 17 Nov 2026: MCP server asks for a sign-in; llms.txt and OpenAPI unchanged since the check before.

See [how it ranks among auth providers for agents](https://agentdrives.com/research/best-auth-providers-for-ai-agents?via=md).

## From finding it to leaving

What an agent managed without a person, at each step.

1. **Find**: On its own. Docs it can act on: llms.txt, an OpenAPI and an MCP server. (600 doc pages read)
2. **Get in**: On its own. Got in without signing up. Email and code: stopped by a phone number; CLI code login: stopped by a phone number. (1 minute)
3. **Use**: On its own. Did: create and delete organizations and add members; send, read and revoke invitations that reach a real inbox. (9 of 10 core tasks)
4. **Pay**: Not tried. Paying needs an account. (1 way for agents to pay)
5. **Leave**: Partly. Nothing to cancel. Its key still works after leaving.

To reach L4: Remove what it made.

## How an agent connects

MCP, API, OpenAPI, CLI, agent payments and llms.txt found.

- **MCP server**: Listed, not tested. Official server. Https://mcp.workos.com/mcp, OAuth only (PRM, CIMD, DCR). Sign-in needed to see its tools. https://mcp.workos.com/mcp (1 tool mapped in our drive, none of them called)
- **API**: 195 of 271 tested. REST, OpenAPI 3.1.1. (271 operations mapped in our drive)
- **OpenAPI**: Yes. A machine-readable description of the API.
- **CLI**: 76 of 132 tested. npm package workos 0.24.0 (npx workos@latest). (132 commands mapped in our drive)
- **SDK**: None found.
- **llms.txt**: Yes. https://workos.com/docs/llms.txt
- **Agent payments**: Listed, not tested. Stripe Projects. The checkout wasn't reached. Stripe Directory lists it as @workos, with Stripe Projects. [Stripe Docs, 10 Nov 2026](https://docs.stripe.com/directory)
- **Docs**: In part. Covers getting started, auth, error codes and code examples. Describes each operation only in part: completeness 75 of 100. 10 of 17 documented ways to do the core work worked. https://workos.com/docs (600 of 946 pages read)

**Changed since it was driven** (checked daily)
- OpenAPI: 4 endpoints added, 12 Nov
- llms.txt: 23 links added, 839 removed and 37 sections changed, 6 Nov
- llms.txt: 1 link added, 5 Nov
- llms.txt: 4 links added, 4 Nov

[The standards](https://agentdrives.com/standard)

## Getting in

Our agent tried 6 of 12 ways in; 1 worked without a person.

The way that worked: **Try first, claim later**, 1 minute. No inbox, browser or person needed.

- Agent on a server (API, MCP, CLI): Partly. Signs up, gets an API key, makes its first API call and does 9 of its 10 core tasks, then stops: its key still works after leaving. It can't delete what it made.
- Assistant in its own browser (Like ChatGPT agent): Partly. Signs up and does 9 of its 10 core tasks, then stops: its key still works after leaving. It can't delete what it made.
- Signed agent (Known to Cloudflare): Yes. Our signed agent got through Cloudflare at sign-up.

| Way in | What happened |
|---|---|
| Try first, claim later | Worked |
| Registration through auth.md | Stopped: The consent page needs an account |
| Email and code | Stopped by a phone number |
| Email and password | Not reached |
| CLI code login | Stopped by a phone number |
| Sign-in for apps (OAuth) | Stopped: The consent page needs an account |
| Identity assertion | Stopped by the sign-in provider |
| Email link | Not tried: The same as another way |
| Continue with Google | Not tried: Not part of this drive |
| Company single sign-on | Not tried: Needs a person's account |
| Added by an admin | Not tried: Needs a person's account |
| A key from a person | Not tried: Needs a person's account |

- Crawlers: **The robots.txt on api.workos.com asks crawlers to stay off sign-up.** Nothing to fix.
- Bot check: **Cloudflare let our agent through at sign-up.** Our agent signs every request (Web Bot Auth).

## What an agent can do with WorkOS

9 of 10 core tasks done, and 16 of 24 others.

- Holds up: 67 of 100 (Reliability 76, Handles mistakes 58). The mean of the two.
- Docs match: 80 of 100 (Docs accuracy 82, Docs completeness 75). Docs accuracy counts 70%, completeness 30%.
- Surface tested: 45 of 100. 227 of 509 passed: the 529 documented operations less the 20 that spend money or reach real people

Core tasks:

| Task | Result | Done through | Tried, not done | Offered, not tried |
|---|---|---|---|---|
| Create a user in AuthKit | Done | API | – | – |
| Create an organization for a customer | Done | API | – | CLI |
| Set up an SSO connection for an organization | Done | API | – | CLI |
| Sign a user in through SSO | Done | API | – | – |
| Sync users and groups from a corporate directory | Done | API, CLI | – | – |
| Record an audit log event | Done | API, CLI | – | – |
| Invite a user to an organization | Done | API | – | CLI |
| Create a role with permissions | Done | API | – | CLI |
| Delete a user | Done | API | – | CLI |
| Check a sign-in attempt for bots and fraud with Radar | Blocked: The API says Radar is not enabled and only support can enable it. | – | API | – |

16 of 24 other tasks done:

- Assign a role to an organization member: Done
- Export audit log events: Done
- Define an audit log event schema: Done
- Enroll an MFA factor for a user: Done
- Generate an Admin Portal link for a customer's IT admin: Done
- Check fine-grained access to a resource: Done
- Encrypt and store an object in Vault: Done
- Register a webhook endpoint: Done
- Read the events stream: Done
- Issue an API key to a customer organization: Done
- Revoke a user session: Done
- Register an OAuth application with WorkOS Connect: Done
- Run a local WorkOS emulator for testing: Done
- Import users from another auth provider: Done
- Block or allow an identifier in Radar: Done
- Configure redirect URIs and CORS origins: Done
- Verify an organization's domain: Partly
- Connect a custom domain for AuthKit: Paid plan
- Send a passwordless magic auth code: Blocked
- Connect a user's third-party account with Pipes: Blocked
- Turn a feature flag on for an organization: Blocked
- Register an agent identity for sign-up: Blocked
- Set the AuthKit branding: Blocked
- Invite a teammate to the WorkOS dashboard: Blocked
- Create a new environment: Blocked

The drive used the free plan.

What it can't do, and why:

- Check sign-in attempts with standalone Radar: The API says Radar is not enabled and only support can enable it.
- Create SSO connections through the API: That part of the API is not enabled for the environment.
- Open a dashboard account: Sign-up asks for a mobile phone number.
- Delete the test environment or revoke its key: No documented route does either.
- Pay for a production plan: Billing is only in the dashboard; there is no billing API or agent payment rail.

**Surface audit:** 529 documented operations: 285 run, 225 blocked by sandbox or plan limits and 19 left out because they spend money or reach real people. Of the 285 run, 227 passed and 58 didn't; 52 behaved differently from the docs. By surface, 195 on the API, 76 in the CLI and 14 elsewhere, such as sign-in and webhooks.

## Tips for agent builders

- Read https://workos.com/auth.md and call POST /x/one-shot-environments to get an sk_test key; store the claim_token without logging it.
- Define an audit log schema before sending events with that action.
- Use POST /portal/generate_link with intent sso or dsync to configure SSO and SCIM; the SCIM endpoint and token let you provision directory users yourself.
- Poll after DELETE /organizations: it answers 202 and the read returns 404 a moment later.
- Use workos api <path> with an API key where the CLI's resource commands ask for a dashboard login.
- Invite only real inboxes: domains without MX records are refused.

## Paying

Ways to pay checked 2 Nov 2026.

- Result: Not tried. Paying needs an account.
- Ways to pay:
  - Stripe Projects (through Stripe's catalog)
- Trial: It has a free plan.

## Leaving

- Result: Partly. Nothing to cancel. Its key still works after leaving.
- Its account: No: our agent used WorkOS without an account, and it can't delete what it made. Everything the drive made inside it was deleted by API, except a few items with no delete route.

## Checked every day

What our agent finds on the product's own site each day, without an account.

- Sign-up page, stopped on the newest check; 15 of 15 days
- llms.txt, found on the newest check; 15 of 15 days
- MCP server, asks for a sign-in on the newest check; 15 of 15 days
- OpenAPI, found on the newest check; 15 of 15 days

## How WorkOS compares

In Auth and identity: 2 of the 9 products we drove in Auth and identity are higher; 5 others share L3. As of 15 Nov 2026.

- [FusionAuth](https://agentdrives.com/tools/fusionauth.md?via=md): L4, Gets in on its own
- [PropelAuth](https://agentdrives.com/tools/propelauth.md?via=md): L1, Can't sign up on its own
- [SuperTokens](https://agentdrives.com/tools/supertokens.md?via=md): L4, Gets in on its own
- [Clerk](https://agentdrives.com/tools/clerk.md?via=md): L3, Gets in on its own
- **WorkOS** (this page): L3, Gets in on its own
- [Auth0](https://agentdrives.com/tools/auth0.md?via=md): L3, Gets in on its own
- [Kinde](https://agentdrives.com/tools/kinde.md?via=md): L3, Gets in on its own
- [HumanMirror](https://agentdrives.com/tools/humanmirror.md?via=md): L3, Gets in on its own
- [Web3Auth (MetaMask Embedded Wallets)](https://agentdrives.com/tools/web3auth.md?via=md): L3, Gets in on its own

[All 9 in Auth and identity](https://agentdrives.com/categories/auth?via=md)

[How we rank](https://agentdrives.com/method?via=md#order)

On our standard (28 criteria). Best or ahead on 10 of 28 criteria, behind on 1.

- [Export before leaving](https://agentdrives.com/standard#leave-03): **Ahead of 6 of 7** others (auth and identity products), 1 the same.
- [All validation problems at once](https://agentdrives.com/standard#err-04): **Ahead of 47 of 57** others (every product), 10 the same.
- [Signed agents get past the bot check](https://agentdrives.com/standard#in-04): **Ahead of 107 of 142** others (every product), 35 the same.
- [One way to page through lists](https://agentdrives.com/standard#api-03): **Ahead of 3 of 4** others (auth and identity products), 1 the same.
- [Limits known before they hit](https://agentdrives.com/standard#lim-02): **Ahead of 3 of 4** others (auth and identity products), 1 the same.
- [Docs an agent can navigate](https://agentdrives.com/standard#docs-11): **Ahead of 5 of 7** others (auth and identity products), 2 the same.
- [A path written for agents](https://agentdrives.com/standard#docs-10): **Ahead of 4 of 7** others (auth and identity products), 3 the same.
- [A person can claim what the agent made](https://agentdrives.com/standard#in-09): **Ahead of 13 of 23** others (every product), 10 the same.
- [Answers sized for an agent](https://agentdrives.com/standard#api-04): **Tied for the best result** 2 of 4 others (auth and identity products) the same, 2 lower.
- [Errors a program can read](https://agentdrives.com/standard#err-02): **Tied for the best result** 3 of 6 others (auth and identity products) the same, 3 lower.
- [The best way in is built for agents](https://agentdrives.com/standard#in-12): **Level with 4 of 7** others (auth and identity products), 3 lower.
- [Sign-in for agents acting for a person](https://agentdrives.com/standard#in-08): **Level with 3 of 5** others (auth and identity products), 2 lower.
- [Prices an agent can read](https://agentdrives.com/standard#find-06): **Level with 5 of 7** others (auth and identity products), 2 lower.
- [Real status codes](https://agentdrives.com/standard#err-01): **Level with 6 of 7** others (auth and identity products), 1 lower.
- [A way in with no person](https://agentdrives.com/standard#in-01): **Level with 7 of 8** others (auth and identity products), 1 lower.
- [llms.txt that works](https://agentdrives.com/standard#find-02): **Level with 6 of 8** others (auth and identity products), 1 lower, 1 higher.
- [Fast to the first call](https://agentdrives.com/standard#in-03): **The same as all** 6 others (auth and identity products).
- [Terms allow an agent's account](https://agentdrives.com/standard#in-10): **The same as all** 8 others (auth and identity products).
- [Errors say what to do next](https://agentdrives.com/standard#err-03): **The same as all** 6 others (auth and identity products).
- [An agent payment rail on the core](https://agentdrives.com/standard#pay-02): **Level with 7 of 8** others (auth and identity products), 1 higher.
- [Pages fit one fetch](https://agentdrives.com/standard#docs-08): **Level with 6 of 7** others (auth and identity products), 1 higher.
- [Spend an agent can see and cap](https://agentdrives.com/standard#pay-05): **Level with 6 of 7** others (auth and identity products), 1 higher.
- [A plan an agent can buy by API](https://agentdrives.com/standard#pay-03): **Level with 5 of 6** others (auth and identity products), 1 higher.
- [Every way in works for an agent](https://agentdrives.com/standard#in-11): **Level with 5 of 7** others (auth and identity products), 2 higher.
- [A request id on every answer](https://agentdrives.com/standard#err-07): **In the middle** 1 of 7 others (auth and identity products) lower, 3 the same, 3 higher.
- [Agents may read docs, API and sign-up](https://agentdrives.com/standard#find-01): **Level with 3 of 5** others (auth and identity products), 2 higher.
- [Delete by API, checked](https://agentdrives.com/standard#leave-02): **Level with 4 of 7** others (auth and identity products), 3 higher.
- [Versions an agent can pin](https://agentdrives.com/standard#api-07): **Behind 3 of 5** others (auth and identity products), 2 the same.

[How each criterion is graded](https://agentdrives.com/standard)

## Our agent got through Leave only in part, and didn't try Pay

**9** things to fix for agents: 4 small, 4 medium and 1 large

One fix can cover several findings.

Agent blockers: **5 found, none stopped the drive** Agent surfaces: **52 issues found**

[Get your findings, free](https://agentdrives.com/your-findings?p=workos) · [What a drive covers](https://agentdrives.com/method?via=md)

We mail a private link to an address at workos.com.

1. Find Clear
2. Get in Clear
3. Use Clear
4. Pay Not tried
5. Leave Partly

Or [claim WorkOS](https://agentdrives.com/go/claim/workos?add=workos.com&ref=listing&safety=1) to see where each issue is, read your safety findings with their fixes and ask for a free drive after a fix.

Want WorkOS driven every month? [See Watch](https://agentdrives.com/owners#watch)

### On our standard

Best or ahead on 10 of 28 criteria, behind on 1. Each against the products we measured on it.

- [Export before leaving](https://agentdrives.com/standard#leave-03)
- [All validation problems at once](https://agentdrives.com/standard#err-04)
- [Signed agents get past the bot check](https://agentdrives.com/standard#in-04)
- [One way to page through lists](https://agentdrives.com/standard#api-03)
- [A request id on every answer](https://agentdrives.com/standard#err-07)
- [Agents may read docs, API and sign-up](https://agentdrives.com/standard#find-01)
- [Delete by API, checked](https://agentdrives.com/standard#leave-02)
- [Versions an agent can pin](https://agentdrives.com/standard#api-07)

**All 28 criteria**

- [Limits known before they hit](https://agentdrives.com/standard#lim-02)
- [Docs an agent can navigate](https://agentdrives.com/standard#docs-11)
- [A path written for agents](https://agentdrives.com/standard#docs-10)
- [A person can claim what the agent made](https://agentdrives.com/standard#in-09)
- [Answers sized for an agent](https://agentdrives.com/standard#api-04)
- [Errors a program can read](https://agentdrives.com/standard#err-02)
- [The best way in is built for agents](https://agentdrives.com/standard#in-12)
- [Sign-in for agents acting for a person](https://agentdrives.com/standard#in-08)
- [Prices an agent can read](https://agentdrives.com/standard#find-06)
- [Real status codes](https://agentdrives.com/standard#err-01)
- [A way in with no person](https://agentdrives.com/standard#in-01)
- [llms.txt that works](https://agentdrives.com/standard#find-02)
- [Fast to the first call](https://agentdrives.com/standard#in-03)
- [Terms allow an agent's account](https://agentdrives.com/standard#in-10)
- [Errors say what to do next](https://agentdrives.com/standard#err-03)
- [An agent payment rail on the core](https://agentdrives.com/standard#pay-02)
- [Pages fit one fetch](https://agentdrives.com/standard#docs-08)
- [Spend an agent can see and cap](https://agentdrives.com/standard#pay-05)
- [A plan an agent can buy by API](https://agentdrives.com/standard#pay-03)
- [Every way in works for an agent](https://agentdrives.com/standard#in-11)

[How each criterion is graded](https://agentdrives.com/standard)

## For the team behind WorkOS

**9 things to fix for agents: 4 small, 4 medium and 1 large.**

One fix can cover several findings. Agent blockers: 5 found, none stopped the drive · Agent surfaces: 52 issues found.

Our agent got through Leave only in part, and didn't try Pay. Its team gets the two findings that matter most in full, free, by a private link to an address at workos.com.

- Find: Clear
- Get in: Clear
- Use: Clear
- Pay: Not tried
- Leave: Partly

[Get your findings, free](https://agentdrives.com/your-findings?p=workos) · [Claim WorkOS](https://agentdrives.com/app/products?add=workos.com&ref=listing&safety=1) · [What a drive covers](https://agentdrives.com/method?via=md)

## Related research

Guides and findings on the Use step.

- [Let AI agents start without a credit card](https://agentdrives.com/guides/card-free-starts?via=md) (guide): A free plan or a trial without a card, an API key that works on it, and limits instead of a card.
- [Which agent surfaces products offer, and how many worked in our drives](https://agentdrives.com/findings/agent-surfaces?via=md) (finding): An API is the most offered agent surface: 149 of the 151 products we mapped offer one.
- [Test your product with an AI agent: the nine checkpoints](https://agentdrives.com/guides/test-your-product-with-an-ai-agent?via=md) (guide): The nine checkpoints of a drive, with the commands to try each one from a terminal.

[Everything on Use](https://agentdrives.com/access/use)

## Articles that cite WorkOS

- [How to let AI agents sign up for your product](https://agentdrives.com/guides/let-ai-agents-sign-up?via=md)

## Questions people ask about WorkOS

**Can an AI agent create a WorkOS account on its own?**

Yes, over the API, without a browser. The dashboard sign-up separately stops at a Radar phone check.

**Does WorkOS have an MCP server, and can an agent connect to it?**

Yes. WorkOS has an official MCP server. The server is hosted and signs an agent in with OAuth. A new agent can get in on its own: in the drive of 2 Nov 2026, our agent signed up and got its key without a person.

**How does an AI agent get a WorkOS API key?**

In the drive of 2 Nov 2026, our agent got its WorkOS API key over the API, without a browser or a person. No documented route makes a scoped key for the WorkOS API or revokes the environment key; organization API keys were created, validated and revoked without a browser.

**Can an AI agent delete its WorkOS account?**

No: our agent used WorkOS without an account, and it can't delete what it made. Everything the drive made inside it was deleted by API, except a few items with no delete route.

**Can an AI agent pay for WorkOS?**

No payment made: paying needs an account. It has a free plan. WorkOS offers agents a way to pay: Stripe Projects.

## Where WorkOS fits

- Category: [Developer platform](https://agentdrives.com/categories/developer?via=md), [Auth and identity](https://agentdrives.com/categories/auth?via=md)
- Tasks: [Register a webhook](https://agentdrives.com/tasks/register-a-webhook), [Invite a member](https://agentdrives.com/tasks/invite-a-member), [Set a member's role or permissions](https://agentdrives.com/tasks/set-a-member-s-role-or-permissions), [Import data from a file or another tool](https://agentdrives.com/tasks/import-data-from-a-file-or-another-tool), [Read the audit log](https://agentdrives.com/tasks/read-the-audit-log), [Create a workspace](https://agentdrives.com/tasks/create-a-workspace)
- Wall: [Sign-up or key only in a browser](https://agentdrives.com/access/get-in/sign-up) (our agent got in another way), [Phone number at sign-up](https://agentdrives.com/access/get-in/sign-up) (our agent got in another way), [Let AI agents sign up without a phone number](https://agentdrives.com/guides/sign-up-without-a-phone-number?via=md) (fix guide)
- Vendors: [Cloudflare](https://agentdrives.com/research/bot-checks?via=md#cloudflare) (let our agent through)
- Standards: [MCP](https://agentdrives.com/standards/mcp) (tools an agent can call), [OpenAPI](https://agentdrives.com/standards/openapi) (its API, described), [llms.txt](https://agentdrives.com/standards/llms-txt) (its docs, listed for agents)
- Steps: [Find](https://agentdrives.com/access/find), [Get in](https://agentdrives.com/access/get-in), [Use](https://agentdrives.com/access/use), [Pay](https://agentdrives.com/access/pay), [Leave](https://agentdrives.com/access/leave)
- Topics: [MCP servers](https://agentdrives.com/access/find/mcp-servers) (Find step), [Docs and llms.txt](https://agentdrives.com/access/find/docs) (Find step), [MCP sign-in](https://agentdrives.com/access/get-in/mcp-sign-in) (Get in step), [Bot checks](https://agentdrives.com/access/get-in/bot-checks) (Get in step)
- Rivals: [Clerk](https://agentdrives.com/tools/clerk?via=md) (L3), [Auth0](https://agentdrives.com/tools/auth0?via=md) (L3), [HumanMirror](https://agentdrives.com/tools/humanmirror?via=md) (L3)
- Compare: [WorkOS vs Clerk](https://agentdrives.com/compare/clerk-vs-workos?via=md)

## Level by drive

One drive so far, on 2 Nov 2026.

[Every drive in full](https://agentdrives.com/tools/workos/history?via=md)

Source: our drives of WorkOS. As of 2 Nov 2026.

1. 11 Nov 2026 [**Level L4 → L3**](https://agentdrives.com/tools/workos?via=md#drive-20261102T194815Z) [Re-scored under method v47, drive of 2 Nov 2026](https://agentdrives.com/changes#rules-2026-11-11-47)

## Cited in 1 article

- [How to let AI agents sign up for your product](https://agentdrives.com/guides/let-ai-agents-sign-up?via=md)

The level follows [these rules](https://agentdrives.com/changes#rules-2026-11-18).

Data: [JSON](https://agentdrives.com/api/tools/workos.json?via=md) · [Markdown](https://agentdrives.com/tools/workos.md?via=md) · [History](https://agentdrives.com/tools/workos/history?via=md) · [Atom](https://agentdrives.com/feeds/tools/workos.atom) · [JSON Feed](https://agentdrives.com/feeds/tools/workos.json) · licence [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) · evidence sha256 `89cc30e0cbfac8ecf6d743f18bc9bbec497d6e4f4bc7131ea0958690de9c9a03`

**Found an error?** [Tell us on this page](https://agentdrives.com/tools/workos?via=md#correct) or read [how corrections work](https://agentdrives.com/corrections?via=md).
