{"id":28151785,"url":"https://github.com/zueai/workos-mcp","last_synced_at":"2025-05-15T04:14:58.503Z","repository":{"id":288776899,"uuid":"939064465","full_name":"zueai/workos-mcp","owner":"zueai","description":"Lightweight MCP server to give your Cursor Agent access to the WorkOS API.","archived":false,"fork":false,"pushed_at":"2025-02-26T00:38:54.000Z","size":58,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-19T18:19:03.763Z","etag":null,"topics":["cursor","mcp","workos"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zueai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-25T23:49:35.000Z","updated_at":"2025-03-04T16:35:22.000Z","dependencies_parsed_at":"2025-04-19T18:19:06.743Z","dependency_job_id":"a9c0a24b-d339-41ad-bb3a-8b413f63ef50","html_url":"https://github.com/zueai/workos-mcp","commit_stats":null,"previous_names":["zueai/workos-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zueai%2Fworkos-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zueai%2Fworkos-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zueai%2Fworkos-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zueai%2Fworkos-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zueai","download_url":"https://codeload.github.com/zueai/workos-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254270658,"owners_count":22042863,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cursor","mcp","workos"],"created_at":"2025-05-15T04:13:24.259Z","updated_at":"2025-05-15T04:14:58.487Z","avatar_url":"https://github.com/zueai.png","language":"TypeScript","funding_links":[],"categories":["Cloud Services","Customer Data Platforms","🌐 Web Development"],"sub_categories":["How to Submit"],"readme":"# workos-mcp\n\nThis is a lightweight Model Control Protocol (MCP) server bootstrapped with [create-mcp](https://github.com/zueai/create-mcp), and deployed on Cloudflare Workers.\n\nThis MCP Server allows agents (like Cursor Agents) to interact with the [WorkOS API](https://workos.com/docs/reference).\n\n## Available Tools\n\nSee [src/index.ts](src/index.ts) for the current list of tools. Every method in the class is an MCP tool.\n\n## Installation\n\n1. Run the automated install script to clone this MCP server and deploy it to your Cloudflare account:\n\n```bash\nbun create mcp --clone https://github.com/zueai/workos-mcp\n```\n\n2. Open `Cursor Settings -\u003e MCP -\u003e Add new MCP server` and paste the command that was copied to your clipboard.\n\n3. Upload your WorkOS API key and client ID as secrets:\n\n```bash\nbunx wrangler secret put WORKOS_API_KEY\nbunx wrangler secret put WORKOS_CLIENT_ID\n```\n\n## Deploying Changes\n\n1. Run the deploy script:\n\n```bash\nbun run deploy\n```\n\n2. Then reload your Cursor window to use the updated tools.\n\n## How to create new MCP tools\n\nTo 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.\n\nExample:\n\n```typescript\n/**\n * A warm, friendly greeting from your MCP server.\n * @param name {string} the name of the person we are greeting.\n * @return {string} the contents of our greeting.\n */\nsayHello(name: string) {\n    return `Hello from an MCP Worker, ${name}!`;\n}\n```\n\nThe JSDoc comments are important:\n\n- First line becomes the tool's description\n- `@param` tags define the tool's parameters with types and descriptions\n- `@return` tag specifies the return value and type\n\n## Learn More\n\nCheck out the following resources to learn more:\n\n- [create-mcp Documentation](https://github.com/zueai/create-mcp) - learn about the create-mcp CLI\n- [Model Control Protocol Documentation](https://modelcontextprotocol.io) - learn about the model control protocol\n- [workers-mcp](https://github.com/cloudflare/workers-mcp) - the package that implements the MCP protocol for Cloudflare Workers\n- [Cloudflare Workers documentation](https://developers.cloudflare.com/workers/) - learn about the Cloudflare Workers platform\n- [WorkOS Documentation](https://workos.com/docs) - learn about the WorkOS API\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzueai%2Fworkos-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzueai%2Fworkos-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzueai%2Fworkos-mcp/lists"}