Cursor plugin specification and official plugins
TypeScript
Add a ServiceNow MCP Server Console plugin.
Cursor Agent82d1713f1c71
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex ac8c63fd..9b31a43f 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -647,6 +647,11 @@"name": "ringcentral-chat","source": "third_party/ringcentral-chat","description": "Read team chats and posts, send messages, and manage teams, tasks, and notes."+ },+ {+ "name": "servicenow",+ "source": "third_party/servicenow",+ "description": "Call the tools your admin publishes on a ServiceNow instance."}]}diff --git a/README.md b/README.mdindex a3f90f75..9d46b46a 100644--- a/README.md+++ b/README.md@@ -119,6 +119,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `vanta` | [Vanta](third_party/vanta/) | Cursor | Integrations | Query and remediate compliance tests, controls, frameworks, risks, and vulnerabilities in Vanta. || `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. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/servicenow/.cursor-plugin/plugin.json b/third_party/servicenow/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..66e49fd2--- /dev/null+++ b/third_party/servicenow/.cursor-plugin/plugin.json@@ -0,0 +1,68 @@+{+ "name": "servicenow",+ "displayName": "ServiceNow",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.19.0"+ },+ "description": "Call the tools your admin publishes on a ServiceNow instance.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://www.servicenow.com/docs/r/australia/intelligent-experiences/exploring-mcp-server-console.html",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.svg",+ "keywords": [+ "servicenow",+ "itsm",+ "incidents",+ "cases",+ "mcp",+ "mcp server console",+ "now assist"+ ],+ "category": "integrations",+ "tags": [+ "servicenow",+ "itsm",+ "mcp"+ ],+ "variables": {+ "type": "object",+ "additionalProperties": false,+ "required": [+ "SERVICENOW_HOST",+ "SERVICENOW_MCP_SERVER",+ "CLIENT_ID",+ "CLIENT_SECRET"+ ],+ "properties": {+ "SERVICENOW_HOST": {+ "type": "string",+ "title": "Instance hostname",+ "description": "Bare hostname of the ServiceNow instance, for example acme.service-now.com. Leave out https:// and any path."+ },+ "SERVICENOW_MCP_SERVER": {+ "type": "string",+ "title": "MCP server name",+ "description": "Name from the server record in MCP Server Console. This is the last segment of the Server URL. The preconfigured Quickstart Server is sn_mcp_server_default.",+ "default": "sn_mcp_server_default"+ },+ "CLIENT_ID": {+ "type": "string",+ "title": "OAuth client ID",+ "description": "Client ID from the OAuth inbound integration created for this client in Machine Identity Console."+ },+ "CLIENT_SECRET": {+ "type": "string",+ "title": "OAuth client secret",+ "description": "Client secret from the same OAuth inbound integration. Stored encrypted and never shown back.",+ "writeOnly": true,+ "format": "password"+ }+ }+ },+ "mcpServers": "./mcp.json"+}diff --git a/third_party/servicenow/CHANGELOG.md b/third_party/servicenow/CHANGELOG.mdnew file mode 100644index 00000000..3fb5ac9b--- /dev/null+++ b/third_party/servicenow/CHANGELOG.md@@ -0,0 +1,10 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `servicenow` MCP server pointing at `https://${SERVICENOW_HOST}/sncapps/mcp-server/mcp/${SERVICENOW_MCP_SERVER}`, the Server URL from MCP Server Console.+- Declared `SERVICENOW_HOST`, `SERVICENOW_MCP_SERVER`, `CLIENT_ID`, and `CLIENT_SECRET` so each instance can point at its own server and OAuth inbound integration.+- Requests the `mcp_server` scope.+- Logo: 192×192 mark in ServiceNow green (`#81B5A1`).diff --git a/third_party/servicenow/LICENSE b/third_party/servicenow/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/servicenow/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/servicenow/README.md b/third_party/servicenow/README.mdnew file mode 100644index 00000000..8f841a27--- /dev/null+++ b/third_party/servicenow/README.md@@ -0,0 +1,113 @@+# ServiceNow++Cursor plugin that connects agents to a [ServiceNow](https://www.servicenow.com) instance through the instance's own [Model Context Protocol](https://modelcontextprotocol.io/) server, created in [MCP Server Console](https://www.servicenow.com/docs/r/australia/intelligent-experiences/exploring-mcp-server-console.html).++Agents call the tools an AI administrator publishes on that server. The preconfigured Quickstart Server can look up and summarize incidents and cases when those applications are installed. A custom server exposes whatever tools that admin adds.++## Install++1. An AI administrator activates a server in MCP Server Console and creates an OAuth inbound integration (see [Instance setup](#instance-setup)).+2. A Cursor team admin opens **Cursor Settings → Plugins**, searches for **ServiceNow**, installs it, and enters the instance hostname, server name, client ID, and client secret.+3. Each member signs in to ServiceNow when Cursor prompts them.++Or run `/add-plugin servicenow` in chat.++## MCP++The plugin points at the Server URL shown on the server record:++```json+{+ "mcpServers": {+ "servicenow": {+ "type": "http",+ "url": "https://${SERVICENOW_HOST}/sncapps/mcp-server/mcp/${SERVICENOW_MCP_SERVER}",+ "auth": {+ "CLIENT_ID": "${CLIENT_ID}",+ "CLIENT_SECRET": "${CLIENT_SECRET}",+ "scopes": ["mcp_server"]+ }+ }+ }+}+```++ServiceNow documents that URL as `https://<instance>.service-now.com/sncapps/mcp-server/mcp/<server-name>`. The Quickstart Server's name is `sn_mcp_server_default`.++Auth is OAuth 2.0 authorization code with a client secret. Cursor requests the `mcp_server` scope. ServiceNow's authorization endpoint is `https://<instance>/oauth_auth.do` and its token endpoint is `https://<instance>/oauth_token.do`.++## Instance setup++MCP Server Console only supports remote, stateless servers over Streamable HTTP. An administrator does this once per instance.++### 1. Activate a server and copy its name++In the instance, go to **All → MCP Server Console**, open **Configuration → Servers**, and either activate the Quickstart Server or create a server and add tools. The server has to be **Active**.++The record's **Server URL** looks like:++`https://acme.service-now.com/sncapps/mcp-server/mcp/sn_mcp_server_default`++| Plugin field | Value |+| --- | --- |+| `SERVICENOW_HOST` | Bare hostname, for example `acme.service-now.com`. Leave out `https://` and the path. |+| `SERVICENOW_MCP_SERVER` | The last path segment. Quickstart is `sn_mcp_server_default`. |++Creating a server requires the `sn_mcp_server.admin` or `admin` role. The server and its tools have to share an application scope.++### 2. Create an OAuth inbound integration++ServiceNow does not support dynamic client registration for this server. Create one inbound integration for Cursor.++1. In **MCP Server Console → Configuration → Servers**, use **Set up OAuth** on the banner, or go to **All → Machine Identity Console → Inbound integrations**.+2. Select **New integration → OAuth - Authorization code grant**.+3. Add every callback URL Cursor uses:++ | Surface | Callback URL |+ |:--------|:-------------|+ | Desktop | `http://localhost:8787/callback` |+ | Web and Cloud Agents | `https://www.cursor.com/agents/mcp/oauth/callback` |+ | Older desktop builds | `cursor://anysphere.cursor-mcp/oauth/callback` |++4. Leave **Allow access only to APIs in selected scope** cleared. With that box selected, the client can authenticate and still receive no tools.+5. If ServiceNow asks to assign an auth scope, choose **Skip for now**.+6. Under advanced options, set **Token Format** to **JWT**.+7. Save, then copy the **Client ID** and **Client secret**.++Skip inbound integrations whose names match a server name, including underscores. Those belong to AI Control Tower monitoring.++Creating the integration requires `oauth_admin`, `mi_admin`, or `admin`.++### 3. Enter the connection in Cursor++In **Dashboard → Plugins → Configure**, set:++| Field | Value |+| --- | --- |+| `SERVICENOW_HOST` | Instance hostname. |+| `SERVICENOW_MCP_SERVER` | Server name from the Server URL. |+| `CLIENT_ID` | Client ID from the inbound integration. |+| `CLIENT_SECRET` | Client secret from the same integration. Stored encrypted and never shown back. |++Each member then signs in with their own ServiceNow user. Tool calls run as that user. The connecting user needs the `sn_mcp_server.viewer` role, plus whatever ACLs the published tools require.++## Troubleshooting++| Symptom | What to check |+|:--------|:--------------|+| Sign-in succeeds and no tools appear | **Allow access only to APIs in selected scope** is selected, or the server is still a draft. |+| `401` | Sign in again so Cursor gets a new token. The integration's token format has to be **JWT**. |+| `403` | The signed-in user is missing `sn_mcp_server.viewer` or the ACL on that tool. |+| Empty result with no error | The tool's ACL is hiding the records. |+| Payload too big | ServiceNow rejects MCP request payloads over 26 KB and response payloads over 64 KB. |++## Docs++- Exploring MCP Server Console: https://www.servicenow.com/docs/r/australia/intelligent-experiences/exploring-mcp-server-console.html+- Create a server: https://www.servicenow.com/docs/r/australia/intelligent-experiences/create-mcp-server.html+- OAuth inbound integration: https://www.servicenow.com/docs/r/australia/intelligent-experiences/create-oauth-inbound-integration-mcp-client.html+- Configure a client: https://www.servicenow.com/docs/r/australia/intelligent-experiences/configure-client-connect-server.html++## License++MITdiff --git a/third_party/servicenow/assets/logo.svg b/third_party/servicenow/assets/logo.svgnew file mode 100644index 00000000..330cdaef--- /dev/null+++ b/third_party/servicenow/assets/logo.svg@@ -0,0 +1,5 @@+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" fill="none" viewBox="0 0 192 192">+ <title>ServiceNow</title>+ <rect width="192" height="192" rx="42" fill="#81B5A1"/>+ <text x="96" y="116" fill="#032D42" font-family="Helvetica, Arial, sans-serif" font-size="72" font-weight="700" text-anchor="middle">now</text>+</svg>diff --git a/third_party/servicenow/mcp.json b/third_party/servicenow/mcp.jsonnew file mode 100644index 00000000..bf61bd64--- /dev/null+++ b/third_party/servicenow/mcp.json@@ -0,0 +1,13 @@+{+ "mcpServers": {+ "servicenow": {+ "type": "http",+ "url": "https://${SERVICENOW_HOST}/sncapps/mcp-server/mcp/${SERVICENOW_MCP_SERVER}",+ "auth": {+ "CLIENT_ID": "${CLIENT_ID}",+ "CLIENT_SECRET": "${CLIENT_SECRET}",+ "scopes": ["mcp_server"]+ }+ }+ }+}