Fix MCP servers not being discovered for Gong and Salesforce plugins - #192
Merged
Conversation
Both mcp.json files declared $schema: https://cursor.com/schemas/mcp.json. parsePluginMcpConfig treats any $schema outside SUPPORTED_SCHEMA_IDS (the two agent-plugins.org 1.0.0 ids) as unsupported and returns null, so indexing found zero MCP servers and both plugins registered with no components. The Google plugins omit $schema entirely, which is why they were unaffected. Removing the key restores discovery. Co-authored-by: Cursor <cursoragent@cursor.com>
github-actions Bot
added a commit
to SmailG/claude-cursor-plugins
that referenced
this pull request
Aug 5, 2026
…cursor/ssokolin/fix-plugin-mcp-schema chore: sync with cursor/plugins — Merge pull request cursor#192 from cursor/ssokolin/fix-plugin-mcp-schema
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Removes
"$schema": "https://cursor.com/schemas/mcp.json"fromthird_party/gong/mcp.jsonandthird_party/salesforce/mcp.json.After #191 merged and the repo reindexed, both plugins registered with zero components — their MCP servers were silently dropped. The
$schemakey is the cause.Root cause
parsePluginMcpConfigrejects the entire config whenmcp.jsondeclares a$schemathat isn't locally recognized:SUPPORTED_SCHEMA_IDScontains exactly two identifiers, both from the Agent Plugins 1.0.0 spec:https://agent-plugins.org/schemas/1.0.0/plugin.schema.jsonhttps://agent-plugins.org/schemas/1.0.0/mcp.schema.jsonhttps://cursor.com/schemas/mcp.jsonis not one of them, so it resolves tounsupported,parsePluginMcpConfigreturnsnull, and discovery records no MCP servers. The plugin still indexes fine — it just has nothing in it.gmail,google-drive, andgoogle-calendaromit$schemaentirely, which is why they were unaffected and showed1 component.Worth noting the URL is not bogus in general:
https://cursor.com/schemas/mcp.jsonis the correct$schemafor a user's~/.cursor/mcp.json. It just isn't valid for a plugin-ownedmcp.json, which is governed by the Agent Plugins spec ids.Verification
Ran the real parser against both files, before and after:
node scripts/validate-plugins.mjspasses.Follow-up worth considering
scripts/validate-plugins.mjsdid not catch this — it validatesplugin.jsonandmarketplace.jsonagainst the local JSON Schemas but never parsesmcp.json. A plugin can therefore pass CI and index with its MCP servers silently discarded. A check that runsparsePluginMcpConfigover each plugin's declaredmcpServersand fails when a plugin declares MCP but resolves to zero servers would have caught this at PR time. Happy to add it separately if that seems worthwhile.Note
Low Risk
Third-party JSON-only change with no application code or auth flow modifications; restores intended MCP discovery behavior.
Overview
Gong and Salesforce plugin MCP configs no longer declare
"$schema": "https://cursor.com/schemas/mcp.json". That URL is valid for user~/.cursor/mcp.jsonbut is not in the Agent Plugins 1.0.0 supported schema list, soparsePluginMcpConfigwas returningnulland both plugins indexed with zero MCP components.The server definitions (
mcpServersentries, auth, URLs) are unchanged; only the schema line is removed, matching plugins like Gmail that never set$schema.Reviewed by Cursor Bugbot for commit b01315d. Bugbot is set up for automated code reviews on this repo. Configure here.