diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 003ea47cc..9cb30e8b9 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -342,6 +342,11 @@ "name": "attio", "source": "third_party/attio", "description": "Search and update CRM records, lists, notes, and tasks." + }, + { + "name": "hunter", + "source": "third_party/hunter", + "description": "Find and verify emails, discover companies, and save leads." } ] } diff --git a/README.md b/README.md index e9c711178..32103e163 100644 --- a/README.md +++ b/README.md @@ -70,6 +70,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc | `xero` | [Xero](third_party/xero/) | Cursor | Integrations | Read and write invoices, contacts, reports, and payroll. | | `x-ads` | [X Ads](third_party/x-ads/) | Cursor | Integrations | Manage ad campaigns, create ads, track conversions, and pull performance stats. | | `attio` | [Attio](third_party/attio/) | Cursor | Integrations | Search and update CRM records, lists, notes, and tasks. | +| `hunter` | [Hunter](third_party/hunter/) | Cursor | Integrations | Find and verify emails, discover companies, and save leads. | Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest). ## Repository structure diff --git a/third_party/hunter/.cursor-plugin/plugin.json b/third_party/hunter/.cursor-plugin/plugin.json new file mode 100644 index 000000000..dfaa1beea --- /dev/null +++ b/third_party/hunter/.cursor-plugin/plugin.json @@ -0,0 +1,51 @@ +{ + "name": "hunter", + "displayName": "Hunter", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Find and verify emails, discover companies, and save leads.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://hunter.io/agents.md", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "hunter", + "email finder", + "email verifier", + "domain search", + "prospecting", + "enrichment", + "leads", + "gtm", + "sales", + "mcp" + ], + "category": "integrations", + "tags": [ + "hunter", + "sales", + "prospecting", + "enrichment", + "mcp" + ], + "variables": { + "type": "object", + "properties": { + "HUNTER_API_KEY": { + "type": "string", + "title": "Hunter API key", + "description": "API key from https://hunter.io/api-keys. The Free plan works." + } + }, + "required": [ + "HUNTER_API_KEY" + ] + }, + "mcpServers": "./mcp.json" +} diff --git a/third_party/hunter/CHANGELOG.md b/third_party/hunter/CHANGELOG.md new file mode 100644 index 000000000..c60d52ca6 --- /dev/null +++ b/third_party/hunter/CHANGELOG.md @@ -0,0 +1,9 @@ +# Changelog + +All notable changes to this plugin will be documented here. + +## 1.0.0 — initial release + +- Added the `hunter` MCP server pointing at Hunter's hosted Streamable HTTP endpoint (`https://mcp.hunter.io/mcp`). +- Auth uses a Hunter API key supplied by the user as an `X-API-Key` header (`${HUNTER_API_KEY}`). +- Logo: Hunter's official fox mark, from the `hunter-io` GitHub organization. diff --git a/third_party/hunter/LICENSE b/third_party/hunter/LICENSE new file mode 100644 index 000000000..ca2bba771 --- /dev/null +++ b/third_party/hunter/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/hunter/README.md b/third_party/hunter/README.md new file mode 100644 index 000000000..cf9c64d6f --- /dev/null +++ b/third_party/hunter/README.md @@ -0,0 +1,72 @@ +# Hunter + +Cursor plugin that connects agents to [Hunter](https://hunter.io) through Hunter's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Find and verify professional email addresses, list the contacts behind any company domain, discover companies that match a profile, enrich people and companies, and save contacts as leads. + +Official Cursor setup: https://hunter.io/agents.md + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **Hunter**. +3. Click **Install**, then set your Hunter API key (below). + +Or run `/add-plugin hunter` in chat. + +## MCP + +```json +{ + "mcpServers": { + "hunter": { + "type": "http", + "url": "https://mcp.hunter.io/mcp", + "headers": { + "X-API-Key": "${HUNTER_API_KEY}" + } + } + } +} +``` + +Auth is a Hunter **API key** sent in an `X-API-Key` header. Create one at https://hunter.io/api-keys (Free plan is enough), then set it in **Dashboard → Plugins → Configure**. Do not commit the key. + +## Before you connect + +You need a Hunter account and an API key. The MCP server is available on all Hunter plans, including the free plan, and uses the plan and credits attached to that key. + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Discover | Find companies by industry, size, location, technology, and more, or describe the target in natural language (free, no credits) | +| Domain Search | List the people and email addresses behind a company domain, with department and seniority filters | +| Email Finder | Find a professional's most likely email address from a name and company or domain | +| Email Verifier | Check whether an email address is deliverable and see its confidence score and sources | +| Enrichment | Pull person and company data from an email address or domain | +| Leads | Create, update, and organize leads and lead lists; push leads to a connected CRM | +| Campaigns | Add recipients to campaigns and start outreach sequences | + +The hosted runtime is the source of truth for tool names and schemas. + +## Notes + +- Tool calls run with the permissions and credits attached to the API key. Domain Search, Email Finder, Email Verifier, and Enrichment calls cost credits the same way they do in the Hunter app; Discover is free. +- This plugin follows Hunter's official Cursor packaging: Streamable HTTP at `https://mcp.hunter.io/mcp` with `X-API-Key`. Hunter also documents OAuth for some clients; do not use OAuth for this plugin. +- Hunter's `test-api-key` only works against the REST API; the MCP server rejects it with a 401. +- The `hunter-io/hunter-mcp` GitHub repository is Hunter's old local (stdio) server and is archived. Hunter directs all clients to the remote server above. + +## Docs + +- Agent setup instructions: https://hunter.io/agents.md +- Hunter MCP: https://hunter.io/mcp +- API keys: https://hunter.io/api-keys +- API reference (MCP section): https://hunter.io/api-documentation/v2#mcp +- Server URL: https://mcp.hunter.io/mcp + +Logo is Hunter's official fox mark, from the `hunter-io` GitHub organization. + +## License + +MIT diff --git a/third_party/hunter/assets/logo.png b/third_party/hunter/assets/logo.png new file mode 100644 index 000000000..2ee73cd7f Binary files /dev/null and b/third_party/hunter/assets/logo.png differ diff --git a/third_party/hunter/mcp.json b/third_party/hunter/mcp.json new file mode 100644 index 000000000..48e22b6a0 --- /dev/null +++ b/third_party/hunter/mcp.json @@ -0,0 +1,11 @@ +{ + "mcpServers": { + "hunter": { + "type": "http", + "url": "https://mcp.hunter.io/mcp", + "headers": { + "X-API-Key": "${HUNTER_API_KEY}" + } + } + } +}