Add Cursor Marketplace plugin packaging - #1
Conversation
- Create .cursor-plugin/plugin.json with OAuth-only MCP config - Add mcp.json pointing to https://getperspective.ai/mcp (no secrets) - Add skills/perspective-mcp/SKILL.md to guide when to use Perspective MCP - Update README.md with Cursor Marketplace installation instructions - All paths relative, no secrets, OAuth-friendly URL-only MCP config Co-authored-by: Vinay Puppal <vinaypuppal@users.noreply.github.com>
Set "skills": "skills" to explicitly declare the skills directory per Cursor Plugin reference, while maintaining auto-discovery behavior for all skills under skills/ (current and future). Co-authored-by: Vinay Puppal <vinaypuppal@users.noreply.github.com>
There was a problem hiding this comment.
🟡 Changes recommended
The newly added mcp.json format is inconsistent with the README’s documented mcp.json schema (missing type: "http"), which can cause client/config confusion.
Once you've addressed the issues Copilot identified, you can request another Copilot review.
Pull request overview
Prepares this repository for Cursor Marketplace distribution by adding Cursor plugin metadata, a default remote MCP configuration, and an accompanying usage skill, plus updating README installation guidance.
Changes:
- Added Cursor plugin manifest under
.cursor-plugin/with metadata, logo reference, and skills directory declaration. - Added a repository
mcp.jsonpointing to the hosted MCP endpoint for OAuth-based connection. - Added a
perspective-mcpskill document and updated README to recommend Marketplace installation while preserving manual setup paths.
File summaries
| File | Description |
|---|---|
skills/perspective-mcp/SKILL.md |
Adds a Cursor skill describing when/how to use the Perspective MCP server. |
README.md |
Updates installation docs to recommend Cursor Marketplace installation and reorders client setup sections. |
mcp.json |
Adds a default MCP server entry for the hosted Perspective endpoint. |
.cursor-plugin/plugin.json |
Adds Cursor Marketplace plugin metadata, including logo and skills directory mapping. |
Review details
- Files reviewed: 4/4 changed files
- Comments generated: 1
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
Set "type": "http" to match README Cursor/VS Code example format. While Cursor can infer transport from url, keeping the field explicit avoids potential client/schema mismatch. Co-authored-by: Vinay Puppal <vinaypuppal@users.noreply.github.com>
There was a problem hiding this comment.
🟢 Approval recommended
The changes are limited to packaging/configuration/docs and appear internally consistent (valid JSON/YAML, URLs/paths align with repo layout, and no secrets are introduced).
Review details
- Files reviewed: 4/4 changed files
- Comments generated: 0 new
- Review effort level: Lite
Summary
This PR prepares the Perspective AI MCP repository for submission to the Cursor Marketplace, enabling one-click installation in Cursor with OAuth authentication.
Changes
Plugin Packaging
.cursor-plugin/plugin.json: Cursor Plugin manifest with metadata, keywords, logo reference, and explicitskillsfieldmcp.json: OAuth-friendly MCP server configuration pointing tohttps://getperspective.ai/mcp(no secrets, no API tokens)skills/perspective-mcp/SKILL.md: Guidance skill that helps AI assistants understand when and how to use Perspective MCP toolsDocumentation
README.md: Updated with Cursor Marketplace installation instructions as the recommended path, while preserving existing manual installation methodsKey Features
"skills": "skills"directory path ensures all current and future skills are discoveredassets/logo-light.svgfrom the repositorySubmission Checklist
All requirements met for Cursor Marketplace submission:
.cursor-plugin/plugin.jsonmanifestperspective-aiskillsfield pointing to directory..or absolute paths)Next Steps
After this PR is merged to
main, submit the repository to the Cursor Marketplace at:https://cursor.com/marketplace/publish
The Cursor team will manually review the plugin. Once approved, users will be able to install Perspective AI MCP with one click from Customize → Marketplace in Cursor.
Testing
To test locally before merge:
~/.cursor/plugins/local/perspective-ai