Cursor plugin specification and official plugins
TypeScript
feat: add the Rippling MCP plugin
Cursor Agent65dde2c4a5cc
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex 9b31a43f..209d2fa6 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -652,6 +652,11 @@"name": "servicenow","source": "third_party/servicenow","description": "Call the tools your admin publishes on a ServiceNow instance."+ },+ {+ "name": "rippling",+ "source": "third_party/rippling",+ "description": "Look up people, time off, and company policy in Rippling, and file time-off requests and draft hires."}]}diff --git a/README.md b/README.mdindex 9d46b46a..bd459e6f 100644--- a/README.md+++ b/README.md@@ -120,6 +120,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `ringcentral-phone` | [RingCentral Phone](third_party/ringcentral-phone/) | Cursor | Integrations | Read call activity, AI call notes, SMS, voicemail, and fax, and send SMS. || `ringcentral-chat` | [RingCentral Chat](third_party/ringcentral-chat/) | Cursor | Integrations | Read team chats and posts, send messages, and manage teams, tasks, and notes. || `servicenow` | [ServiceNow](third_party/servicenow/) | Cursor | Integrations | Call the tools your admin publishes on a ServiceNow instance. |+| `rippling` | [Rippling](third_party/rippling/) | Cursor | Integrations | Look up people, time off, and company policy in Rippling, and file time-off requests and draft hires. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/rippling/.cursor-plugin/plugin.json b/third_party/rippling/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..73170cb1--- /dev/null+++ b/third_party/rippling/.cursor-plugin/plugin.json@@ -0,0 +1,49 @@+{+ "name": "rippling",+ "displayName": "Rippling",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.19.0"+ },+ "description": "Look up people, time off, and company policy in Rippling, and file time-off requests and draft hires.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/setup",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "rippling",+ "hr",+ "hris",+ "people",+ "employees",+ "time off",+ "payroll",+ "policy",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "rippling",+ "hr",+ "mcp"+ ],+ "variables": {+ "type": "object",+ "additionalProperties": false,+ "required": [+ "RIPPLING_MCP_URL"+ ],+ "properties": {+ "RIPPLING_MCP_URL": {+ "type": "string",+ "title": "Remote MCP server URL",+ "description": "Remote MCP server URL copied from Rippling → My IT → MCP connectors. This is the Rippling MCP URL from the setup page, not a company-wide API token and not an MCP Gateway URL for a different product."+ }+ }+ },+ "mcpServers": "./mcp.json"+}diff --git a/third_party/rippling/CHANGELOG.md b/third_party/rippling/CHANGELOG.mdnew file mode 100644index 00000000..886be063--- /dev/null+++ b/third_party/rippling/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `rippling` MCP server. The Remote MCP server URL is copied from Rippling → My IT → MCP connectors.+- Auth is the signed-in employee's Rippling account. There is no API token or client ID to configure.+- Logo: Rippling's mark from the Rippling GitHub organization.diff --git a/third_party/rippling/LICENSE b/third_party/rippling/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/rippling/LICENSE@@ -0,0 +1,21 @@+MIT License++Copyright (c) 2026 Cursor++Permission is hereby granted, free of charge, to any person obtaining a copy+of this software and associated documentation files (the "Software"), to deal+in the Software without restriction, including without limitation the rights+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell+copies of the Software, and to permit persons to whom the Software is+furnished to do so, subject to the following conditions:++The above copyright notice and this permission notice shall be included in all+copies or substantial portions of the Software.++THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE+SOFTWARE.diff --git a/third_party/rippling/README.md b/third_party/rippling/README.mdnew file mode 100644index 00000000..5d9b7494--- /dev/null+++ b/third_party/rippling/README.md@@ -0,0 +1,69 @@+# Rippling++Cursor plugin that connects agents to [Rippling](https://www.rippling.com) through Rippling's first-party [Model Context Protocol](https://modelcontextprotocol.io/) server.++Look up people and org structure, check time off, ask about company policy, file a time-off request, or start a draft hire. Calls run as the signed-in employee, inside the access policy an admin assigned.++## Install++1. Open **Cursor Settings → Plugins**.+2. Search for **Rippling**.+3. Click **Install**, paste the Remote MCP server URL (below), then complete the Rippling sign-in prompt.++Or run `/add-plugin rippling` in chat.++## MCP++Rippling does not publish one shared server URL. Each employee copies the **Remote MCP server URL** from **My IT → MCP connectors** and the plugin sends traffic there:++```json+{+ "mcpServers": {+ "rippling": {+ "type": "http",+ "url": "${RIPPLING_MCP_URL}"+ }+ }+}+```++Auth is OAuth as that employee. Cursor opens Rippling's sign-in when the plugin connects. There is no API token, client ID, or client secret to configure. Do not paste a company-wide API token into this plugin.++## Before you connect++- A Rippling admin creates an access policy. Employees have no access until that policy exists.+- The company is in an active Rippling AI trial or has an active Rippling AI subscription. Tool calls return no data otherwise.+- You can open **My IT → MCP connectors** and copy the Remote MCP server URL.++Rippling documents two MCP products. This plugin is the [Rippling MCP](https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/setup) for workforce data. It is separate from the MCP Gateway used to connect other products. Use the URL from the Rippling MCP setup, and do not mix the two.++## What agents can do++The server exposes one code tool. Its description lists the typed `codemode.*` functions the signed-in user is allowed to call. The model writes a JavaScript program against those functions, and that program runs in a fresh isolate with no network egress. Credentials stay outside the isolate. The tool list itself does not enumerate every function; the description for the connected user is the source of truth.++| Area | What the connected user can do |+| --- | --- |+| People and org | Look up yourself, another person, direct reports, and department size, and search people |+| Time off | Look up an absence, a balance, and leave types, and file a time-off request |+| Hiring | Create a draft hire |+| Policy and products | Ask Rippling AI a plain-language question across Rippling products and company policy. The answer is read-only prose |+| Custom objects | Create, read, update, and delete custom-object records the user is allowed to touch |++## Notes++- A request also has to pass the company's MCP Gateway policies and the user's ordinary Rippling permissions. The gateway checks identity and whether that tool is allowed.+- Filing time off creates an official request in the organization's manager approval queue. Hiring and other high-impact admin actions create a draft for a person to review, and do not run immediately.+- The server does not expose Social Security numbers, home addresses, personal email addresses, or tax IDs.+- Review every write before you approve it. Access follows the signed-in employee, so a connection cannot see people or records that employee cannot see in Rippling.++## Docs++- Set up the Rippling MCP: https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/setup+- Overview: https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/overview+- Tools: https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/tools++Logo is Rippling's mark from the [Rippling](https://github.com/Rippling) GitHub organization.++## License++MITdiff --git a/third_party/rippling/assets/logo.png b/third_party/rippling/assets/logo.pngnew file mode 100644index 00000000..e27abf4bBinary files /dev/null and b/third_party/rippling/assets/logo.png differdiff --git a/third_party/rippling/mcp.json b/third_party/rippling/mcp.jsonnew file mode 100644index 00000000..80de5ad3--- /dev/null+++ b/third_party/rippling/mcp.json@@ -0,0 +1,8 @@+{+ "mcpServers": {+ "rippling": {+ "type": "http",+ "url": "${RIPPLING_MCP_URL}"+ }+ }+}