# Hugging Bay

> Hugging Bay is a free MCP server for ai models and llm tooling. Search open AI model files with recorded SHA-256 hashes and license labels. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI, macOS, Windows, Linux
- **Website:** https://huggingbay.xyz
- **Repository:** https://github.com/barneywohl/hugging-bay/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.barneywohl/hugging-bay
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

The server fronts the Hugging Bay catalog, a site of free open models that the vendor says are meant to run on your own computer. Its registry blurb highlights recorded SHA-256 checksums and license labels, and the ability to ask for models that are missing.

Tool exposure is controlled by a profile set in `HUGGING_BAY_MCP_PROFILE`: discovery by default, plus core, verify and full. Public discovery needs no token, while `HUGGING_BAY_TOKEN` is an optional bearer token for authenticated profiles. An optional `run_local` tool is off by default, works only over stdio and requires the local `hbay` 0.2.0 command.

You can run it from npm as `hugging-bay-mcp` or use the hosted endpoint at `https://huggingbay.xyz/api/mcp`. The same site also offers a free desktop app for Mac, Windows and Linux that chats with a downloaded model offline.

## Features

- **Model discovery:** Browse open models by default, with no token needed.
- **Checksums and licenses:** Models carry recorded SHA-256 values and license labels.
- **Tool profiles:** Choose discovery, core, verify or full tool sets.
- **Missing-model requests:** Ask for models the catalog does not yet have.
- **Optional local run:** Enable a stdio-only run_local tool when the local hbay command is installed.

## Good for

- Find an open model that fits a given machine
- Check a model file's hash and license before downloading
- Request a model that is not yet catalogued

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hugging-bay https://huggingbay.xyz/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://huggingbay.xyz/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hugging-bay": {
      "url": "https://huggingbay.xyz/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "hugging-bay": {
      "type": "http",
      "url": "https://huggingbay.xyz/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "hugging-bay": {
      "serverUrl": "https://huggingbay.xyz/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "hugging-bay": {
      "type": "http",
      "url": "https://huggingbay.xyz/api/mcp"
    }
  }
}
```

## Tools

- `run_local`: Run a model locally; stdio only, off by default

## FAQ

### Do I need a token?

Not for public discovery; `HUGGING_BAY_TOKEN` is optional for authenticated profiles.

### What are the profiles?

Discovery is the default, with core, verify and full available.

### Is run_local available on the hosted endpoint?

No. It is stdio-only and off by default.

### Is the desktop app free?

The site says the app is free and comes without a model.

### Is Hugging Bay free?

Yes. Hugging Bay is free to use.

### How do I add Hugging Bay to Claude Code?

Run this command in your terminal: claude mcp add --transport http hugging-bay https://huggingbay.xyz/api/mcp

### What are the best alternatives to Hugging Bay?

The closest alternatives to Hugging Bay are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/hugging-bay
