WorkOS MCP Server

workos-mcp

This is a lightweight Model Control Protocol (MCP) server bootstrapped with create-mcp, and deployed on Cloudflare Workers.

This MCP Server allows agents (like Cursor Agents) to interact with the WorkOS API.

Available Tools

See src/index.ts for the current list of tools. Every method in the class is an MCP tool.

Installation

1. Run the automated install script to clone this MCP server and deploy it to your Cloudflare account:

2. Open Cursor Settings -> MCP -> Add new MCP server and paste the command that was copied to your clipboard.
3. Upload your WorkOS API key and client ID as secrets:

Deploying Changes

1. Run the deploy script:

2. Then reload your Cursor window to use the updated tools.

How to create new MCP tools

To create new MCP tools, add methods to the MyWorker class in src/index.ts. Each function will automatically become an MCP tool that your agent can use.

Example:

The JSDoc comments are important:

• First line becomes the tool's description
• @param tags define the tool's parameters with types and descriptions
• @return tag specifies the return value and type

Learn More

Check out the following resources to learn more:

• create-mcp Documentation - learn about the create-mcp CLI
• Model Control Protocol Documentation - learn about the model control protocol
• workers-mcp - the package that implements the MCP protocol for Cloudflare Workers
• Cloudflare Workers documentation - learn about the Cloudflare Workers platform
• WorkOS Documentation - learn about the WorkOS API