Skip to content

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.json
index 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.md
index 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 structure
diff --git a/third_party/servicenow/.cursor-plugin/plugin.json b/third_party/servicenow/.cursor-plugin/plugin.json
new file mode 100644
index 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.md
new file mode 100644
index 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/LICENSE
new file mode 100644
index 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.md
new file mode 100644
index 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
+
+MIT
diff --git a/third_party/servicenow/assets/logo.svg b/third_party/servicenow/assets/logo.svg
new file mode 100644
index 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.json
new file mode 100644
index 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"]
+ }
+ }
+ }
+}