Heurist MCP Installer

CLI tool to install Heurist MCP tools into compatible clients.

Installation

npx -y heurist-mcp-cli
# or
bunx heurist-mcp-cli
# or
pnpm dlx heurist-mcp-cli

Usage

Install a Tool

npx -y heurist-mcp-cli <tool-url-or-id> <api-key> [client]

• <tool-url-or-id>: The full URL of the Heurist MCP tool, or just the short tool ID (e.g., 0f1234de).
• <api-key>: Your API key for verification.
• [client] (optional): Specify a client (claude, windsurf, cursor, vscode, vscode-insiders). If omitted, you will be prompted to select one from the detected clients.

Example:

npx -y heurist-mcp-cli 0f1234de your_api_key_here cursor

List Detected Clients

npx -y heurist-mcp-cli list

Lists clients where the tool can be installed.

Supported Clients

• Claude Desktop
• Windsurf (Codeium)
• Cursor
• VS Code
• VS Code Insiders

Development

1. Clone the repo.
2. npm install or bun install or pnpm install
3. npm run start or bun run start or pnpm run start

Acknowledgements

• Smithery AI CLI
• mcp-remote