diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json new file mode 100644 index 0000000..9cbddb7 --- /dev/null +++ b/.cursor-plugin/plugin.json @@ -0,0 +1,23 @@ +{ + "name": "joompulse", + "displayName": "JoomPulse", + "version": "0.2.0", + "description": "Mercado Livre and Shopee Brazil market analytics for e-commerce sellers: research products, sellers, categories, keywords and trends with price and sales history from the JoomPulse MCP.", + "author": { + "name": "Joom" + }, + "homepage": "https://joompulse.com", + "repository": "https://github.com/joomcode/joompulse-skills", + "license": "MIT", + "keywords": [ + "joompulse", + "ecommerce", + "mercadolivre", + "mercadolibre", + "shopee", + "brazil", + "analytics", + "product-research", + "mcp" + ] +} diff --git a/CHANGELOG.md b/CHANGELOG.md index 9298860..aebc5d1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file. This project follows semantic versioning. +## Unreleased + +- Added a Cursor plugin manifest (`.cursor-plugin/plugin.json`) and a root + `mcp.json` so the same skills and JoomPulse MCP connector install in Cursor. + ## 0.2.0 - 2026-08-13 - Renamed the plugin from `pulse-skills` to `joompulse-skills` to match the diff --git a/README.md b/README.md index 3656753..41c85f3 100644 --- a/README.md +++ b/README.md @@ -33,6 +33,18 @@ After installation, start a new session so the skill metadata is loaded. Installing the plugin also configures the JoomPulse MCP connector for you — run `/mcp`, pick **joompulse**, and sign in. You can skip the manual setup below. +### Via Cursor +1. In Cursor, open **Customize** in the sidebar. +2. Find **JoomPulse** and select **Install**, then choose a project or user scope. +3. Open **Settings → MCP**, find the **joompulse** server, and sign in with your + JoomPulse account. + +Skills are picked up automatically when a request matches them, or you can call +one directly in chat, for example `/ml-product-analysis`. + +To try the plugin before it is published, clone this repository into +`~/.cursor/plugins/local/joompulse` and run **Developer: Reload Window**. + ## Connect the JoomPulse MCP (required) To use these skills you first need to connect the **JoomPulse MCP** — it provides the live market data they run on, and without it the skills won't work. diff --git a/mcp.json b/mcp.json new file mode 100644 index 0000000..1ee8e8c --- /dev/null +++ b/mcp.json @@ -0,0 +1,7 @@ +{ + "mcpServers": { + "joompulse": { + "url": "https://joompulse.com/mcp" + } + } +} diff --git a/scripts/check-manifests.sh b/scripts/check-manifests.sh index 8623f73..c02e614 100755 --- a/scripts/check-manifests.sh +++ b/scripts/check-manifests.sh @@ -13,7 +13,8 @@ note() { fail=1 } -for f in .claude-plugin/plugin.json .claude-plugin/marketplace.json; do +for f in .claude-plugin/plugin.json .claude-plugin/marketplace.json \ + .cursor-plugin/plugin.json .mcp.json mcp.json; do python3 -c "import json,sys; json.load(open('$f'))" \ || note "$f is not valid JSON" done @@ -43,6 +44,27 @@ changelog_version=$(grep -m1 -oE '^## [0-9]+\.[0-9]+\.[0-9]+' CHANGELOG.md | awk [ "$plugin_version" = "$changelog_version" ] \ || note "version differs: plugin.json '$plugin_version' vs newest CHANGELOG entry '$changelog_version'" +# The Cursor manifest ships the same skills, so it carries the same version and +# repository. Its name and homepage are its own. +read -r cursor_version cursor_repo <<<"$(python3 -c " +import json +d = json.load(open('.cursor-plugin/plugin.json')) +print(d.get('version'), d.get('repository')) +")" +[ "$cursor_version" = "$plugin_version" ] \ + || note "version differs: .cursor-plugin/plugin.json '$cursor_version' vs plugin.json '$plugin_version'" +[ "$cursor_repo" = "$repo_url" ] \ + || note "URL '$cursor_repo' in .cursor-plugin/plugin.json does not match $repo_url" + +# Claude Code reads .mcp.json and Cursor reads mcp.json; both must point at the +# same servers. +python3 -c " +import json, sys +claude = {k: v.get('url') for k, v in json.load(open('.mcp.json'))['mcpServers'].items()} +cursor = {k: v.get('url') for k, v in json.load(open('mcp.json'))['mcpServers'].items()} +sys.exit(claude != cursor) +" || note ".mcp.json and mcp.json declare different MCP servers" + # The plugin name is a permanent identifier: renaming it breaks existing installs. # CHANGELOG.md is exempt because it records the rename itself. grep -rIn --exclude-dir=.git --exclude="$(basename "$0")" --exclude=CHANGELOG.md \