Skip to content

Add Hunter third-party MCP plugin (API key header auth) - #340

Merged
SamSokolin merged 1 commit into
mainfrom
cursor/hunter-mcp-plugin-86e6
Sep 9, 2026
Merged

Add Hunter third-party MCP plugin (API key header auth)#340
SamSokolin merged 1 commit into
mainfrom
cursor/hunter-mcp-plugin-86e6

Conversation

@SamSokolin

Copy link
Copy Markdown
Collaborator

Summary

Adds the Hunter marketplace plugin under third_party/hunter/, matching Hunter’s official Cursor setup (agents.md) and this repo’s BYO-credential template-variable pattern.

Hosted MCP: https://mcp.hunter.io/mcp (Streamable HTTP). Auth is an X-API-Key header with ${HUNTER_API_KEY}not OAuth for this packaging.

"hunter": {
  "url": "https://mcp.hunter.io/mcp",
  "headers": { "X-API-Key": "${HUNTER_API_KEY}" }
}

plugin.json declares the HUNTER_API_KEY template variable the same way other API-key plugins do (e.g. Similarweb, GitHub, Brevo). Users create a key at https://hunter.io/api-keys (Free plan works). No secrets are committed.

Relation to #317

#317 (“Add Hunter third-party MCP plugin”) is still open and packages the same third_party/hunter path with OAuth-only mcp.json (URL, no header / no template var), documenting X-API-Key as an opt-in alternative.

This PR is a fresh branch from current main, not a second Hunter plugin path. It reuses #317’s logo/LICENSE and capability docs, then corrects auth to the official Cursor header model. Prefer this over merging #317 as-is.

Files changed

  • third_party/hunter/mcp.json — HTTP server + X-API-Key: ${HUNTER_API_KEY}
  • third_party/hunter/.cursor-plugin/plugin.json — manifest + HUNTER_API_KEY variable
  • third_party/hunter/README.md — install/auth docs pointing at agents.md and api-keys
  • third_party/hunter/CHANGELOG.md
  • third_party/hunter/LICENSE
  • third_party/hunter/assets/logo.png — Hunter fox mark from the hunter-io GitHub org
  • .cursor-plugin/marketplace.json — register hunter
  • README.md — catalog row

Test plan

  • node scripts/validate-plugins.mjs (after npm install --no-save ajv ajv-formats)
  • Install from Cursor Settings → Plugins or /add-plugin hunter
  • Set HUNTER_API_KEY from https://hunter.io/api-keys (do not use test-api-key)
  • Smoke test a free Discover query, then a Domain Search
Open in Web Open in Cursor 

Package Hunter's hosted Streamable HTTP MCP server
(https://mcp.hunter.io/mcp) using the official Cursor setup from
https://hunter.io/agents.md: X-API-Key with ${HUNTER_API_KEY}.

This is a fresh-from-main take on #317, which used OAuth-only config
and documented the API key as an opt-in alternative. Official Cursor
packaging is header auth, so plugin.json declares the HUNTER_API_KEY
template variable the same way other BYO-credential plugins do.

Co-authored-by: Sam Sokolin <SamSokolin@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants