Introducing the WorkOS MCP Documentation Server
Get the latest WorkOS context, docs, examples and changelogs where you're already working with the WorkOS MCP docs server.
WorkOS has consolidated its SDK documentation, code examples, and changelogs behind a single (MCP) server.
You can install it immediately in Cursor using the following button:
This gives developer tools, MCP clients and AI assistants a single, predictable interface to query for WorkOS reference material.

Four Simple Tools
@workos/mcp-docs-server exposes four MCP tools:
- workos_search – full-text search across every doc, example, and changelog
- workos_docs – fetch a Markdown document by path
- workos_examples – pull ready-to-run code samples
- workos_changelogs – retrieve version history and release notes
Quick Install
npm install @workos/mcp-docs-server
Setup with Your Preferred MCP Client
Cursor / Windsurf
{
"mcpServers": {
"workos": {
"command": "npx",
"args": ["-y", "@workos/mcp-docs-server"]
}
}
}
Claude Code
claude mcp add-json workos --scope user '
{ "command": "npx", "args": ["@workos/mcp-docs-server"] }
'
Programmatic Usage
import { getTools } from '@workos/mcp-docs-server/get-tools';
const tools = await getTools();
// Use tools.workos_search, tools.workos_docs, etc.
How to Use It
Install the WorkOS MCP Documentation server in any MCP client you use so that you always have the latest documentation right where you’re working.
Typically, LLMs using the WorkOS MCP Documentation server will follow a progressive discovery workflow when. your query is related to WorkOS:
- Search first – Use
workos_search
with your error message, method name, or concept - Targeted fetch – Get the full document, example, or changelog using the path from your search results
- Iterate – Repeat until you have the context you need
No more guessing directory structures or hunting through documentation sidebars.
Example Usage
// Find docs about SAML errors
workos_search({ query: "invalid SAML response" })
// Get SSO implementation examples
workos_examples({ example: "sso" })
// Check what's new in the platform
workos_changelogs({ package: "workos-platform" })
// Read specific documentation
workos_docs({ path: "sso/overview" })
Get Started
Install the package, add it to your MCP configuration, and start querying.
Your AI assistant will be able to help you with WorkOS integration questions using the most up-to-date documentation and examples.
That's the whole story – simple, predictable access to WorkOS documentation through the MCP protocol.