What is Workos Mcp

workos-mcp is a lightweight Model Control Protocol (MCP) server that enables Cursor Agents to interact with the WorkOS API. It is built using create-mcp and deployed on Cloudflare Workers.

Use cases

Use cases for workos-mcp include creating custom tools for data processing, automating workflows, and enabling agents to perform specific tasks through the WorkOS API.

How to use

To use workos-mcp, clone the repository using the provided install script, configure your Cursor settings to add the MCP server, and upload your WorkOS API key and client ID as secrets. Deploy changes using the deploy script and reload your Cursor window.

Key features

Key features of workos-mcp include easy installation via an automated script, the ability to create custom MCP tools by adding methods to the MyWorker class, and seamless integration with the WorkOS API.

Where to use

workos-mcp can be used in various fields that require integration with the WorkOS API, such as application development, automation tasks, and enhancing agent capabilities.

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:

bun create mcp --clone https://github.com/zueai/workos-mcp

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:

bunx wrangler secret put WORKOS_API_KEY
bunx wrangler secret put WORKOS_CLIENT_ID

Deploying Changes

1. Run the deploy script:

bun run deploy

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:

/**
 * A warm, friendly greeting from your MCP server.
 * @param name {string} the name of the person we are greeting.
 * @return {string} the contents of our greeting.
 */
sayHello(name: string) {
    return `Hello from an MCP Worker, ${name}!`;
}

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