npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@peppermint-mcp/wizard

v0.4.3

Published

One-command installer for Peppermint MCP across AI coding hosts

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Maintainers

abdullahnassarabdullahnassar

Keywords

peppermintmcpclaudecursorcodexaimemory

Readme

@peppermint-mcp/wizard

One-command installer for Peppermint MCP across AI coding hosts.

npx @peppermint-mcp/wizard

Detects your installed AI tools, authenticates with Peppermint, and writes the correct MCP config for each host. No manual JSON editing.

Supported Hosts

| Host | Install method | Auth handled by | |---|---|---| | Claude Code | claude mcp add (CLI) | Claude Code (built-in MCP OAuth) | | Claude Desktop | Config file + mcp-remote shim | Wizard (browser OAuth → API key) | | Cursor | Config file (native HTTP) | Wizard (browser OAuth → API key) | | Codex CLI | codex mcp add (CLI) | Codex (built-in MCP OAuth) |

Usage

Install Peppermint MCP

npx @peppermint-mcp/wizard

The wizard will:

  1. Detect which AI hosts are installed on your machine
  2. Let you choose which ones to configure
  3. Open your browser to sign in (only for hosts that need it)
  4. Write the MCP config for each selected host
  5. Verify the installation

Other commands

# List detected hosts and their status
npx @peppermint-mcp/wizard list

# Health check on existing installation
npx @peppermint-mcp/wizard doctor

# Remove Peppermint from selected hosts
npx @peppermint-mcp/wizard remove

Flags

| Flag | Description | |---|---| | --server <url> | MCP server URL (default: https://api.peppermint.com/mcp/) | | --dry-run | Print what would change without writing anything | | --no-verify | Skip post-install health check |

Using staging

npx @peppermint-mcp/wizard --server https://dev-api.peppermint.com/mcp/

How it works

CLI hosts (Claude Code, Codex): The wizard runs the host's built-in mcp add command. Auth is handled by the host itself through the MCP protocol's browser OAuth flow — no token management needed.

File-based hosts (Claude Desktop, Cursor): The wizard performs a localhost OAuth flow:

  1. Opens your browser to Peppermint's sign-in page
  2. Catches the auth callback on a temporary localhost server
  3. Creates a long-lived API key (pep_...) that doesn't expire
  4. Writes the API key into the host's config JSON

Credentials are stored in ~/.config/peppermint/credentials.json. On subsequent runs, the wizard reuses the existing API key without re-authenticating.

Development

npm install
npm run build     # Build with tsup
npm run dev       # Watch mode
npm test          # Run tests