From ae30dad7ea6c3b40781254e8d382100a7ec334e2 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 12 Nov 2026 09:50:11 +0000 Subject: [PATCH] docs(cursor): lead marketplace copy with company research Point the Cursor plugin manifest and READMEs at domain company research and named-competitor briefs, and drop the stale Smithery listing. MCP tool calls still require a key or OAuth. Co-authored-by: replynodes --- .cursor-plugin/README.md | 32 ++++++++++++++++++------ .cursor-plugin/plugin.json | 34 ++++++++++++------------- README.md | 51 +++++++++++++++++++++++++++----------- 3 files changed, 78 insertions(+), 39 deletions(-) diff --git a/.cursor-plugin/README.md b/.cursor-plugin/README.md index 18ec037..de9a192 100644 --- a/.cursor-plugin/README.md +++ b/.cursor-plugin/README.md @@ -1,17 +1,33 @@ -# ReplyNodes MCP +# ReplyNodes MCP for Cursor -Web search, scraping, crawling, Reddit, YouTube, App Store, Hacker News, and brand-intelligence MCP server for Cursor. Connects to the canonical public endpoint `https://mcp.replynodes.com/mcp`. +Research a company by domain, and compare it with 1-5 named competitor domains, through the ReplyNodes MCP server. Markdown, brand, and logo tools are included as supporting reads. The plugin is transport-only: it does not add its own tools or publish anything. Live tools come from `tools/list` on the canonical endpoint. + +Canonical endpoint: `https://mcp.replynodes.com/mcp` + +This plugin does **not** search for companies by market, category, or a natural-language list query (for example "top 10 SaaS companies in carbon accounting"). Give it a domain, or a domain plus named competitor domains. + +## What to call + +Use the live tool names from `tools/list`. As of 12 Nov 2026 those names are: + +- `anonymous_company_research` — company dossier for one bare domain (no scheme, port, path, or credentials). Same work as `GET /v1/company-research?domain=`. +- `anonymous_competitor_research` — competitor brief. Same work as `GET /v1/competitor-research?domain=&competitors=` (`competitors` is a comma-separated list of 1-5 bare domains). +- Supporting reads: `anonymous_markdown`, `anonymous_brand`, `brand_logo`, `brand_retrieve`. + +The REST URLs above can be called without a key (3 company-research and 3 competitor-research calls per caller per UTC day). `tools/list` on the canonical endpoint also works without a key. **MCP tool calls from Cursor are not keyless.** They need a ReplyNodes API key (`rn_test_*` or `rn_live_*`) or OAuth. This plugin uses the API-key path. ## Configuration -For an interactive Cursor session, add the remote MCP URL and complete Cursor's native Better Auth MCP OAuth flow. The OAuth issuer is `https://auth.replynodes.com` and the required scope is `mcp:read`. +1. Install the plugin from the Cursor Marketplace, or load it locally for testing. +2. Open **Plugins → Configure** and set `REPLYNODES_API_KEY`. Do not commit a key. +3. Get a free key (500 credits) at [replynodes.com/auth.md](https://replynodes.com/auth.md). Paid plans start at $19: [replynodes.com/pricing](https://replynodes.com/pricing). -For headless/manual use, configure a ReplyNodes `rn_test_*` or `rn_live_*` API key as a Bearer credential. The plugin is transport-only: it does not add tools or publish anything; all available read-only tools are discovered via `tools/list` at runtime. +Example prompt after install: "Use ReplyNodes to research watershed.com, then run a competitor brief against persefoni.com and greenly.earth." -## Endpoint +## Legal -Canonical production endpoint: `https://mcp.replynodes.com/mcp`. +The plugin is free and open source under MIT. ReplyNodes terms and privacy: [Terms](https://replynodes.com/terms/) and [Privacy](https://replynodes.com/privacy/). Verified live (HTTP 200) on 12 Nov 2026. -## Distribution +## Support -Submit to the Cursor Marketplace at [cursor.com/marketplace/publish](https://cursor.com/marketplace/publish). The plugin is open source and manually reviewed before listing. +https://replynodes.com and https://docs.replynodes.com diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 37a8966..b23b353 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -1,31 +1,31 @@ { "name": "replynodes", - "version": "0.1.4", - "description": "Read-only web search, scraping, crawling, Reddit, YouTube, App Store, Hacker News, and brand-intelligence MCP server for Cursor. Connect to the canonical public endpoint, authenticate with your claimed API key, and call tools via Cursor's Tools panel.", - "readme": "README.md", - "icon": "assets/logo.svg", - "category": "data-and-analytics", - "tags": [ + "version": "0.1.5", + "description": "Research a company by domain and get competitor briefs for 1-5 named domains, via the ReplyNodes MCP server. Also converts pages to Markdown and pulls brand and logo data. Connects to https://mcp.replynodes.com/mcp. MCP tool calls require a ReplyNodes API key (free key includes 500 credits; plans from $19). Does not search for companies by market or category.", + "author": { + "name": "ReplyNodes" + }, + "homepage": "https://replynodes.com", + "repository": "https://github.com/replynodes/replynodes-mcp", + "license": "MIT", + "keywords": [ "mcp", - "web-search", - "scraping", - "crawl", - "reddit", - "youtube", - "app-store", - "hacker-news", - "brand-intelligence", + "company-research", + "competitor-research", + "brand", + "logo", + "markdown", + "web-context", "read-only" ], - "repository": "https://github.com/replynodes/replynodes-mcp", - "homepage": "https://replynodes.com", + "logo": "assets/logo.svg", "variables": { "type": "object", "properties": { "REPLYNODES_API_KEY": { "type": "string", "title": "ReplyNodes API key", - "description": "ReplyNodes API key (rn_test_* or rn_live_*) for headless/manual use. Interactive clients should connect to the remote MCP server with native OAuth." + "description": "ReplyNodes API key (rn_test_* or rn_live_*). MCP tool calls require this key. A free key includes 500 credits; paid plans start at $19. Get a key at https://replynodes.com/auth.md." } }, "required": ["REPLYNODES_API_KEY"] diff --git a/README.md b/README.md index 1c2ce79..388c63d 100644 --- a/README.md +++ b/README.md @@ -8,9 +8,18 @@ Connect an AI agent to ReplyNodes' public context tools through one remote MCP endpoint. Use it for: -- **Web → Markdown** extraction, web search, same-origin crawling, and URL maps -- **Brand intelligence** including public brand profiles, search, style guides, and fonts -- **Reddit, YouTube, App Store, Google Play, and Hacker News** research +- **Company research by domain** (`anonymous_company_research`, `GET /v1/company-research?domain=`). Pass a bare domain: no scheme, port, path, or credentials. +- **Competitor briefs** for 1-5 named domains (`anonymous_competitor_research`, `GET /v1/competitor-research?domain=&competitors=`). `competitors` is a comma-separated list of bare domains. +- **Supporting reads**: pages as Markdown, brand profiles, and logos (`anonymous_markdown`, `anonymous_brand`, `brand_logo`, `brand_retrieve`) + +This server does not search for companies by market, category, or a +natural-language list query (for example "top 10 SaaS companies in carbon +accounting"). `brand_search` is a fuzzy brand-name or domain lookup (up to 10 +identity matches), not a market or category list. + +`GET /v1/company-research` and `GET /v1/competitor-research` work without a key: +3 calls per caller per UTC day each. `tools/list` on the MCP endpoint also +works without a key. MCP tool calls need a ReplyNodes API key or OAuth. The canonical remote endpoint is: @@ -18,10 +27,12 @@ The canonical remote endpoint is: https://mcp.replynodes.com/mcp ``` -The live `tools/list` response is authoritative. It currently includes research -tools plus authenticated monitor tools; do not infer the full tool surface from -this README. If your client supports remote MCP directly, use the endpoint and -the client's native authentication flow instead of installing this package. +The live `tools/list` response is authoritative. It currently includes the +company and competitor tools above, other public research tools (web, brand, +Reddit, YouTube, App Store, Google Play, and Hacker News), and authenticated +monitor tools. Do not infer the full tool surface from this README. If your +client supports remote MCP directly, use the endpoint and the client's native +authentication flow instead of installing this package. ## Authentication @@ -129,8 +140,10 @@ credential instead. After connecting, discover the current tools with `tools/list`. The verified capability families include: +- **company research** — `anonymous_company_research`: a dossier for one bare domain (`GET /v1/company-research`) +- **competitor research** — `anonymous_competitor_research`: that domain plus 1-5 comma-separated competitor domains (`GET /v1/competitor-research`) - **web** — search, clean Markdown extraction, same-origin crawl, URL mapping, and brand extraction -- **brand** — public brand search, retrieval, style guides, and fonts +- **brand** — fuzzy name or domain lookup (`brand_search`, up to 10 identity matches), retrieval, logos, style guides, and fonts - **Reddit** — public post, subreddit, and user research - **YouTube** — search, video, channel, comments, playlist, related, and transcript research - **App Store** — public app, developer, review, rating, privacy, similar, and search data @@ -138,6 +151,9 @@ capability families include: - **Hacker News** — public story, item, search, and user research - **monitor** — authenticated monitor listing, creation, inspection, updates, changes, and runs +There is no tool that accepts a natural-language company list query such as +"top 10 SaaS companies in carbon accounting." + The exact tool set and schemas are authoritative at runtime. Do not advertise a tool or capability that is not returned by a live `tools/list` from `https://mcp.replynodes.com/mcp`. @@ -180,10 +196,17 @@ in this repository: - plugin manifest: - logo: -The plugin uses the canonical production endpoint `https://mcp.replynodes.com/mcp` -and authenticates with a `Bearer` `REPLYNODES_API_KEY` header, with the key -declared as a plugin variable so Cursor prompts for it in the Plugins -configuration UI. +The plugin leads with company research by domain and competitor briefs for 1-5 +named domains, using the live tools `anonymous_company_research` and +`anonymous_competitor_research`. Markdown, brand, and logo reads are supporting +tools. It does not search for companies by market, category, or a +natural-language list. + +It uses the canonical production endpoint `https://mcp.replynodes.com/mcp` and +sends `Authorization: Bearer ${REPLYNODES_API_KEY}`. Cursor prompts for that +variable under Plugins → Configure. MCP tool calls need that API key or OAuth; +this plugin uses the API-key path. A free key includes 500 credits; paid plans +start at $19. Installing the plugin is free (MIT). #### Install with a Cursor deeplink @@ -223,8 +246,8 @@ plugins must be open source and are manually reviewed before listing | Channel | State | URL | | --- | --- | --- | -| Official MCP Registry | Live listing | | -| Smithery | Existing listing, but live metadata is stale (proxy endpoint, `auth.md`, and query `apiKey`); update is external/owner-gated | | +| Official MCP Registry | Live listing (`com.replynodes/mcp` 1.0.3). The published description is still the older web-search copy; the company-research description update (recommended 1.0.4) is not in this repo change and has not been published | | +| Smithery | Not listed. returns HTTP 404 | — | | Cursor plugin (in this repo) | Submit-ready | | | Cursor deeplink | Verified install path | `cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19` | | Cursor Marketplace listing | Not listed yet | submit at (owner action) |