WorkOS Official Remote MCP Server

๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~355 tok6 toolsยทOnline137msยท30d uptime: 100%ยทLast checked 2m ago

WorkOS's hosted MCP (mcp.workos.com/mcp) exposes enterprise-auth primitives โ€” organizations, users, connections and directories โ€” to agents over OAuth 2.1.

https://mcp.workos.com/mcp
Provider
WorkOS โ†—
Categories
๐Ÿ› ๏ธ Developer Tools & Git
ไธญๆ–‡็ฎ€ไป‹

WorkOS ๅฎ˜ๆ–น่ฟœ็จ‹ MCP ๆœๅŠกๅ™จใ€‚AI ไปฃ็†ๅฏ้€š่ฟ‡ OAuth ็ฎก็†็ป„็ป‡ใ€็”จๆˆทใ€SSO ่ฟžๆŽฅไธŽ็›ฎๅฝ•ๆ•ฐๆฎใ€‚

Maintainer of WorkOS? Claim or update this listing โ†’

Streamable HTTPhttps://mcp.workos.com/mcp
Install in Cursor โ†’

Or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "workos": {
      "url": "https://mcp.workos.com/mcp"
    }
  }
}

๐Ÿงฐ WorkOS MCP Tools & Schema (6)

ToolSafetyDescriptionParameters
list_organizations
~53 tok
๐ŸŸข ReadList organizations in your WorkOS environment.domain: string
get_organization
~55 tok
๐ŸŸข ReadGet an organization's details.organizationId*: string
list_users
~64 tok
๐ŸŸข ReadList users with email and state filters.email: stringorganizationId: string
create_user
~76 tok
๐ŸŸ  WriteCreate a user in your environment.email*: stringfirstName: stringlastName: string
list_connections
~52 tok
๐ŸŸข ReadList SSO connections with their states.organizationId: string
list_directories
~35 tok
๐ŸŸข ReadList directory-sync directories.โ€”

๐Ÿ›ก๏ธ Security, Quality & Context Token Audit

๐Ÿ›ก๏ธ Grade A+Context tax: ~355 tokens injected into every system prompt by this serverโ€™s 6 tools

Every tool definition (name + description + input schema) is injected into your LLMโ€™s context on every request โ€” Estimate per-call LLM token cost โ†’

  • No prompt-injection or hidden-character anomalies detected in tool descriptions
  • Streamable HTTP primary endpoint (current 2025-03-26 transport)
  • OAuth 2.1 with PKCE S256 enforced
  • Official first-party endpoint operated by the vendor
  • Manually verified by RemoteMCP.net

๐Ÿ” OAuth 2.1 & Security

Auth type
OAuth 2.1
Dynamic Client Registration
โœ… Supported
PKCE S256
โœ… Supported
Protected resource metadata
https://mcp.workos.com/.well-known/oauth-protected-resource (expected location)
๐Ÿ” Audit OAuth 2.1 Config โ†’

๐Ÿงฉ Recommended Agent Skills

๐Ÿ“– WorkOS MCP Endpoint Overview & Security Guide

WorkOS MCP โ€” Remote MCP Server

WorkOS's remote MCP puts B2B auth administration into agent reach โ€” enumerate organizations and users, check SSO connection health, review directory sync state โ€” useful for support workflows and integration setup.

Official WorkOS MCP Endpoint & Transport Architecture

  • Endpoint URL: https://mcp.workos.com/mcp
  • Transport: Streamable HTTP

Streamable HTTP is the current MCP transport (2025-03-26 spec): a single URL accepts JSON-RPC POSTs and may stream responses over SSE, so one endpoint serves both simple and streaming workloads. WorkOS MCP does not publish a separate legacy SSE endpoint, so your client must speak Streamable HTTP.

Authentication, Scopes & Permission Boundaries

WorkOS MCP uses OAuth 2.1 โ€” the first request returns a 401 Unauthorized challenge with a WWW-Authenticate header pointing at the authorization metadata. Compliant clients (Cursor, Claude, VS Code, ChatGPT) handle the whole flow โ€” PKCE and Dynamic Client Registration, so no manual client setup is needed โ€” and simply open a browser consent screen.

Of the 6 cataloged tools, 5 are read-only and 1 can write or mutate state (create resources, run SQL, post messages). Grant access only to the accounts and projects you intend agents to act on, and prefer scoped credentials or a dedicated workspace where the provider supports them.

Common Troubleshooting & Connection Tips

  • 401 Unauthorized on connect โ€” that's expected; the server is OAuth-protected. Let your client complete the browser consent flow, or inspect the endpoint in our OAuth debugger to see the exact WWW-Authenticate challenge.
  • "Session expired" / stale Mcp-Session-Id โ€” just re-send initialize; stateless clients can ignore session headers entirely.
  • Directory data may contain PII โ€” the OAuth user should have least-privilege roles.
  • Portal link generation requires admin-level WorkOS permissions.

๐Ÿš€ How to Connect

  1. Copy the WorkOS MCP endpoint URL
    The remote endpoint is https://mcp.workos.com/mcp.
  2. Add it to your MCP client
    Claude Code: claude mcp add --transport http workos https://mcp.workos.com/mcp. Cursor: add "workos": { "url": "https://mcp.workos.com/mcp" } under mcpServers in ~/.cursor/mcp.json. Other clients work similarly.
  3. Complete the OAuth consent
    On first connection your client opens a WorkOS consent screen in the browser. Approve it to grant access; the token is stored by the client and refreshed automatically.
  4. Verify with the online inspector
    Paste https://mcp.workos.com/mcp into remotemcp.net/inspector, run initialize and tools/list, and confirm WorkOS MCP's 6 tools respond.

โ“ FAQ

What is the WorkOS MCP remote MCP endpoint?

The primary endpoint is https://mcp.workos.com/mcp. It is an official first-party server operated by WorkOS, speaking the Streamable HTTP transport.

How do I authenticate with WorkOS MCP?

WorkOS MCP uses OAuth 2.1. When your client first connects it receives a 401 challenge, discovers the authorization server via RFC 9728 metadata, and opens a browser consent screen. Dynamic Client Registration is supported, so compliant clients register themselves automatically.

I'm getting a 401 Unauthorized from WorkOS MCP โ€” what's wrong?

A 401 means your client hasn't completed (or has lost) the OAuth authorization. Remove and re-add the server in your client to restart the consent flow, and check that your browser session can reach the provider's login page. If the 401 arrives without a WWW-Authenticate header, run it through our OAuth debugger to see what's missing.

Which MCP clients work with WorkOS MCP?

Any client that supports remote MCP servers: Cursor, Claude Code (`claude mcp add --transport http workos https://mcp.workos.com/mcp`), VS Code Copilot, ChatGPT connectors, Windsurf, Kiro (`~/.kiro/settings/mcp.json`), and Claude Desktop via the `mcp-remote` bridge.

What tools does WorkOS MCP expose?

6 tools are cataloged in this directory โ€” including `list_organizations`, `get_organization`, `list_users` and more. Use our online inspector to fetch the live tool list straight from the endpoint.

๐Ÿ”— Connect Guides

โš”๏ธ Featured in Comparisons

๐Ÿ“› Embed Status Badge in README

WorkOS MCP status badge
[![Remote MCP Status](https://remotemcp.net/api/badge/status/workos.svg)](https://remotemcp.net/servers/workos)
WorkOS MCP inspector badge
[![Test in Inspector](https://remotemcp.net/api/badge/inspect/workos.svg)](https://remotemcp.net/inspector?url=https%3A%2F%2Fmcp.workos.com%2Fmcp)
WorkOS MCP audit grade badge
[![MCP Audit Grade](https://remotemcp.net/api/badge/grade/workos.svg)](https://remotemcp.net/servers/workos)
WorkOS MCP context tax badge
[![Context Tax](https://remotemcp.net/api/badge/tokens/workos.svg)](https://remotemcp.net/servers/workos)

Related Servers

GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.

https://api.githubcopilot.com/mcp/
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~3096 tok92 toolsOnline310ms
Linear MCPLinear Orbit Inc.

Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.

https://mcp.linear.app/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~899 tok30 toolsOnline8ms
Claude SkillsClaudeSkills.club

Claude Skills's hosted remote MCP server. ClaudeSkills.club's public MCP lets agents search and pull from a catalog of 90,000+ Agent Skills (SKILL.md) โ€” workflow specs, safety scores and one-line install instructions. It is public and unauthenticated โ€” connect and call tools immediately.

https://claudeskills.club/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~344 tok3 toolsOnline125ms
GitLabGitLab

GitLab's hosted remote MCP server. GitLab's official MCP server gives agents first-party access to repositories, merge requests, issues, pipelines and code search across gitlab.com and self-managed instances. It is protected by OAuth 2.1; compliant clients complete a browser consent flow with PKCE.

https://gitlab.com/api/v4/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~659 tok22 toolsOnline176ms