From 6e4ac01fe0910bac380df4d70e73a99be4a9dbab Mon Sep 17 00:00:00 2001 From: djiang-jq Date: Wed, 11 Nov 2026 12:57:33 -0800 Subject: [PATCH 1/3] feat(third_party): add the NetSuite plugin Connect agents to the NetSuite AI Connector Service, NetSuite's own MCP server. The endpoint is account-specific, so the plugin takes the server URL as a required variable and accepts both documented forms, /all and /suiteapp/. Auth is OAuth with NetSuite user sign-in via dynamic client registration, so there is no client ID or secret to enter. Co-authored-by: Cursor --- .cursor-plugin/marketplace.json | 5 + README.md | 1 + .../netsuite/.cursor-plugin/plugin.json | 49 +++++++ third_party/netsuite/CHANGELOG.md | 10 ++ third_party/netsuite/LICENSE | 21 +++ third_party/netsuite/README.md | 123 ++++++++++++++++++ third_party/netsuite/assets/logo.png | Bin 0 -> 27625 bytes third_party/netsuite/mcp.json | 8 ++ 8 files changed, 217 insertions(+) create mode 100644 third_party/netsuite/.cursor-plugin/plugin.json create mode 100644 third_party/netsuite/CHANGELOG.md create mode 100644 third_party/netsuite/LICENSE create mode 100644 third_party/netsuite/README.md create mode 100644 third_party/netsuite/assets/logo.png create mode 100644 third_party/netsuite/mcp.json diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 19da8e1423..83a2ec1ed6 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -707,6 +707,11 @@ "name": "eight-sleep", "source": "third_party/eight-sleep", "description": "Connect your Eight Sleep account to see your sleep scores, stages and heart metrics, check your Pod's status and temperature settings, and manage your alarms and your side of the Pod, with your approval for each change." + }, + { + "name": "netsuite", + "source": "third_party/netsuite", + "description": "Work with records, reports, saved searches, and SuiteQL queries in NetSuite." } ] } diff --git a/README.md b/README.md index ccfa6c688a..2ec024e8d3 100644 --- a/README.md +++ b/README.md @@ -129,6 +129,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `mixpanel` | [Mixpanel](third_party/mixpanel/) | Cursor | Integrations | Query events, funnels, flows, and retention in Mixpanel, and manage dashboards, cohorts, experiments, and feature flags. | | `metricool` | [Metricool](third_party/metricool/) | Cursor | Integrations | Plan and publish social posts, pull metrics and reports, and manage inbox, reviews, and ads across your Metricool brands. | | `eight-sleep` | [Eight Sleep](third_party/eight-sleep/) | Cursor | Integrations | Connect your Eight Sleep account to see your sleep scores, stages and heart metrics, check your Pod's status and temperature settings, and manage your alarms and your side of the Pod, with your approval for each change. | +| `netsuite` | [NetSuite](third_party/netsuite/) | Cursor | Integrations | Work with records, reports, saved searches, and SuiteQL queries in NetSuite. | Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest). ## Repository structure diff --git a/third_party/netsuite/.cursor-plugin/plugin.json b/third_party/netsuite/.cursor-plugin/plugin.json new file mode 100644 index 0000000000..28be5cb596 --- /dev/null +++ b/third_party/netsuite/.cursor-plugin/plugin.json @@ -0,0 +1,49 @@ +{ + "name": "netsuite", + "displayName": "NetSuite", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.19.0" + }, + "description": "Work with records, reports, saved searches, and SuiteQL queries in NetSuite.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "netsuite", + "oracle", + "erp", + "suiteql", + "saved searches", + "accounting", + "ai connector service", + "mcp" + ], + "category": "integrations", + "tags": [ + "netsuite", + "erp", + "accounting", + "mcp" + ], + "variables": { + "type": "object", + "additionalProperties": false, + "required": [ + "NETSUITE_MCP_URL" + ], + "properties": { + "NETSUITE_MCP_URL": { + "type": "string", + "title": "NetSuite MCP server URL", + "description": "Account-specific AI Connector Service URL. Every tool in the account: https://.suitetalk.api.netsuite.com/services/mcp/v1/all. Only the MCP Standard Tools SuiteApp: https://.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/com.netsuite.mcpstandardtools. Find the account ID under Setup → Company → Company Information, lowercased with underscores replaced by hyphens, so 1234567_SB1 becomes 1234567-sb1." + } + } + }, + "mcpServers": "./mcp.json" +} diff --git a/third_party/netsuite/CHANGELOG.md b/third_party/netsuite/CHANGELOG.md new file mode 100644 index 0000000000..c3f608a2a5 --- /dev/null +++ b/third_party/netsuite/CHANGELOG.md @@ -0,0 +1,10 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `netsuite` MCP server pointing at the NetSuite AI Connector Service over Streamable HTTP. +- The server URL is account-specific, so `NETSUITE_MCP_URL` is a required plugin variable. Both documented forms work: `/services/mcp/v1/all` and `/services/mcp/v1/suiteapp/`. +- Auth uses OAuth with NetSuite user sign-in (authorization code + PKCE, dynamic client registration, scope `mcp`) — no client ID or secret to configure. +- Logo: NetSuite's official mark, from the NetSuite iOS app icon published by Oracle America. diff --git a/third_party/netsuite/LICENSE b/third_party/netsuite/LICENSE new file mode 100644 index 0000000000..ca2bba771c --- /dev/null +++ b/third_party/netsuite/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/netsuite/README.md b/third_party/netsuite/README.md new file mode 100644 index 0000000000..38de9733c8 --- /dev/null +++ b/third_party/netsuite/README.md @@ -0,0 +1,123 @@ +# NetSuite + +Cursor plugin that connects agents to an [Oracle NetSuite](https://www.netsuite.com) account through the [NetSuite AI Connector Service](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html), NetSuite's own [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Agents query data with SuiteQL, run reports and saved searches, and create, update, transform, and act on records. Every call runs as the NetSuite user who signed in, under that user's role and permissions. + +## Install + +1. An administrator enables the required features and permissions and installs a tools SuiteApp (see [Account setup](#account-setup)). +2. A Cursor team admin opens **Cursor Settings → Plugins**, searches for **NetSuite**, installs it, and enters the account-specific server URL. +3. Each member signs in to NetSuite when Cursor prompts them, choosing a non-administrator role. + +Or run `/add-plugin netsuite` in chat. + +## MCP + +```json +{ + "mcpServers": { + "netsuite": { + "type": "http", + "url": "${NETSUITE_MCP_URL}" + } + } +} +``` + +The URL is unique to the account, so there is no default. NetSuite documents two forms: + +| Form | Returns | +| --- | --- | +| `https://.suitetalk.api.netsuite.com/services/mcp/v1/all` | Every tool installed in the account, from SuiteApps and account customization projects | +| `https://.suitetalk.api.netsuite.com/services/mcp/v1/suiteapp/` | Only the tools one SuiteApp exposes. The MCP Standard Tools SuiteApp is `com.netsuite.mcpstandardtools` | + +`` is the account ID from **Setup → Company → Company Information**, in domain form: lowercase, with underscores replaced by hyphens, so `1234567_SB1` becomes `1234567-sb1`. Without the `/all` or `/suiteapp/` suffix the connection shows as disconnected. + +Auth is OAuth 2.0 authorization code with PKCE and the `mcp` scope, which NetSuite only accepts on its own. There is no client ID or secret to enter: NetSuite supports dynamic client registration for this service, so Cursor registers itself when a member connects. + +## Account setup + +An administrator does this once per account. + +### 1. Enable the features + +Under **Setup → Company → Enable Features → SuiteCloud**, enable **Server SuiteScript** and **OAUTH 2.0**. The MCP Standard Tools SuiteApp also needs **REST Web Services**. + +### 2. Install a tools SuiteApp + +The service only exposes tools that exist in the account. For the standard set, open the **SuiteApps** tab, search for **MCP Standard Tools**, and install it. Otherwise, build custom tools. + +### 3. Create a scoped role + +Administrator roles and roles with full permissions are blocked from the service, so members need a dedicated role. Under **Setup → Users/Roles → Manage Roles**, add these on the **Permissions → Setup** subtab: + +| Permission | Why | +| --- | --- | +| MCP Server Connection | Required to reach the service. Not **Log in using Access Tokens** | +| Log in using OAuth 2.0 Access Tokens | Required for the OAuth flow | +| REST Web Services | Needed by the record tools in MCP Standard Tools | + +Grant only the record and task permissions the account wants reachable from an agent, then assign the role to each member under **Lists → Employees → Employees → Access → Roles**. The role also needs access to the SuiteApp's File Cabinet folder. + +### 4. Check the integration record + +Under **Setup → Integration → Manage Integrations**, confirm an integration record exists with **Public Client**, **Authorization Code Grant**, and the **NetSuite AI Connector Service** scope. A record created by a SuiteApp install starts pending and an administrator has to enable it; a record without that scope has to be recreated. If no record exists, create one. + +For dynamic client registration, check **Dynamic Client Registration**, set **Client Name for Dynamic Client Registration** to `Cursor`, and add the callback URLs 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` | + +Leave the token-based authentication, client credentials, and other OAuth 2.0 scope boxes cleared. The record's **AI Connector Service (MCP)** execution log lists every call, for 21 days in production and seven in sandbox. + +## What agents can do + +With the MCP Standard Tools SuiteApp installed: + +| Category | Tools | +| --- | --- | +| SuiteQL | `ns_runCustomSuiteQL` (read-only), `ns_getSuiteQLMetadata` | +| Records | `ns_createRecord`, `ns_getRecord`, `ns_updateRecord`, `ns_transformRecord`, `ns_getRecordTypeMetadata`, `ns_getRecordTransformMetadata` | +| Record actions | `ns_getRecordActionMetadata`, `ns_executeRecordAction` | +| Reports | `ns_listAllReports`, `ns_runReport`, `ns_getAccountingBooks`, `ns_getAccountingContexts`, `ns_getSubsidiaries`, `ns_getNexusIds` | +| Saved searches | `ns_listSavedSearches`, `ns_runSavedSearch` | +| File Cabinet | `ns_searchFiles`, `ns_getFolderByPath`, `ns_getIdFromPath`, `ns_getPathFromId`, `ns_attachFile`, `ns_detachFile` | +| Runtime | `ns_getSessionInfo` | + +It is a managed SuiteApp, so Oracle changes the tool set over time and the live server is the source of truth. A tool only appears when the signed-in role holds every permission that tool requires, and accounts with custom tools see those instead or as well. + +## Notes + +- The record tools write through REST Web Services. Any role carrying **MCP Server Connection** can create and update whatever its permissions already allow, so scope the role rather than relying on the tool list. +- Reads and writes obey NetSuite roles and permissions exactly as the UI does; the tools add no access of their own. +- Oracle has not assessed this service for HIPAA, so do not route ePHI through it. +- Administrators can disable the integration record or cap its share of the account's concurrency limit. +- Review Oracle's [associated risks, controls, and mitigation strategies](https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html) before connecting an account. + +## Troubleshooting + +| Symptom | What to check | +|:--------|:--------------| +| Connection shows as disconnected | The URL is missing `/all` or `/suiteapp/`, or the account ID is not in domain form | +| Sign-in succeeds and no tools appear | No tools SuiteApp is installed, the role lacks the permissions those tools require, or the role cannot reach the SuiteApp's File Cabinet folder | +| Sign-in is refused | The chosen role is Administrator or has full permissions, or it is missing **MCP Server Connection** or **Log in using OAuth 2.0 Access Tokens** | +| Redirect URI error during sign-in | The integration record has no matching callback URL, or its DCR client name is not `Cursor` | +| Tools are visible and calls fail | The signed-in role lacks the record or action permission, or **REST Web Services** is off | + +## Docs + +- Get started: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_3200541651.html +- Required features and permissions: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714080625.html +- Connect to the service and server URL formats: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_0714082142.html +- MCP Standard Tools SuiteApp: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_143403258.html +- Available tools: https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/article_0902023508.html + +Logo is NetSuite's official mark, from the NetSuite iOS app icon published by Oracle America. + +## License + +MIT diff --git a/third_party/netsuite/assets/logo.png b/third_party/netsuite/assets/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..27ef4448efacd0616b844ceb4965b0e4007a744e GIT binary patch literal 27625 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

y~l3+%#c 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 Date: Wed, 11 Nov 2026 17:48:24 -0800 Subject: [PATCH 2/3] feat(third_party): add the Front plugin Connect agents to Front's hosted MCP server at https://mcp.frontapp.com/mcp. Front does not support dynamic client registration, so an admin registers a developer app with the Front MCP feature and enters its client ID and secret as plugin variables. Co-authored-by: Cursor --- .cursor-plugin/marketplace.json | 5 ++ README.md | 1 + third_party/front/.cursor-plugin/plugin.json | 50 +++++++++++ third_party/front/CHANGELOG.md | 10 +++ third_party/front/LICENSE | 21 +++++ third_party/front/README.md | 90 +++++++++++++++++++ third_party/front/assets/logo.png | Bin 0 -> 10028 bytes third_party/front/mcp.json | 13 +++ 8 files changed, 190 insertions(+) create mode 100644 third_party/front/.cursor-plugin/plugin.json create mode 100644 third_party/front/CHANGELOG.md create mode 100644 third_party/front/LICENSE create mode 100644 third_party/front/README.md create mode 100644 third_party/front/assets/logo.png create mode 100644 third_party/front/mcp.json diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 83a2ec1ed6..82dda9aa44 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -712,6 +712,11 @@ "name": "netsuite", "source": "third_party/netsuite", "description": "Work with records, reports, saved searches, and SuiteQL queries in NetSuite." + }, + { + "name": "front", + "source": "third_party/front", + "description": "Search conversations, draft and send replies, and manage tags, tasks, and inboxes." } ] } diff --git a/README.md b/README.md index 2ec024e8d3..f13e094223 100644 --- a/README.md +++ b/README.md @@ -130,6 +130,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `metricool` | [Metricool](third_party/metricool/) | Cursor | Integrations | Plan and publish social posts, pull metrics and reports, and manage inbox, reviews, and ads across your Metricool brands. | | `eight-sleep` | [Eight Sleep](third_party/eight-sleep/) | Cursor | Integrations | Connect your Eight Sleep account to see your sleep scores, stages and heart metrics, check your Pod's status and temperature settings, and manage your alarms and your side of the Pod, with your approval for each change. | | `netsuite` | [NetSuite](third_party/netsuite/) | Cursor | Integrations | Work with records, reports, saved searches, and SuiteQL queries in NetSuite. | +| `front` | [Front](third_party/front/) | Cursor | Integrations | Search conversations, draft and send replies, and manage tags, tasks, and inboxes. | Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest). ## Repository structure diff --git a/third_party/front/.cursor-plugin/plugin.json b/third_party/front/.cursor-plugin/plugin.json new file mode 100644 index 0000000000..1804e13603 --- /dev/null +++ b/third_party/front/.cursor-plugin/plugin.json @@ -0,0 +1,50 @@ +{ + "name": "front", + "displayName": "Front", + "version": "1.0.0", + "description": "Search conversations, draft and send replies, and manage tags, tasks, and inboxes.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://dev.frontapp.com/docs/mcp-server", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "front", + "frontapp", + "mcp", + "inbox", + "customer support", + "email", + "conversations" + ], + "category": "integrations", + "tags": [ + "mcp", + "support", + "email", + "productivity" + ], + "variables": { + "type": "object", + "properties": { + "CLIENT_ID": { + "type": "string", + "title": "Front Client ID", + "description": "Client ID of a Front developer app with the Front MCP feature, from Front Settings → Company → Developer." + }, + "CLIENT_SECRET": { + "type": "string", + "title": "Front Client Secret", + "description": "Client Secret of the same Front developer app." + } + }, + "required": [ + "CLIENT_ID", + "CLIENT_SECRET" + ] + }, + "mcpServers": "./mcp.json" +} diff --git a/third_party/front/CHANGELOG.md b/third_party/front/CHANGELOG.md new file mode 100644 index 0000000000..dced792d0d --- /dev/null +++ b/third_party/front/CHANGELOG.md @@ -0,0 +1,10 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `front` MCP server pointing at Front's hosted Streamable HTTP endpoint (`https://mcp.frontapp.com/mcp`). +- Declared `CLIENT_ID` and `CLIENT_SECRET` plugin variables and forwarded them through MCP auth, since Front requires a confidential client and does not support dynamic client registration. +- Requested the `feature:mcp` scope, the value Front documents for clients that need one. +- Logo: Front's official 192×192 app icon. diff --git a/third_party/front/LICENSE b/third_party/front/LICENSE new file mode 100644 index 0000000000..ca2bba771c --- /dev/null +++ b/third_party/front/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/front/README.md b/third_party/front/README.md new file mode 100644 index 0000000000..d07c6aa8b6 --- /dev/null +++ b/third_party/front/README.md @@ -0,0 +1,90 @@ +# Front + +Cursor plugin that connects agents to [Front](https://front.com) through Front's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Search conversations, read full timelines, draft and send replies, post internal comments, and manage tags, tasks, assignments, and inboxes in the signed-in Front account. + +## Install + +1. A Front admin creates a developer app and notes its credentials (see [Setup](#setup)). +2. Open **Cursor Settings → Plugins**, search for **Front**, and click **Install**. +3. Set **Front Client ID** and **Front Client Secret**, then complete the Front sign-in prompt. + +Or run `/add-plugin front` in chat. + +## MCP + +```json +{ + "mcpServers": { + "front": { + "type": "http", + "url": "https://mcp.frontapp.com/mcp", + "auth": { + "CLIENT_ID": "${CLIENT_ID}", + "CLIENT_SECRET": "${CLIENT_SECRET}", + "scopes": ["feature:mcp"] + } + } + } +} +``` + +Front does not support dynamic client registration, so the connection is a confidential client: a Front admin registers one developer app and Cursor sends that app's client ID and secret. Each user still signs in with their own Front account, and tool calls run with that teammate's Front permissions. + +## Setup + +### 1. Create the Front developer app + +In Front, go to **Settings → Company → Developer** and create an app (for example "Cursor MCP Connector"): + +1. On the **Features** tab, click **Add feature** and select **Front MCP**. +2. Note the **Client ID** and **Client secret**. +3. Register the redirect URLs Cursor uses: + + | Surface | Redirect URL | + | --- | --- | + | Desktop | `http://localhost:8787/callback` | + | Web and Cloud Agents | `https://www.cursor.com/agents/mcp/oauth/callback` | + | Grok Bot | `https://www.cursor.com/bot/mcp/oauth/callback` | + +4. Under **Resource permissions**, select the narrowest set that covers your use case: `read` for a research agent, `read` + `write` for a drafting copilot, and `send` only if the agent should actually send messages. +5. Save the app. + +### 2. Enter the credentials in Cursor + +In **Dashboard → Plugins → Configure**, set **Front Client ID** and **Front Client Secret** from that app. On a team marketplace an admin sets them once for everyone; each member still completes their own Front sign-in. + +## What agents can do + +| Category | Tools | +| --- | --- | +| Conversations | `search_conversations`, `read_conversation`, `update_conversation_status`, `assign_conversation`, `move_conversation` | +| Drafts and messages | `create_draft`, `update_draft`, `delete_draft`, `send_message`, `list_drafts`, `read_message`, `get_attachment` | +| Comments and tags | `add_comment`, `list_tags`, `tag_conversation` | +| Tasks | `create_task`, `update_task` | +| Templates | `search_message_templates` | +| Contacts and accounts | `search_contacts`, `read_contact`, `search_accounts`, `read_account` | +| Organization | `get_my_identity`, `list_inboxes`, `list_channels`, `list_teammates`, `list_teams`, `list_statuses` | + +The hosted runtime is the source of truth for tool names and schemas. Tools that mutate state visibly are marked destructive, so Cursor asks for confirmation per call. + +## Notes + +- Permissions are enforced at call time against the teammate's current Front role. An inbox that teammate cannot see is invisible to the agent too. `search_conversations` defaults to `my_conversations`; unassigned conversations need `scope: all_inboxes`. +- Changing the app's resource permissions does not reach existing connections. Each user has to disconnect Front and connect again before new permissions, or tools that need them, start working. Until then those tools return `missing required scopes`. +- Task IDs are conversation IDs: `read_conversation` and `search_conversations` (with `filters.type: "task"`) read them, but only `update_task` changes task state. +- Rate limits are metered in tool calls per minute — 100 on Starter, 200 on Professional, 300 on Enterprise — keyed to the connecting teammate and independent of Core API limits. Unpublished apps in a company share one pool, so adding apps divides capacity. Over-limit calls come back as tool results that state how long to wait. + +## Docs + +- Front MCP server: https://dev.frontapp.com/docs/mcp-server +- Server URL: https://mcp.frontapp.com/mcp +- Authorization URL: https://app.frontapp.com/oauth/authorize +- Token and refresh URL: https://app.frontapp.com/oauth/token + +Logo is Front's official app mark, the 192×192 app icon published on front.com. + +## License + +MIT diff --git a/third_party/front/assets/logo.png b/third_party/front/assets/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..dbe0922509d83ed4d3d575a701e54dd2a9a775ae GIT binary patch literal 10028 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 Q-}ZyaOT(l}B#i?92P_|sfB*mh literal 0 HcmV?d00001 diff --git a/third_party/front/mcp.json b/third_party/front/mcp.json new file mode 100644 index 0000000000..57a14b0a5b --- /dev/null +++ b/third_party/front/mcp.json @@ -0,0 +1,13 @@ +{ + "mcpServers": { + "front": { + "type": "http", + "url": "https://mcp.frontapp.com/mcp", + "auth": { + "CLIENT_ID": "${CLIENT_ID}", + "CLIENT_SECRET": "${CLIENT_SECRET}", + "scopes": ["feature:mcp"] + } + } + } +} From 930deb40a7abbbeccd036a46dd59e99ed20a4897 Mon Sep 17 00:00:00 2001 From: "Eric G.Y Liu" Date: Wed, 11 Nov 2026 22:21:31 -0800 Subject: [PATCH 3/3] gong: make the OAuth client optional so Grok Bot can register its own --- third_party/gong/.cursor-plugin/plugin.json | 12 ++++-------- third_party/gong/CHANGELOG.md | 5 +++++ third_party/gong/README.md | 16 ++++++++-------- third_party/gong/mcp.json | 4 ++-- 4 files changed, 19 insertions(+), 18 deletions(-) diff --git a/third_party/gong/.cursor-plugin/plugin.json b/third_party/gong/.cursor-plugin/plugin.json index 5bc7f7da23..6efca64f88 100644 --- a/third_party/gong/.cursor-plugin/plugin.json +++ b/third_party/gong/.cursor-plugin/plugin.json @@ -1,7 +1,7 @@ { "name": "gong", "displayName": "Gong", - "version": "1.0.0", + "version": "1.1.0", "description": "Pull account summaries, deal insights, and call briefs.", "author": { "name": "Cursor", @@ -31,18 +31,14 @@ "CLIENT_ID": { "type": "string", "title": "Gong Client ID", - "description": "OAuth Client ID from Gong Admin → Company Settings → Ecosystem → API → Integrations (MCP integration)." + "description": "Optional. OAuth Client ID from Gong Admin → Company Settings → Ecosystem → API → Integrations (MCP integration). Leave empty in Grok Bot, which registers its own Gong client." }, "CLIENT_SECRET": { "type": "string", "title": "Gong Client Secret", - "description": "OAuth Client Secret from the same Gong MCP integration." + "description": "Optional. OAuth Client Secret from the same Gong MCP integration, needed with the Client ID." } - }, - "required": [ - "CLIENT_ID", - "CLIENT_SECRET" - ] + } }, "mcpServers": "./mcp.json" } diff --git a/third_party/gong/CHANGELOG.md b/third_party/gong/CHANGELOG.md index 09a78045e0..91b38ea237 100644 --- a/third_party/gong/CHANGELOG.md +++ b/third_party/gong/CHANGELOG.md @@ -2,6 +2,11 @@ All notable changes to this plugin will be documented here. +## 1.1.0 + +- `CLIENT_ID` and `CLIENT_SECRET` are optional. Left empty, Grok Bot registers its own Gong client instead of stopping at "OAuth client is not configured". +- README: dropped the `http://localhost:8787/callback` redirect, which Gong rejects, and documented the no-setup path. + ## 1.0.0 — initial release - Logo: Gong's official 180×180 apple-touch icon. diff --git a/third_party/gong/README.md b/third_party/gong/README.md index 28216e41fa..c7b5a92c99 100644 --- a/third_party/gong/README.md +++ b/third_party/gong/README.md @@ -8,7 +8,7 @@ Pull account summaries, deal insights, and call briefs into chat. 1. Open **Cursor Settings → Plugins**. 2. Search for **Gong**. -3. Click **Install**, then set the client ID and secret (below) and complete the Gong sign-in prompt. +3. Click **Install**, then complete the Gong sign-in prompt. Or run `/add-plugin gong` in chat. @@ -20,8 +20,8 @@ Or run `/add-plugin gong` in chat. "gong": { "url": "https://mcp.gong.io/mcp", "auth": { - "CLIENT_ID": "${CLIENT_ID}", - "CLIENT_SECRET": "${CLIENT_SECRET}" + "CLIENT_ID": "${CLIENT_ID:-}", + "CLIENT_SECRET": "${CLIENT_SECRET:-}" } } } @@ -30,14 +30,14 @@ Or run `/add-plugin gong` in chat. ## Setup -Gong's MCP server uses static OAuth client credentials plus a per-user OAuth login, so an administrator has to register Cursor before anyone can connect. +In Grok Bot no setup is needed: it registers its own Gong client with the `mcp:read` and `mcp:write` scopes, and each user completes their own Gong sign-in. + +To use your own Gong client instead: 1. A Gong technical administrator creates an MCP integration under **Company Settings → Ecosystem → API → Integrations** and enables the MCP scope. -2. Register both redirect URIs on that integration: - - Desktop: `http://localhost:8787/callback` - - Web and Cloud Agents: `https://www.cursor.com/agents/mcp/oauth/callback` +2. Register `https://www.cursor.com/agents/mcp/oauth/callback` as the redirect URI. Gong accepts only `https://` redirects. 3. In **Dashboard → Plugins → Configure**, set **Gong Client ID** and **Gong Client Secret** from that integration. -4. Complete the Gong OAuth login when Cursor prompts. +4. Complete the Gong OAuth login when prompted. On a team marketplace an admin sets the client ID and secret once for everyone; each member still completes their own Gong OAuth login, so tool calls run with that member's Gong permissions. diff --git a/third_party/gong/mcp.json b/third_party/gong/mcp.json index a3776cf337..ccf5a25642 100644 --- a/third_party/gong/mcp.json +++ b/third_party/gong/mcp.json @@ -3,8 +3,8 @@ "gong": { "url": "https://mcp.gong.io/mcp", "auth": { - "CLIENT_ID": "${CLIENT_ID}", - "CLIENT_SECRET": "${CLIENT_SECRET}" + "CLIENT_ID": "${CLIENT_ID:-}", + "CLIENT_SECRET": "${CLIENT_SECRET:-}" } } }