Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"
]
}
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
12 changes: 12 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
7 changes: 7 additions & 0 deletions mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
{
"mcpServers": {
"joompulse": {
"url": "https://joompulse.com/mcp"
}
}
}
24 changes: 23 additions & 1 deletion scripts/check-manifests.sh
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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 \
Expand Down
Loading