hookmcp-mcp

A read-only MCP server that lets your AI assistant search HookMCP, a directory of 800+ Model Context Protocol servers, and get ready-to-paste configs for Claude Desktop, Cursor, VS Code, Windsurf and Claude Code.

Example prompts: “Find a maintained Postgres MCP server that doesn’t need an API key and give me the Cursor config.” · “What browser-automation MCP servers were updated this week?”

• No API key, no account, no tracking. It only reads the public dataset at https://hookmcp.com/api/v1/servers.json and caches it for 6 hours (in memory and in ~/.cache/hookmcp-mcp/), so it keeps working offline with the last good copy.
• Runs locally over stdio: npx -y hookmcp-mcp

Tools

All tools are annotated readOnlyHint: true.

Install

Requires Node.js 18+.

Claude Desktop

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude:

{
  "mcpServers": {
    "hookmcp": { "command": "npx", "args": ["-y", "hookmcp-mcp"] }
  }
}

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "hookmcp": { "command": "npx", "args": ["-y", "hookmcp-mcp"] }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "hookmcp": { "type": "stdio", "command": "npx", "args": ["-y", "hookmcp-mcp"] }
  }
}

Windsurf

Add via Cascade → Actions → Open MCP config file (often ~/.config/devin/mcp_config.json; classic ~/.codeium/windsurf/mcp_config.json also common):

{
  "mcpServers": {
    "hookmcp": { "command": "npx", "args": ["-y", "hookmcp-mcp"] }
  }
}

Claude Code

claude mcp add hookmcp -- npx -y hookmcp-mcp

Configuration (optional)

npx -y hookmcp-mcp --help shows usage, --version prints the version.

Examples

Ask your assistant:

• “Search HookMCP for a Python Slack server with at least 100 stars.” → search_servers { query: "slack", language: "python", min_stars: 100 }
• “Give me the Windsurf config for TrendRadar with my API key.” → get_install_config { slug: "sansan0-trendradar", client: "windsurf", env: { "API_KEY": "…" } }
• “What’s trending in databases?” → trending_servers { category: "databases" }
• “List Postgres MCP servers for Cursor.” → search_servers { topic: "postgres", client: "cursor" }

Example get_install_config result (client: "cursor"):

{
  "slug": "…", "name": "…", "client": "cursor",
  "file": "~/.cursor/mcp.json (global) or .cursor/mcp.json (project)",
  "json": { "mcpServers": { "key": { "command": "npx", "args": ["-y", "package"], "env": { "API_KEY": "…" } } } },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=…"
}

Data caveats

Listings are collected automatically from the official MCP Registry and GitHub. Install commands are labelled as either taken from the README or derived from the registry package. API-key and remote flags are hints from READMEs. Always check the project’s README before running a server. Spotted a mistake? Open an issue.

Development

npm install
npm test        # builds, then runs unit + end-to-end tests over stdio against test/fixtures
HOOKMCP_TEST_DATA_URL=https://hookmcp.com/api/v1/servers.json npm test   # same, against live data
npx @modelcontextprotocol/inspector node dist/index.js

Listed on HookMCP

If you maintain an MCP server, you can add this badge to your README:

[![Listed on HookMCP](https://img.shields.io/badge/Listed%20on-HookMCP-7c3aed)](https://hookmcp.com)

MIT © Yash Patil