Cursor plugin specification and official plugins
TypeScript
Add the Google Ads plugin backed by Cursor's REST MCP translator
Eric G.Y Liu011b0d7925ee
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex f0c3bd37..4945bd0d 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -123,6 +123,11 @@"source": "third_party/google-slides","description": "Create, edit, and render presentations."},+ {+ "name": "google-ads",+ "source": "third_party/google-ads",+ "description": "Report on campaigns, research keywords, and make previewed changes."+ },{"name": "gong","source": "third_party/gong",diff --git a/README.md b/README.mdindex 88684990..8a31374e 100644--- a/README.md+++ b/README.md@@ -29,6 +29,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `google-docs` | [Google Docs](third_party/google-docs/) | Cursor | Productivity | Read, create, and edit documents. || `google-sheets` | [Google Sheets](third_party/google-sheets/) | Cursor | Productivity | Read, write, and append spreadsheet data. || `google-slides` | [Google Slides](third_party/google-slides/) | Cursor | Productivity | Create, edit, and render presentations. |+| `google-ads` | [Google Ads](third_party/google-ads/) | Cursor | Integrations | Report on campaigns, research keywords, and make previewed changes. || `gong` | [Gong](third_party/gong/) | Cursor | Integrations | Pull account summaries, deal insights, and call briefs. || `salesforce` | [Salesforce](third_party/salesforce/) | Cursor | Integrations | Query, create, and update records in your org. || `salesforce-headless-360` | [Salesforce (Headless 360, Beta)](third_party/salesforce-headless-360/) | Cursor | Integrations | Manage records, users, and org setup across Salesforce. |diff --git a/third_party/google-ads/.cursor-plugin/plugin.json b/third_party/google-ads/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..baf0f415--- /dev/null+++ b/third_party/google-ads/.cursor-plugin/plugin.json@@ -0,0 +1,36 @@+{+ "name": "google-ads",+ "displayName": "Google Ads",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "never",+ "grokbot": "0.30.0",+ "sand": "0.30.0"+ },+ "description": "Report on campaigns, research keywords, and make previewed changes.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://github.com/cursor/plugins/tree/main/third_party/google-ads",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.svg",+ "keywords": [+ "google-ads",+ "ads",+ "advertising",+ "google",+ "campaigns",+ "keywords",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "google-ads",+ "ads",+ "advertising",+ "mcp"+ ],+ "mcpServers": "./mcp.json"+}diff --git a/third_party/google-ads/CHANGELOG.md b/third_party/google-ads/CHANGELOG.mdnew file mode 100644index 00000000..f25f2add--- /dev/null+++ b/third_party/google-ads/CHANGELOG.md@@ -0,0 +1,8 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 - initial release++- Logo: official Google Ads product icon on a padded white tile.+- Added the `google-ads` MCP server pointing at `https://api.cursor.com/rest-mcp/google-ads/mcp`.diff --git a/third_party/google-ads/LICENSE b/third_party/google-ads/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/google-ads/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/google-ads/README.md b/third_party/google-ads/README.mdnew file mode 100644index 00000000..6c34f908--- /dev/null+++ b/third_party/google-ads/README.md@@ -0,0 +1,39 @@+# Google Ads++Cursor plugin that connects Grok Bot to [Google Ads](https://ads.google.com) through Cursor's remote [Model Context Protocol](https://modelcontextprotocol.io/) server.++Report on accounts and campaigns with GAQL, research keywords and audiences, and make campaign changes. Every change is checked with `validate_mutate` (`validateOnly`) before `mutate` applies it.++## Install++1. Open **Grok Bot Settings → Plugins**.+2. Search for **Google Ads**.+3. Click **Install**, then complete the Google sign-in prompt.++## MCP++```json+{+ "mcpServers": {+ "google-ads": {+ "type": "http",+ "url": "https://api.cursor.com/rest-mcp/google-ads/mcp"+ }+ }+}+```++Auth is OAuth 2.0 against Google with the `https://www.googleapis.com/auth/adwords` scope. Grok Bot prompts for Google sign-in when the plugin connects.++## Tools++- **Reporting:** `list_accessible_customers`, `search`, `search_fields`, `list_billing`, `get_operation`+- **Planning:** `keyword_planner`, `reach_planner`, `audience_insights`, `benchmarks`, `suggest`, `generate_assets`+- **Changes:** `validate_mutate`, `mutate`, `recommendation_action`, `experiment_action`, `upload_conversions`++## Docs++- Google Ads API: https://developers.google.com/google-ads/api/docs/start+- GAQL: https://developers.google.com/google-ads/api/docs/query/overview++Logo is the official Google Ads product icon, placed on a white tile with padding so it reads well in the UI.diff --git a/third_party/google-ads/assets/logo.svg b/third_party/google-ads/assets/logo.svgnew file mode 100644index 00000000..9252bfa9--- /dev/null+++ b/third_party/google-ads/assets/logo.svg@@ -0,0 +1 @@+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" viewBox="0 0 192 192"><rect width="192" height="192" fill="#fff"/><g transform="translate(36 41) scale(0.4785)"><path fill="#3C8BD9" d="M85.9,28.6c2.4-6.3,5.7-12.1,10.6-16.8c19.6-19.1,52-14.3,65.3,9.7c10,18.2,20.6,36,30.9,54 c17.2,29.9,34.6,59.8,51.6,89.8c14.3,25.1-1.2,56.8-29.6,61.1c-17.4,2.6-33.7-5.4-42.7-21c-15.1-26.3-30.3-52.6-45.4-78.8 c-0.3-0.6-0.7-1.1-1.1-1.6c-1.6-1.3-2.3-3.2-3.3-4.9c-6.7-11.8-13.6-23.5-20.3-35.2c-4.3-7.6-8.8-15.1-13.1-22.7 c-3.9-6.8-5.7-14.2-5.5-22C83.6,36.2,84.1,32.2,85.9,28.6"/><path fill="#FABC04" d="M85.9,28.6c-0.9,3.6-1.7,7.2-1.9,11c-0.3,8.4,1.8,16.2,6,23.5C101,82,112,101,122.9,120c1,1.7,1.8,3.4,2.8,5 c-6,10.4-12,20.7-18.1,31.1c-8.4,14.5-16.8,29.1-25.3,43.6c-0.4,0-0.5-0.2-0.6-0.5c-0.1-0.8,0.2-1.5,0.4-2.3 c4.1-15,0.7-28.3-9.6-39.7c-6.3-6.9-14.3-10.8-23.5-12.1c-12-1.7-22.6,1.4-32.1,8.9c-1.7,1.3-2.8,3.2-4.8,4.2 c-0.4,0-0.6-0.2-0.7-0.5c4.8-8.3,9.5-16.6,14.3-24.9C45.5,98.4,65.3,64,85.2,29.7C85.4,29.3,85.7,29,85.9,28.6"/><path fill="#34A852" d="M11.8,158c1.9-1.7,3.7-3.5,5.7-5.1c24.3-19.2,60.8-5.3,66.1,25.1c1.3,7.3,0.6,14.3-1.6,21.3 c-0.1,0.6-0.2,1.1-0.4,1.7c-0.9,1.6-1.7,3.3-2.7,4.9c-8.9,14.7-22,22-39.2,20.9C20,225.4,4.5,210.6,1.8,191 c-1.3-9.5,0.6-18.4,5.5-26.6c1-1.8,2.2-3.4,3.3-5.2C11.1,158.8,10.9,158,11.8,158"/><path fill="#FABC04" d="M11.8,158c-0.4,0.4-0.4,1.1-1.1,1.2c-0.1-0.7,0.3-1.1,0.7-1.6L11.8,158"/><path fill="#E1C025" d="M81.6,201c-0.4-0.7,0-1.2,0.4-1.7c0.1,0.1,0.3,0.3,0.4,0.4L81.6,201"/></g></svg>diff --git a/third_party/google-ads/mcp.json b/third_party/google-ads/mcp.jsonnew file mode 100644index 00000000..730b3c5b--- /dev/null+++ b/third_party/google-ads/mcp.json@@ -0,0 +1,8 @@+{+ "mcpServers": {+ "google-ads": {+ "type": "http",+ "url": "https://api.cursor.com/rest-mcp/google-ads/mcp"+ }+ }+}