In this article
June 12, 2025
June 12, 2025

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: 

Add workos MCP server to Cursor

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:

  1. Search first – Use workos_search with your error message, method name, or concept
  2. Targeted fetch – Get the full document, example, or changelog using the path from your search results
  3. 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.

This site uses cookies to improve your experience. Please accept the use of cookies on this site. You can review our cookie policy here and our privacy policy here. If you choose to refuse, functionality of this site will be limited.