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

@hotscots/mcp

v1.3.1

Published

Official Hots&Cots MCP server — barracks, DFAC, and facility reviews for U.S. military installations

Readme

Hots&Cots MCP Server

Give AI assistants like Claude direct access to the Hots&Cots military quality-of-life database — barracks conditions, DFAC ratings, and on-base facility reviews from service members across the DoD.

Requires an H&CPro API key (hc_ followed by 64 hex characters) — generate yours at hotscots.app/subscription/dashboard.


Setup

  1. Get your API key at hotscots.app/subscription/dashboard
  2. Download hotscots.mcpb
  3. Double-click it. Claude Desktop opens an install dialog.
  4. Paste your API key and click Install.
  5. Check it's enabled in Settings → Extensions.

No config files, no terminal. Your key is stored in your operating system's keychain rather than in a plaintext config file.

If no tools appear, check step 5. The API key is required, so installing without it leaves the extension installed but disabled, with no tools and no error message. Open Settings → Extensions, enter the key, and toggle it on.


For Cursor, VS Code, Claude Code, or any other MCP client. Add this to your client's config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hotscots": {
      "command": "npx",
      "args": ["-y", "@hotscots/mcp"],
      "env": {
        "HOTSCOTS_API_KEY": "hc_YOUR_KEY_HERE"
      }
    }
  }
}

Restart your client. The Hots&Cots tools will appear automatically.


What You Can Ask

  • "Is my Hots&Cots API key working?"
  • "List all installations — which have the most reviews?"
  • "Show me barracks reviews at Fort Liberty."
  • "What percentage of barracks reviews at Fort Hood report mold?"
  • "How do service members rate the DFACs at Camp Lejeune?"
  • "Show medical and CDC facility reviews for Army bases in Texas."
  • "How do official ICE satisfaction scores compare to Hots&Cots reviews at the same base?"
  • "What's on the breakfast menu at Stackhouse today, and what does it cost?"

Available Tools

| Tool | Description | |---|---| | hotscots_health | Verify your API key and confirm the service is reachable | | hotscots_list_installations | All installations with barracks, dining, and other review counts | | hotscots_get_barracks_reviews | Paginated barracks / housing (Cots) reviews | | hotscots_get_dfac_reviews | Paginated dining facility / DFAC (Hots) reviews | | hotscots_get_other_reviews | Reviews for medical, CDC, gym, PX/BX, lodging, and moving services | | hotscots_list_ice_facilities | Installations with ICE survey data, by dining / public-works kind | | hotscots_get_ice_ratings | Official DoD ICE satisfaction scores for DFACs and public works | | hotscots_list_menu_locations | CSDV dining venues with menu coverage dates | | hotscots_get_menu_items | Dining menu items with prices, nutrition, allergens, and G4G tags |


Architecture

Claude Desktop / Cursor / AI client
        ↓  MCP protocol (stdio)
@hotscots/mcp  ← runs locally via npx
        ↓  HTTPS + Bearer token
api.hotscots.app/functions/v1/api
        ↓
Supabase (anonymized, OPSEC-scrubbed review data)

The server runs locally on your machine — your API key never leaves your device.


Building the desktop extension

npm run bundle

Compiles TypeScript, stages runtime dependencies, prunes non-runtime files, validates the manifest, smoke-tests tools/list over stdio, and packs mcpb/hotscots-<version>.mcpb (~1.9 MB). Attach that file to the GitHub release and upload it wherever the download link points.

mcpb/manifest.json is the committed source of truth; mcpb/build/ and the packed .mcpb are build artifacts and are gitignored.


Environment Variables

| Variable | Required | Description | |---|---|---| | HOTSCOTS_API_KEY | ✅ | Your API key (hc_ + 64 hex characters) | | HOTSCOTS_API_URL | ❌ | Override the API base URL | | TRANSPORT | ❌ | stdio (default) or http for remote/multi-user mode | | PORT | ❌ | HTTP port when TRANSPORT=http (default: 3000) |


Troubleshooting

"HOTSCOTS_API_KEY environment variable is not set"
→ Make sure the env block in your config includes your key and you've fully restarted the client.

"API key not found" or "License inactive"
→ Double-check your key at hotscots.app/subscription/dashboard. Keys must be on an active H&CPro plan.

"Access denied to <endpoint>"
→ Your plan may not include that review type. Check your subscription tier.

Tools aren't showing up
→ Confirm Node.js 18+ is installed (node --version) and try asking Claude to run a health check.


Clean. Safe. Comfort. — hotscots.app
Questions? [email protected]