Cursor plugin specification and official plugins
TypeScript
Add Similarweb third-party MCP plugin
Cursor Agentfdd4927b22f1
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex d5afdbf2..31d8b3db 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -297,6 +297,11 @@"name": "readwise","source": "third_party/readwise","description": "Search highlights and Reader documents, save articles."+ },+ {+ "name": "similarweb",+ "source": "third_party/similarweb",+ "description": "Analyze website traffic, audiences, and competitors."}]}diff --git a/README.md b/README.mdindex 6c8efbe6..af43360f 100644--- a/README.md+++ b/README.md@@ -64,6 +64,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `craft` | [Craft](third_party/craft/) | Cursor | Integrations | Search, create, and update documents and daily notes. || `mem` | [Mem](third_party/mem/) | Cursor | Integrations | Capture, search, and organize notes and collections. || `readwise` | [Readwise](third_party/readwise/) | Cursor | Integrations | Search highlights and Reader documents, save articles. |+| `similarweb` | [Similarweb](third_party/similarweb/) | Cursor | Integrations | Analyze website traffic, audiences, and competitors. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/similarweb/.cursor-plugin/plugin.json b/third_party/similarweb/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..e1d1254a--- /dev/null+++ b/third_party/similarweb/.cursor-plugin/plugin.json@@ -0,0 +1,46 @@+{+ "name": "similarweb",+ "displayName": "Similarweb",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.13.0"+ },+ "description": "Analyze website traffic, audiences, and competitors.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://docs.similarweb.com/api-v5/similarweb-mcp",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "similarweb",+ "traffic",+ "analytics",+ "competitive-intelligence",+ "audience",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "similarweb",+ "analytics",+ "mcp",+ "research"+ ],+ "variables": {+ "type": "object",+ "properties": {+ "SIMILARWEB_API_KEY": {+ "type": "string",+ "title": "Similarweb API key",+ "description": "REST API key from Similarweb under Account Settings \u2192 Data Tools \u2192 REST API."+ }+ },+ "required": [+ "SIMILARWEB_API_KEY"+ ]+ },+ "mcpServers": "./mcp.json"+}diff --git a/third_party/similarweb/CHANGELOG.md b/third_party/similarweb/CHANGELOG.mdnew file mode 100644index 00000000..5cee08a3--- /dev/null+++ b/third_party/similarweb/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `similarweb` MCP server pointing at `https://mcp.similarweb.com`.+- Auth uses a Similarweb API key supplied by the user as a request header.+- Logo: Similarweb's official mark, from the `similarweb` GitHub organization.diff --git a/third_party/similarweb/LICENSE b/third_party/similarweb/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/similarweb/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/similarweb/README.md b/third_party/similarweb/README.mdnew file mode 100644index 00000000..b78d0eb2--- /dev/null+++ b/third_party/similarweb/README.md@@ -0,0 +1,63 @@+# Similarweb++Cursor plugin that connects agents to [Similarweb](https://www.similarweb.com) through Similarweb's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.++Pull Similarweb digital-intelligence data — website traffic and engagement, competitor comparison, audience demographics, and keyword metrics — for research without leaving the editor.++## Install++1. Open **Cursor Settings → Plugins**.+2. Search for **Similarweb**.+3. Click **Install**, then set your Similarweb API key (below).++Or run `/add-plugin similarweb` in chat.++## MCP++```json+{+ "mcpServers": {+ "similarweb": {+ "type": "http",+ "url": "https://mcp.similarweb.com",+ "headers": {+ "api-key": "${SIMILARWEB_API_KEY}"+ }+ }+ }+}+```++Auth is a Similarweb **API key** sent in an `api-key` header (lowercase, hyphenated — not `Authorization`). Copy it from **Account Settings → Data Tools → REST API**, then set it in **Dashboard → Plugins → Configure**.++## Before you connect++You need a Similarweb subscription with API access — API-only, Business, or Enterprise. Calls debit standard API data credits. If the REST API section is not visible in your account settings, an account admin has to generate the key.++## What agents can do++| Category | Capabilities |+| --- | --- |+| Web metrics | Traffic and engagement, traffic sources, website rank, similar sites, referrals, audience overlap, demographics, technologies, segments, and PPC spend |+| Search metrics | SERP players and SERP clicks |+| App metrics | App install penetration, app store rank, and app details |++The hosted runtime is the source of truth for tool names and schemas.++## Notes++- Tool calls run with the permissions and credit balance attached to the API key.+- Similarweb's own Cursor guide routes through `npx mcp-remote`. That is not necessary — Cursor connects to the remote endpoint directly and sends the `api-key` header, which is the same shape Similarweb documents for Microsoft Copilot Studio.+- Similarweb runs two documentation portals, `docs.similarweb.com` and `developers.similarweb.com`, whose MCP paths drift. Both give the same endpoint.++## Docs++- Similarweb MCP: https://docs.similarweb.com/api-v5/similarweb-mcp+- Similarweb MCP (developer portal): https://developers.similarweb.com/docs/similarweb-mcp+- Server URL: https://mcp.similarweb.com++Logo is Similarweb's official mark, from the `similarweb` GitHub organization.++## License++MITdiff --git a/third_party/similarweb/assets/logo.png b/third_party/similarweb/assets/logo.pngnew file mode 100644index 00000000..039df2a9Binary files /dev/null and b/third_party/similarweb/assets/logo.png differdiff --git a/third_party/similarweb/mcp.json b/third_party/similarweb/mcp.jsonnew file mode 100644index 00000000..4ceb3ba5--- /dev/null+++ b/third_party/similarweb/mcp.json@@ -0,0 +1,11 @@+{+ "mcpServers": {+ "similarweb": {+ "type": "http",+ "url": "https://mcp.similarweb.com",+ "headers": {+ "api-key": "${SIMILARWEB_API_KEY}"+ }+ }+ }+}