Skip to content
Open
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
32 changes: 24 additions & 8 deletions .cursor-plugin/README.md
Original file line number Diff line number Diff line change
@@ -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
34 changes: 17 additions & 17 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -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"]
Expand Down
51 changes: 37 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,20 +8,31 @@
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:

```
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

Expand Down Expand Up @@ -129,15 +140,20 @@ 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
- **Google Play** — public app, category, developer, review, permissions, safety, availability, similar, and search data
- **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`.
Expand Down Expand Up @@ -180,10 +196,17 @@ in this repository:
- plugin manifest: <https://github.com/replynodes/replynodes-mcp/blob/master/.cursor-plugin/plugin.json>
- logo: <https://github.com/replynodes/replynodes-mcp/blob/master/assets/logo.svg>

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

Expand Down Expand Up @@ -223,8 +246,8 @@ plugins must be open source and are manually reviewed before listing

| Channel | State | URL |
| --- | --- | --- |
| Official MCP Registry | Live listing | <https://registry.modelcontextprotocol.io/v0.1/servers/com.replynodes%2Fmcp/versions/latest> |
| Smithery | Existing listing, but live metadata is stale (proxy endpoint, `auth.md`, and query `apiKey`); update is external/owner-gated | <https://smithery.ai/servers/replynodes/mcp> |
| 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 | <https://registry.modelcontextprotocol.io/v0.1/servers/com.replynodes%2Fmcp/versions/latest> |
| Smithery | Not listed. <https://smithery.ai/servers/replynodes/mcp> returns HTTP 404 | — |
| Cursor plugin (in this repo) | Submit-ready | <https://github.com/replynodes/replynodes-mcp/tree/master/.cursor-plugin> |
| Cursor deeplink | Verified install path | `cursor://anysphere.cursor-deeplink/mcp/install?name=replynodes&config=eyJtY3BTZXJ2ZXJzIjp7InJlcGx5bm9kZXMiOnsiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7UkVQTFlOT0RFU19BUElfS0VZfSJ9LCJ1cmwiOiJodHRwczovL21jcC5yZXBseW5vZGVzLmNvbS9tY3AifX19` |
| Cursor Marketplace listing | Not listed yet | submit at <https://cursor.com/marketplace/publish> (owner action) |
Expand Down
Loading