@hotscots/mcp
v1.3.1
Published
Official Hots&Cots MCP server — barracks, DFAC, and facility reviews for U.S. military installations
Maintainers
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
- Get your API key at hotscots.app/subscription/dashboard
- Download hotscots.mcpb
- Double-click it. Claude Desktop opens an install dialog.
- Paste your API key and click Install.
- 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 bundleCompiles 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]
