Skip to content

Cursor plugin specification and official plugins

TypeScript

Add Playwright and GitHub third-party MCP plugins (#193)

Sam Sokolin1f4e9b59762f
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index bea233fa..8c9fa276 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -97,6 +97,16 @@
"name": "salesforce",
"source": "third_party/salesforce",
"description": "Connect Cursor to Salesforce via Salesforce Hosted MCP — query, search, create, update, and traverse records in your org."
+ },
+ {
+ "name": "playwright",
+ "source": "third_party/playwright",
+ "description": "Drive a real browser for agents — navigate pages, click and fill elements, take snapshots and screenshots, and run end-to-end checks — via Microsoft's Playwright MCP server."
+ },
+ {
+ "name": "github",
+ "source": "third_party/github",
+ "description": "Connect Cursor to GitHub — repositories, issues, pull requests, code search, and Actions — via GitHub's official remote MCP server."
}
]
}
diff --git a/third_party/github/.cursor-plugin/plugin.json b/third_party/github/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..e23e61bd
--- /dev/null
+++ b/third_party/github/.cursor-plugin/plugin.json
@@ -0,0 +1,45 @@
+{
+ "name": "github",
+ "displayName": "GitHub",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Connect Cursor to GitHub — repositories, issues, pull requests, code search, and Actions — via GitHub's official remote MCP server.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://docs.github.com/en/copilot/how-tos/context/use-mcp/use-the-github-mcp-server",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.svg",
+ "keywords": [
+ "github",
+ "git",
+ "repositories",
+ "pull-requests",
+ "issues",
+ "actions",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "github",
+ "git",
+ "mcp",
+ "repositories"
+ ],
+ "variables": {
+ "type": "object",
+ "properties": {
+ "GITHUB_PERSONAL_ACCESS_TOKEN": {
+ "type": "string",
+ "title": "GitHub personal access token",
+ "description": "Fine-grained or classic PAT from https://github.com/settings/tokens with the repo scopes you want the agent to use."
+ }
+ },
+ "required": ["GITHUB_PERSONAL_ACCESS_TOKEN"]
+ },
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/github/CHANGELOG.md b/third_party/github/CHANGELOG.md
new file mode 100644
index 00000000..2d8967b5
--- /dev/null
+++ b/third_party/github/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Logo: GitHub's official Octocat mark, on a padded white tile.
+- Added the `github` MCP server pointing at `https://api.githubcopilot.com/mcp/`.
+- Declared `GITHUB_PERSONAL_ACCESS_TOKEN` plugin variable and forwarded it through the Authorization header.
diff --git a/third_party/github/LICENSE b/third_party/github/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/github/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/github/README.md b/third_party/github/README.md
new file mode 100644
index 00000000..38628e92
--- /dev/null
+++ b/third_party/github/README.md
@@ -0,0 +1,64 @@
+# GitHub
+
+Cursor plugin that connects agents to [GitHub](https://github.com) through GitHub's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Work with repositories, issues, pull requests, code search, and Actions under the permissions of a personal access token you provide.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **GitHub**.
+3. Click **Install**, then set your GitHub personal access token (below).
+
+Or run `/add-plugin github` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "github": {
+ "type": "http",
+ "url": "https://api.githubcopilot.com/mcp/",
+ "headers": {
+ "Authorization": "Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}"
+ }
+ }
+ }
+}
+```
+
+## Setup
+
+GitHub's remote MCP server authenticates with a **personal access token (PAT)**. Create one, then paste it into the plugin config.
+
+### 1. Create a personal access token
+
+1. Open https://github.com/settings/tokens.
+2. Create either a **fine-grained** token or a **classic** token.
+3. Grant only the scopes the agent needs. Typical choices:
+ - **Repositories / contents** — read or write code and files
+ - **Issues** — list, create, and update issues
+ - **Pull requests** — list, review, and manage PRs
+ - **Actions** — inspect workflow runs (if you want CI access)
+ - **Metadata** — always required on fine-grained tokens
+4. Set an expiration you are comfortable with, then generate and copy the token.
+
+Prefer a fine-grained token scoped to specific repositories when that is enough. Classic tokens with `repo` are broader and should be treated carefully.
+
+### 2. Configure the plugin
+
+In **Dashboard → Plugins → Configure**, set **GitHub personal access token** to the value you just created.
+
+Tool calls run with that token's permissions. Rotate or revoke the token from GitHub Settings if it is ever exposed.
+
+## Docs
+
+- Use the GitHub MCP server: https://docs.github.com/en/copilot/how-tos/context/use-mcp/use-the-github-mcp-server
+- Managing personal access tokens: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens
+
+Logo is GitHub's official Octocat mark, placed on a white tile with padding so it reads well in the Cursor UI.
+
+## License
+
+MIT
diff --git a/third_party/github/assets/logo.svg b/third_party/github/assets/logo.svg
new file mode 100644
index 00000000..7efe1a65
--- /dev/null
+++ b/third_party/github/assets/logo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" fill="none" viewBox="0 0 192 192"><rect width="192" height="192" fill="#fff"/><g transform="translate(12 12) scale(7)"><path fill="#24292f" d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.399 3-.405 1.02.006 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/></g></svg>
diff --git a/third_party/github/mcp.json b/third_party/github/mcp.json
new file mode 100644
index 00000000..e2dafb84
--- /dev/null
+++ b/third_party/github/mcp.json
@@ -0,0 +1,11 @@
+{
+ "mcpServers": {
+ "github": {
+ "type": "http",
+ "url": "https://api.githubcopilot.com/mcp/",
+ "headers": {
+ "Authorization": "Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}"
+ }
+ }
+ }
+}
diff --git a/third_party/playwright/.cursor-plugin/plugin.json b/third_party/playwright/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..13624b91
--- /dev/null
+++ b/third_party/playwright/.cursor-plugin/plugin.json
@@ -0,0 +1,35 @@
+{
+ "name": "playwright",
+ "displayName": "Playwright",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Drive a real browser for agents — navigate pages, click and fill elements, take snapshots and screenshots, and run end-to-end checks — via Microsoft's Playwright MCP server.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://github.com/microsoft/playwright-mcp",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.svg",
+ "keywords": [
+ "playwright",
+ "browser",
+ "automation",
+ "testing",
+ "e2e",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "playwright",
+ "browser",
+ "automation",
+ "testing",
+ "e2e",
+ "mcp"
+ ],
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/playwright/CHANGELOG.md b/third_party/playwright/CHANGELOG.md
new file mode 100644
index 00000000..384e79eb
--- /dev/null
+++ b/third_party/playwright/CHANGELOG.md
@@ -0,0 +1,8 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Logo: Microsoft's official Playwright mark from playwright.dev, on a padded white tile.
+- Added the `playwright` MCP server launched via `npx -y @playwright/mcp@latest`.
diff --git a/third_party/playwright/LICENSE b/third_party/playwright/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/playwright/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/playwright/README.md b/third_party/playwright/README.md
new file mode 100644
index 00000000..c7e57ad9
--- /dev/null
+++ b/third_party/playwright/README.md
@@ -0,0 +1,46 @@
+# Playwright
+
+Cursor plugin that connects agents to a real browser through Microsoft's [Playwright MCP](https://github.com/microsoft/playwright-mcp) server.
+
+Navigate pages, click and fill elements, take accessibility snapshots and screenshots, and run end-to-end checks from chat.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Playwright**.
+3. Click **Install**.
+
+Or run `/add-plugin playwright` in chat.
+
+## Requirements
+
+This is a **local stdio** MCP server. Cursor launches it with `npx -y @playwright/mcp@latest`, so the machine running Cursor needs **Node.js** installed and on `PATH`. The `-y` flag skips `npx`'s install confirmation so the first launch cannot hang waiting for interactive input over stdio.
+
+The first run downloads Playwright's browser binaries. That can take a minute and needs network access; later runs reuse the cached browsers.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "playwright": {
+ "command": "npx",
+ "args": ["-y", "@playwright/mcp@latest"]
+ }
+ }
+}
+```
+
+No credentials are required. The server runs locally and drives a browser on the same machine.
+
+## Docs
+
+- Playwright MCP: https://github.com/microsoft/playwright-mcp
+- Playwright: https://playwright.dev
+
+Logo is Microsoft's official Playwright mark from the Playwright website, placed on a white tile with padding so it reads well in the Cursor UI:
+https://github.com/microsoft/playwright.dev/blob/main/static/img/playwright-logo.svg
+
+## License
+
+MIT
diff --git a/third_party/playwright/assets/logo.svg b/third_party/playwright/assets/logo.svg
new file mode 100644
index 00000000..4f595fbb
--- /dev/null
+++ b/third_party/playwright/assets/logo.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" fill="none" viewBox="0 0 192 192"><rect width="192" height="192" fill="#fff"/><g transform="translate(12 12) scale(0.42)">
+<path d="M136.444 221.556C123.558 225.213 115.104 231.625 109.535 238.032C114.869 233.364 122.014 229.08 131.652 226.348C141.51 223.554 149.92 223.574 156.869 224.915V219.481C150.941 218.939 144.145 219.371 136.444 221.556ZM108.946 175.876L61.0895 188.484C61.0895 188.484 61.9617 189.716 63.5767 191.36L104.153 180.668C104.153 180.668 103.578 188.077 98.5847 194.705C108.03 187.559 108.946 175.876 108.946 175.876ZM149.005 288.347C81.6582 306.486 46.0272 228.438 35.2396 187.928C30.2556 169.229 28.0799 155.067 27.5 145.928C27.4377 144.979 27.4665 144.179 27.5336 143.446C24.04 143.657 22.3674 145.473 22.7077 150.721C23.2876 159.855 25.4633 174.016 30.4473 192.721C41.2301 233.225 76.8659 311.273 144.213 293.134C158.872 289.185 169.885 281.992 178.152 272.81C170.532 279.692 160.995 285.112 149.005 288.347ZM161.661 128.11V132.903H188.077C187.535 131.206 186.989 129.677 186.447 128.11H161.661Z" fill="#2D4552"/>
+<path d="M193.981 167.584C205.861 170.958 212.144 179.287 215.465 186.658L228.711 190.42C228.711 190.42 226.904 164.623 203.57 157.995C181.741 151.793 168.308 170.124 166.674 172.496C173.024 167.972 182.297 164.268 193.981 167.584ZM299.422 186.777C277.573 180.547 264.145 198.916 262.535 201.255C268.89 196.736 278.158 193.031 289.837 196.362C301.698 199.741 307.976 208.06 311.307 215.436L324.572 219.212C324.572 219.212 322.736 193.41 299.422 186.777ZM286.262 254.795L176.072 223.99C176.072 223.99 177.265 230.038 181.842 237.869L274.617 263.805C282.255 259.386 286.262 254.795 286.262 254.795ZM209.867 321.102C122.618 297.71 133.166 186.543 147.284 133.865C153.097 112.156 159.073 96.0203 164.029 85.204C161.072 84.5953 158.623 86.1529 156.203 91.0746C150.941 101.747 144.212 119.124 137.7 143.45C123.586 196.127 113.038 307.29 200.283 330.682C241.406 341.699 273.442 324.955 297.323 298.659C274.655 319.19 245.714 330.701 209.867 321.102Z" fill="#2D4552"/>
+<path d="M161.661 262.296V239.863L99.3324 257.537C99.3324 257.537 103.938 230.777 136.444 221.556C146.302 218.762 154.713 218.781 161.661 220.123V128.11H192.869C189.471 117.61 186.184 109.526 183.423 103.909C178.856 94.612 174.174 100.775 163.545 109.665C156.059 115.919 137.139 129.261 108.668 136.933C80.1966 144.61 57.179 142.574 47.5752 140.911C33.9601 138.562 26.8387 135.572 27.5049 145.928C28.0847 155.062 30.2605 169.224 35.2445 187.928C46.0272 228.433 81.663 306.481 149.01 288.342C166.602 283.602 179.019 274.233 187.626 262.291H161.661V262.296ZM61.0848 188.484L108.946 175.876C108.946 175.876 107.551 194.288 89.6087 199.018C71.6614 203.743 61.0848 188.484 61.0848 188.484Z" fill="#E2574C"/>
+<path d="M341.786 129.174C329.345 131.355 299.498 134.072 262.612 124.185C225.716 114.304 201.236 97.0224 191.537 88.8994C177.788 77.3834 171.74 69.3802 165.788 81.4857C160.526 92.163 153.797 109.54 147.284 133.866C133.171 186.543 122.623 297.706 209.867 321.098C297.093 344.47 343.53 242.92 357.644 190.238C364.157 165.917 367.013 147.5 367.799 135.625C368.695 122.173 359.455 126.078 341.786 129.174ZM166.497 172.756C166.497 172.756 180.246 151.372 203.565 158C226.899 164.628 228.706 190.425 228.706 190.425L166.497 172.756ZM223.42 268.713C182.403 256.698 176.077 223.99 176.077 223.99L286.262 254.796C286.262 254.791 264.021 280.578 223.42 268.713ZM262.377 201.495C262.377 201.495 276.107 180.126 299.422 186.773C322.736 193.411 324.572 219.208 324.572 219.208L262.377 201.495Z" fill="#2EAD33"/>
+<path d="M139.88 246.04L99.3324 257.532C99.3324 257.532 103.737 232.44 133.607 222.496L110.647 136.33L108.663 136.933C80.1918 144.611 57.1742 142.574 47.5704 140.911C33.9554 138.563 26.834 135.572 27.5001 145.929C28.08 155.063 30.2557 169.224 35.2397 187.929C46.0225 228.433 81.6583 306.481 149.005 288.342L150.989 287.719L139.88 246.04ZM61.0848 188.485L108.946 175.876C108.946 175.876 107.551 194.288 89.6087 199.018C71.6615 203.743 61.0848 188.485 61.0848 188.485Z" fill="#D65348"/>
+<path d="M225.27 269.163L223.415 268.712C182.398 256.698 176.072 223.99 176.072 223.99L232.89 239.872L262.971 124.281L262.607 124.185C225.711 114.304 201.232 97.0224 191.532 88.8994C177.783 77.3834 171.735 69.3802 165.783 81.4857C160.526 92.163 153.797 109.54 147.284 133.866C133.171 186.543 122.623 297.706 209.867 321.097L211.655 321.5L225.27 269.163ZM166.497 172.756C166.497 172.756 180.246 151.372 203.565 158C226.899 164.628 228.706 190.425 228.706 190.425L166.497 172.756Z" fill="#1D8D22"/>
+<path d="M141.946 245.451L131.072 248.537C133.641 263.019 138.169 276.917 145.276 289.195C146.513 288.922 147.74 288.687 149 288.342C152.302 287.451 155.364 286.348 158.312 285.145C150.371 273.361 145.118 259.789 141.946 245.451ZM137.7 143.451C132.112 164.307 127.113 194.326 128.489 224.436C130.952 223.367 133.554 222.371 136.444 221.551L138.457 221.101C136.003 188.939 141.308 156.165 147.284 133.866C148.799 128.225 150.318 122.978 151.832 118.085C149.393 119.637 146.767 121.228 143.776 122.867C141.759 129.093 139.722 135.898 137.7 143.451Z" fill="#C04B41"/>
+</g></svg>
diff --git a/third_party/playwright/mcp.json b/third_party/playwright/mcp.json
new file mode 100644
index 00000000..20d34743
--- /dev/null
+++ b/third_party/playwright/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "playwright": {
+ "command": "npx",
+ "args": ["-y", "@playwright/mcp@latest"]
+ }
+ }
+}