workos-mcp

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